UniVRM/docs

Sphinx 作業

初期化

$ pip install sphinx
$ mkdir docs
$ cd docs
docs$ sphinx-quickstart

docs/_build/ja に日本語ドキュメントを出力する

doc$ sphinx-build . _build/ja

MySt 導入

markdown で記事を記述する

$ pip install --upgrade myst-parser

conf.py

extensions = ['myst_parser']

gettext で英語記事を作成する

$ pip install sphinx-intl

conf.py

locale_dirs = ['locale/']
gettext_compact = False

potファイル作成

doc$ sphinx-build -M gettext . _build

poファイルを作成

doc$ sphinx-intl update -p _build/gettext -l ja