To content | To menu | To search

ドキュメンテーションツール 2016 (1)

今年はまずは、Sphinx + LaTeX に挑戦。

Sphinx で sphinx-quickstart で作った Makefile がいきなりエラーで焦ったけれど、if うんぬんから endif までの3行をコメントアウトすることで回避。
(もともとコマンドがインストールされているかのチェックだけみたいだから)

ただ make で PDF を出力させようとしているのに tex 出力だけで何も言わずに終わってしまう。
日本語周りの例外の処理でエラーになってる模様。

どう対応していいかよくわからないので、Python 3 最新版をパッケージでインストールした後 Sphinx を pip でインストール。
TeX Live もオリジナルのサイトからインストーラーをダウンロードしてインストール。

パッケージ管理としては面倒になるけれど、これで Makefile の内容も少し変わったし、PDF 出力もされた。

内容に関しては、章や節の深さが、Sphinx のマークダウンだけだと浅いけれど、toc 周りを活用してファイル分割すればいけるらしい。
画像に関してのみ、EPS なりなんなり、ベクター形式でいければ、あとはスタイルをどういじるか……で済むと期待。

Add a comment

HTML code is displayed as text and web addresses are automatically converted.

They posted on the same topic

Trackback URL : https://www.pseudomoon.jp/dotclear/index.php?trackback/56

This post's comments feed