上野家のホームページ
ナーマル，マリン，ココ
[
新規
|
一覧
|
検索
|
最新
|
ヘルプ
]
開発/Python/Pythonドキュメント
をテンプレートにして作成
資料室
開発/Python/Pythonドキュメント をテンプレートにして作成
[
差分
|
バックアップ
|
リロード
]
[ ]
開始行:
* Pythonのドキュメントの日本語化とヘルプファイル
私はPython初心者で，''Pythonの公式ドキュメント''をマニュ...
公式オリジナルの英語版が https://docs.python.org/3/ で公...
PythonをインストールするとWindowsのヘルプファイルも提供さ...
一応，[[Python Japanese Environment>https://ja.osdn.net/p...
そこで，日本語翻訳されたWindowsのヘルプファイルを作成して...
[[Pythonドキュメント日本語訳プロジェクト>https://github.c...
これを使用して，日本語のPythonのヘルプファイルを作成して...
* ソースコードと日本語リソースを用意する
まず，Pythonのドキュメントから日本語のドキュメント（HTML...
** ビルドに必要なツールを用意する
ドキュメントを作成するのに必要なツールSphinx（Pythonで動...
> pip install sphinx
> pip install sphinx-intl
> pip install blurb
> pip install transifex-client
** Pythonのソースコードを準備
Pythonのドキュメントを作成するのに，Pythonのソースコード...
Pythonの[[公式サイト>https://www.python.org/]]から，Pytho...
適当な作業ディレクトリで解凍する。
> wget https://www.python.org/ftp/python/3.7.2/Python-3....
> tar xvfz Python-3.7.2.tgz
> cd Python-3.7.2
別の方法として，[[Pythonドキュメント日本語訳プロジェクト>...
ただ，翻訳作業が終了後にリポジトリが更新されるので，最新...
> git clone https://github.com/python-doc-ja/cpython-doc...
> cd cpython-doc-intl
> git checkout intl-3.6
** Sphinxの設定ファイルを修正
Sphinxを使用して日本語ドキュメントが出力されるように，''c...
language = 'ja'
locale_dirs = ['locale/']
gettext_compact = False
：
：
today_fmt = '%m/%d/%Y'
** 翻訳済みリソースをTransifexからダウンロードする
Pythonの[[公式サイト>https://www.python.org/]]からのソー...
Pythonドキュメントプロジェクト [[transifex>https://www.tr...
Pythonドキュメント日本語訳プロジェクトのリソースを使う場...
まず，[[transifex>https://www.transifex.com/]] でアカウン...
''~/.transifexrc''ファイルを以下の内容で作成する。
[https://www.transifex.com]
hostname = https://www.transifex.com
token = xxxxxxxxxxxxxx
username = <ユーザー名>
password = <パスワード>
tokenには，作成したAPIキーを設定する。
翻訳のチームに参加ボタンを押して参加を表明し，承認されれ...
Pythonドキュメントプロジェクト [[transifex>https://www.tr...
翻訳するための設定ファイル.tx/configファイルを作成する。
> cd locale
> sphinx-intl create-txconfig
Pythonドキュメントソースからメッセージカタログ（.pot）フ...
> cd ..
> sphinx-build -b gettext . locale/pot
翻訳するための設定ファイル.tx/configファイルをpotファイル...
> cd locale
> sphinx-intl update-txconfig-resources --pot-dir pot --...
> awk '/file_filter/{sub("locales/","");print $0} !/file...
> cp .tx/config.2 .tx/config
> rm .tx/config.2
> tx pull -l ja
とすると，現在翻訳作業中の翻訳リソースの.poファイルがダウ...
*** Pythonドキュメント日本語訳プロジェクトのリソースを使...
[[Pythonドキュメント日本語訳プロジェクト>https://github.c...
> cd Doc
> git clone https://github.com/python-doc-ja/py36-locale...
.poファイルは，Doc/locale/ja/LC_MESSAGES/にダウンロードさ...
バージョン3.7.2の場合は，
> cd Doc
> git clone https://github.com/python-doc-ja/py37-locale...
とすれば良いと思われるが，残念ながらまだリポジトリにアッ...
* 日本語ドキュメント（HTML）を作成
''conf.py''ファイルのOptions for HTML outputに，以下の修...
html_last_updated_fmt = '%m/%d/%Y'
翻訳した.poファイル（実際には.moファイル）を使用して，ド...
> make clean html
自分で翻訳を修正したりしたい場合は，Doc/locale/ja/LC_MESS...
これでうまく行けば，''日本語訳されたHTMLのドキュメント''...
* Windowsのヘルプファイルchmを作成する
HTMLのドキュメントが作成出来れば，Windowsで使われるヘルプ...
作成するには，Microsoftの [[HTML Help Workshop>https://ww...
** .chmファイルを作成する
DocディレクトリにMakefile等があるので，それを使ってHTML H...
> make htmlhelp
Doc\build\htmlhelpに，HTMLファイルとpythonxxx.hhp，python...
''pythonxxx.hhp''をダブルクリックしてHTML Help Workshopを...
この時，locale以下に翻訳リソースがない場合，''build/htmlh...
もし日本語化されたHTMLファイルが''build\html''にある場合...
* LaTeXを使ってPDFファイルを作成する
Sphinxでは，[[LaTeX>https://ja.wikipedia.org/wiki/LaTeX]]...
この場合，LaTeX（[[W32Tex>https://texwiki.texjp.org/?W32T...
設定ファイル''conf.py''の''Options for LaTeX output''で，...
#latex_engine = 'xelatex'
これは，デフォルトの''platex''を使うようにするため。
Sphinxのクラスにhowtoとmanualがあって，howtoが短い文書，m...
使用するドキュメントクラスは，デフォルト設定のhowtoに''jr...
latex_docclass = {"howto": "jsreport", "manual": "jsbook"}
のように設定する。
Pythonのドキュメントには，İ (U+0130)， ı (U+0131)， ſ (U+...
これらをPDFで出力するために，''conf.py''のプリアンプル''l...
latex_elements['preamble'] = r'''
\authoraddress{
\sphinxstrong{Python Software Foundation}\\
Email: \sphinxemail{docs@python.org}
}
\let\Verbatim=\OriginalVerbatim
\let\endVerbatim=\endOriginalVerbatim
\usepackage[TS1,T1,T2A]{fontenc}
\usepackage{lmodern}
\usepackage[utf8]{inputenc}
\usepackage{babel}
\DeclareUnicodeCharacter{212A}{\ensuremath{\mathrm{K}}}
\DeclareUnicodeCharacter{017F}{{\fontencoding{TS1}\selec...
\DeclareUnicodeCharacter{0404}{\fontencoding{T2A}\CYRIE}
'''
//ただ，Є (U+0404) を表示する仕方がわからない。しょうがな...
いくつかの.texファイル（library.tex，howto-logging.tex，u...
latex_elements['passoptionstopackages'] = r'''
\usepackage[dvipdfmx]{graphicx}
'''
** texファイルを作成して，さらにpdfファイルを作成する
DocディレクトリにMakefile等があるので，それを使ってtexフ...
> make latex PAPER=a4
この時，文書サイズをA4かletterか指定できる。~
うまくいくと，build/latexディレクトリに.texファイルが作成...
texファイルからPDFファイルに変換してみる。
> cd build/latex
> make all-pdf-ja
これで，うまく行けばPDFファイルが作成される。
* 作成した日本語ドキュメント
作成したバージョン3.7.2の日本語ヘルプファイル：&ref(pytho...
終了行:
* Pythonのドキュメントの日本語化とヘルプファイル
私はPython初心者で，''Pythonの公式ドキュメント''をマニュ...
公式オリジナルの英語版が https://docs.python.org/3/ で公...
PythonをインストールするとWindowsのヘルプファイルも提供さ...
一応，[[Python Japanese Environment>https://ja.osdn.net/p...
そこで，日本語翻訳されたWindowsのヘルプファイルを作成して...
[[Pythonドキュメント日本語訳プロジェクト>https://github.c...
これを使用して，日本語のPythonのヘルプファイルを作成して...
* ソースコードと日本語リソースを用意する
まず，Pythonのドキュメントから日本語のドキュメント（HTML...
** ビルドに必要なツールを用意する
ドキュメントを作成するのに必要なツールSphinx（Pythonで動...
> pip install sphinx
> pip install sphinx-intl
> pip install blurb
> pip install transifex-client
** Pythonのソースコードを準備
Pythonのドキュメントを作成するのに，Pythonのソースコード...
Pythonの[[公式サイト>https://www.python.org/]]から，Pytho...
適当な作業ディレクトリで解凍する。
> wget https://www.python.org/ftp/python/3.7.2/Python-3....
> tar xvfz Python-3.7.2.tgz
> cd Python-3.7.2
別の方法として，[[Pythonドキュメント日本語訳プロジェクト>...
ただ，翻訳作業が終了後にリポジトリが更新されるので，最新...
> git clone https://github.com/python-doc-ja/cpython-doc...
> cd cpython-doc-intl
> git checkout intl-3.6
** Sphinxの設定ファイルを修正
Sphinxを使用して日本語ドキュメントが出力されるように，''c...
language = 'ja'
locale_dirs = ['locale/']
gettext_compact = False
：
：
today_fmt = '%m/%d/%Y'
** 翻訳済みリソースをTransifexからダウンロードする
Pythonの[[公式サイト>https://www.python.org/]]からのソー...
Pythonドキュメントプロジェクト [[transifex>https://www.tr...
Pythonドキュメント日本語訳プロジェクトのリソースを使う場...
まず，[[transifex>https://www.transifex.com/]] でアカウン...
''~/.transifexrc''ファイルを以下の内容で作成する。
[https://www.transifex.com]
hostname = https://www.transifex.com
token = xxxxxxxxxxxxxx
username = <ユーザー名>
password = <パスワード>
tokenには，作成したAPIキーを設定する。
翻訳のチームに参加ボタンを押して参加を表明し，承認されれ...
Pythonドキュメントプロジェクト [[transifex>https://www.tr...
翻訳するための設定ファイル.tx/configファイルを作成する。
> cd locale
> sphinx-intl create-txconfig
Pythonドキュメントソースからメッセージカタログ（.pot）フ...
> cd ..
> sphinx-build -b gettext . locale/pot
翻訳するための設定ファイル.tx/configファイルをpotファイル...
> cd locale
> sphinx-intl update-txconfig-resources --pot-dir pot --...
> awk '/file_filter/{sub("locales/","");print $0} !/file...
> cp .tx/config.2 .tx/config
> rm .tx/config.2
> tx pull -l ja
とすると，現在翻訳作業中の翻訳リソースの.poファイルがダウ...
*** Pythonドキュメント日本語訳プロジェクトのリソースを使...
[[Pythonドキュメント日本語訳プロジェクト>https://github.c...
> cd Doc
> git clone https://github.com/python-doc-ja/py36-locale...
.poファイルは，Doc/locale/ja/LC_MESSAGES/にダウンロードさ...
バージョン3.7.2の場合は，
> cd Doc
> git clone https://github.com/python-doc-ja/py37-locale...
とすれば良いと思われるが，残念ながらまだリポジトリにアッ...
* 日本語ドキュメント（HTML）を作成
''conf.py''ファイルのOptions for HTML outputに，以下の修...
html_last_updated_fmt = '%m/%d/%Y'
翻訳した.poファイル（実際には.moファイル）を使用して，ド...
> make clean html
自分で翻訳を修正したりしたい場合は，Doc/locale/ja/LC_MESS...
これでうまく行けば，''日本語訳されたHTMLのドキュメント''...
* Windowsのヘルプファイルchmを作成する
HTMLのドキュメントが作成出来れば，Windowsで使われるヘルプ...
作成するには，Microsoftの [[HTML Help Workshop>https://ww...
** .chmファイルを作成する
DocディレクトリにMakefile等があるので，それを使ってHTML H...
> make htmlhelp
Doc\build\htmlhelpに，HTMLファイルとpythonxxx.hhp，python...
''pythonxxx.hhp''をダブルクリックしてHTML Help Workshopを...
この時，locale以下に翻訳リソースがない場合，''build/htmlh...
もし日本語化されたHTMLファイルが''build\html''にある場合...
* LaTeXを使ってPDFファイルを作成する
Sphinxでは，[[LaTeX>https://ja.wikipedia.org/wiki/LaTeX]]...
この場合，LaTeX（[[W32Tex>https://texwiki.texjp.org/?W32T...
設定ファイル''conf.py''の''Options for LaTeX output''で，...
#latex_engine = 'xelatex'
これは，デフォルトの''platex''を使うようにするため。
Sphinxのクラスにhowtoとmanualがあって，howtoが短い文書，m...
使用するドキュメントクラスは，デフォルト設定のhowtoに''jr...
latex_docclass = {"howto": "jsreport", "manual": "jsbook"}
のように設定する。
Pythonのドキュメントには，İ (U+0130)， ı (U+0131)， ſ (U+...
これらをPDFで出力するために，''conf.py''のプリアンプル''l...
latex_elements['preamble'] = r'''
\authoraddress{
\sphinxstrong{Python Software Foundation}\\
Email: \sphinxemail{docs@python.org}
}
\let\Verbatim=\OriginalVerbatim
\let\endVerbatim=\endOriginalVerbatim
\usepackage[TS1,T1,T2A]{fontenc}
\usepackage{lmodern}
\usepackage[utf8]{inputenc}
\usepackage{babel}
\DeclareUnicodeCharacter{212A}{\ensuremath{\mathrm{K}}}
\DeclareUnicodeCharacter{017F}{{\fontencoding{TS1}\selec...
\DeclareUnicodeCharacter{0404}{\fontencoding{T2A}\CYRIE}
'''
//ただ，Є (U+0404) を表示する仕方がわからない。しょうがな...
いくつかの.texファイル（library.tex，howto-logging.tex，u...
latex_elements['passoptionstopackages'] = r'''
\usepackage[dvipdfmx]{graphicx}
'''
** texファイルを作成して，さらにpdfファイルを作成する
DocディレクトリにMakefile等があるので，それを使ってtexフ...
> make latex PAPER=a4
この時，文書サイズをA4かletterか指定できる。~
うまくいくと，build/latexディレクトリに.texファイルが作成...
texファイルからPDFファイルに変換してみる。
> cd build/latex
> make all-pdf-ja
これで，うまく行けばPDFファイルが作成される。
* 作成した日本語ドキュメント
作成したバージョン3.7.2の日本語ヘルプファイル：&ref(pytho...
ページ名:
Counter: 0, today: 0, yesterday: 0
Copyright©2008 Yuji Ueno All Rights Reserved.
ログイン
ユーザ名:
パスワード:
IDとパスワードを記憶
パスワード紛失
メインメニュー
ホーム
でぶlog
資料室
最新ページ一覧
全ページ一覧
ヘルプ
フォーラム
お問い合わせ
