業務手順書・マニュアル作成を楽にする方法があれば教えて下さい

Question

現状：latex

メリット

• 目次生成
• ハイパーリンク
• PDFの挿入
• ファイル分割
• itemize や enumerate 環境で箇条書き・連番
• 数式きれい
• sublime text からビルド
• etc

デメリット

• コンパイル面倒
• フォントがない場合も面倒
• 分割が多くなると管理が面倒

Answer 1

個人的にはこんな感じにしています。

1. 簡易手順書 → Markdown (Pandoc)
2. 本格的な手順書 → AsciiDoc (AsciiDoctor)
3. 日本語を考慮した手順書 → Re:VIEW

いずれも、TeX形式またはMathMLの数式を埋め込めます。Markdownは方言も多いので、処理系込み考えます。ただ、できることには限界があります。MarkdownとAsciidocはPDF(印刷用)にもHTMLにもできますので、両対応の文書を作るのに便利です。ただ、どちらも英文を書くことが前提で作られた経緯があるため、日本語がすこし苦手です。日本語で出版に耐えられるレベルですと、初めから日本語の文章を考慮しているRe:VIEWがいいかと思います。

Comments

[tf23yh8df3]

手順書のレベルに応じた提案、ありがとうございます。
RubyよりもPython派なのでSphinxも検討しようと思います。

Answer 2

分厚い書類を作るのであれば、Wordのようなアウトライン機能（階層的な章節番号を付番してくれる機能）と目次自動作成機能のあるソフトが便利です。

複雑な数式を綺麗に表現するのは、TeXやLatexでしょうね。

文書を作る際は
１．内容、章立てなどを決める
２．必要な図や表を用意する
３．読みやすいように編集する
の３段階が必要です。

アウトライン機能を持つワープロソフトは、１、３で役に立ちます。
図や表は、グラフィックソフトや表計算ソフトが役立ちます。

Comments

[tf23yh8df3]

文書制作のステップを教えて頂き、ありがとうございます。

Office系はどうも重い？感じがするのでエディタから
コンパイルする形で文書を作りたいと考えています。