文書作成環境の比較 † TeX Wiki にたどり着く方は当然のことながら、TeX/LaTeX についての情報を求めて来たのでしょう。 ここでは、TeX/LaTeX とは何かあまりよく知らないが、何か文書を作成する必要に迫られて、TeX/LaTeX に行き当たった方、あるいは、TeX/LaTeX を使って文書を作成しているが、他の文書作成環境との比較検討はあまりされていない方に対して、今後の参考のために情報を提供・集約したいと考えます。 それぞれの文書作成環境には利点と欠点があります。 どのような種類の文書を作成するのかによっても、どれを選ぶべきかは異なってきます。 このことをまず、しっかり意識しましょう。 文書作成環境とは? † 紙と鉛筆の時代には、文書は原稿用紙やレポート用紙などに書かれ、保存されてきました。 その時代には、筆記用具、デスクや椅子、書斎などの執筆環境が文書作成の際に選ば
docに関するnobusueのブックマーク (14)
-
nobusue 2016/09/05
-
ドキュメントをプログラムのように「開発」する時代が来た
一昔前、「厚い財布」は、お札をどっさり入れて高級店に出入りする「お金持ち」の象徴だった。貨幣と交換でモノやサービスを買う社会では、お財布の厚みによって受け取れるモノやサービスの量が決定されたからだ。 しかし、クレジットカードや電子マネーが普及して高額の現金を持ち歩く必要性がなくなった現在では、厚い財布は「スマートさに欠ける人」を指す表現になっている。大量の現金を持ち歩くのは不用心だし、クレジットカードやポイントカードなどで財布が膨らんでいると「お得」や「特典」といった言葉に踊らされている人だと思われがちだからだ。 情報システムの納品物となるドキュメントも、かつてはその厚みが数億円ものコストを象徴していた。基幹系システムなら、ドキュメント一式でキャビネットが数段占有されるのが当然のことだった。 しかし、いまや紙のドキュメントはお荷物。更新が大変なのでソースコードと乖離しやすいうえ、同時に複数
-
-
-
-
OmegaT と Google 翻訳者ツールキットで Wikipedia を翻訳してみる - forest book
以前は wikipedia:翻訳メモリ の OmegaT というツール使ってよく翻訳していました。OmegaT の基本機能は以下になります。 参考訳文の表示 用語集の表示 wikipedia:Translation Memory eXchange (TMX) の自動生成と共有 エキスパート Python プログラミングの翻訳 を始めるときに他の訳者の方々に翻訳メモリについて尋ねてみたら、当時は誰も使っていませんでした。そして @shibukawa と一緒に翻訳作業を行う中で、 重要なのは、日本語力 Shibu's Diary: エンジニアは翻訳をやるとお得 という意味がよく分かり、ツールを使う必然性がなくなり、その後は OmegaT は使わなくなりました。 閑話休題。私が OmegaT を使っていた頃のバージョンは 1.4 から 1.6 ぐらいだったと思います。その後、Google 翻訳
-
ドキュメントのパワーアップ
ドキュメントのパワーアップ¶ Sphinxには様々なマークアップがあります。これを利用すると、見やすく情報量の豊富なドキュメントを作ることができます。 インラインマークアップ¶ 太字、斜体、リテラルなどが利用できます。
-
Sphinx-Users.jp
Sphinx-Users.jp¶ Sphinx-Users.jp(略称#sphinxjp)は、美しいドキュメントを簡単に生成することができるドキュメンテーションツール、 Sphinx （スフィンクス）の普及を主眼としたコミュニティです。SphinxはPythonの公式ドキュメントだけでなく、このSphinx-Users.jpのサイトも含め多くのマニュアルやサイトで使用されており、詳細を Sphinxの歴史で紹介しています。 Sphinx-Users.jp は日本の Sphinx コミュニティです。 Sphinx-Users.jp では、日本で散らばっているSphinx関連情報を集めて、Webサイト、イベントを通じてSphinx情報を発信します。 slack のコミュニケーションや勉強会の開催などを通じて、ドキュメントをパワーアップしたい人、ドキュメントや翻訳で苦労している人、Sphinxの
-
reStructuredText入門 — Sphinx v1.0 (hg) documentation
reStructuredText入門¶ このセクションは、reStructuredText(reST)の考え方や文法についての短いイントロダクションです。Sphinxユーザがドキュメントを作成するために十分な情報を提供します。reSTはシンプルに設計された、控えめなマークアップ言語ですので、理解するのにそれほど時間はかからないでしょう。 段落(パラグラフ)¶ 段落はreSTドキュメントにおける、もっとも基本的な要素です。段落は1行以上の空行で区切られた、シンプルなテキストの固まりです。 Pythonにおいてインデントが重要な意味を持つのと同様、reSTでもインデントは重要です。同じ段落のすべての行は、インデントを同じ高さにそろえて、左揃えにしなければなりません。 インラインマークアップ¶ 標準のreSTインラインマークアップは極めてシンプルです。 アスタリスク1つ: *テキスト* 強調(
-
渋日記: Pythonって何？という人のためのSphinxチュートリアル
渋日記@shibu.jp 渋川よしきの日記です。ソフトウェア開発とか、ライフハックを中心に記事を書いていきます。 前回、インストールのエントリーを書きましたが、Tornadeドキュメントの翻訳を例に、実際にSphinxでの作業の流れをお見せしたいと思います。 まずはワークフォルダを作る 作業をするには、ファイルを置く場所が必要です。ソースコード、設定ファイル、ビルド後の成果物などなど、いろいろ必要になります。そこでフォルダを作成する必要があります。僕の場合は翻訳とかの作業は(ホーム)/work/(作業フォルダ)という場所で行うことが多いので、その前提で話しをすすめます。Tornadoの翻訳の場合はチームで作業をしたので、bitbucketを使って共有環境を用意しましたのでその説明も一緒に。 共有をする場合はMercurialをインストールしてください。Windowsの場合はTortoise
-
Shibu's Diary: Pythonって何？という人のためのSphinxインストール入門
渋日記@shibu.jp 渋川よしきの日記です。ソフトウェア開発とか、ライフハックを中心に記事を書いていきます。 この前のブログのエントリーにも書きましたが、Sphinxというステキすぎるツールがあります。ドキュメントがどんどん書きたくなっちゃうステキなツールです。ですが、残念ながら、使用するためにはインストールする必要があります。Pythonって何？という人には少々敷居が高いため、解説の記事を書いてみました。 [STEP 1] Pythonからインストールする場合 WindowsではPythonからインストールする必要があります。一発でインストールできる環境を持っている人は最後の方のインストール法に飛んでください。また、Mac OS Xみたいに、最初からPythonから入っている人は[STEP 1]は飛ばしてください。 Windwsの場合 http://python.orgを開きます。P
-
Overview — Sphinx v1.0 (hg) documentation
ダウンロード このドキュメントはバージョン1.0 (hg)のためのものです。まだリリースされていません。 Mercurialリポジトリのコードを利用するか、Python Package Indexにあるリリースバージョンを探してください。 疑問? 意見? Googleグループへの参加: もしくは、FreeNodeの#python-docsチャンネルへどうぞ 何か気づいたことがあれば、issue trackerを使用して通知することもできます。 Sphinxは知的で美しいドキュメントを簡単に作れるようにするツールです。Georg Brandlによって開発され、BSDライセンスのもとで公開されています。 このツールはもともと、新しいPythonのドキュメントの変換のために作られました。そして、今までに数々のPythonや、他の言語で開発されているプロジェクトに対して、すばらしいドキュメンテーシ
-
Shibu's Diary: Tornadoウェブフレームワーク日本語訳ができるまで
渋日記@shibu.jp 渋川よしきの日記です。ソフトウェア開発とか、ライフハックを中心に記事を書いていきます。 Facebookが新しいウェブのフレームワークを公開しました。このフレームワークはすごいですよ。最初から、最近よく使われるようになったOpenIDなどの外部認証に対応しているし、セッションをたくさん張るようなウェブアプリにも対応しているし、 nginxをフロントに立てるのを前提としています。それでいて、ソースコードは少なく、サイズはとても小さい。極めてモダンで無駄のないウェブアプリケーションサーバです。もちろん、Google AppEngine/Pythonでも使えます。Rails/Djangoなどの拡大路線に対抗して、最近は小さいフレームワークもまたいくつか出てきましたけど、小さいからといって我慢しなくてはいけないこともないし(今までの資産が生かせないぐらい？)、こいつはRa
-
Almost Plain Text - N2 ToolBox(跡地)
Maven2のドキュメントのディレクトリにはaptという謎のフォーマットのドキュメントが置かれています。調べてみるとこれは文書をWikiに似たプレインテキストの形式であるらしい。 このフォーマットの文書をいろいろな形式に変換するaptconvertというツールがhttp://www.xmlmind.com/aptconvert.html から入手できます。 サポートされている出力フォーマットは一応HTML, LaTeX, PostScript, PDF, RTF, DocBook SGML, DocBook XMLと多岐に渡っています。 確かにxdocよりはずっと楽にドキュメントが書けてよさそうですね。 この手のツールは国際化に関する考慮が不十分なことが多いのですが、aptconvertは出力フォーマットがHTML、DocBookであれば文字コードがSJISの入力を受け付けることができます
-
1
公式Twitter
- @HatenaBookmark
リリース、障害情報などのサービスのお知らせ
- @hatebu
最新の人気エントリーの配信
キーボードショートカット一覧
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Copyright © 2005-2025 Hatena. All Rights Reserved.
設定を変更しました