ドキュメント生成・変換ツール - doc-wiki-jp/wiki GitHub Wiki

Pandoc

マルチページに適したドキュメント作成ツール

  • Sphinx
    • HTML(マルチページのWebサイト), LaTeX文書, Word文書などが生成できる
    • 基本的にreStructuredText(reST)で書く
      • 最近はMarkdownでも書けるようになった
        • CommonMarkベース
        • 複雑な機能は書けない (reSTで書く)
    • ルビ拡張(shirouさん): https://bitbucket.org/r_rudi/sphinxcontrib-textstyle/
  • MkDocs
    • SphinxよりシンプルでMarkdownベースのドキュメント生成ツール

紙やPDFに適したドキュメント生成ツール

  • TeX/LaTeX
  • Microsoft Word (Office)
    • 見出し（アウトライン）機能や改ページなどをきちんと使えば、割と綺麗に長めの文書を作れる（本来は）
    • Office 2007からファイル仕様がオープン化 (Office Open XML)
      • ただのZipファイルなので、解凍すればXMLが読める
  • LibreOffice
    • ソフトウェアもデータ仕様もオープン（ありがたい）
    • 実は soffice というコマンドラインツールが使える
      • PandocからのPDF出力に使えそう
  • 一太郎
    • 素人が使うレベルで、綺麗に1枚ものの文書を作れる（本来は）
    • Wordでいうワードアートに相当するロゴ作成機能が結構いいらしい
    • 罫線が楽に引ける（ので、Excel方眼紙を駆逐してほしかった）
    • 地味に日本語対応のEPUB出力機能がある

文芸的プログラミング (literate programming)

EPUB・電子書籍

Static Site Generator (静的サイトジェネレータ)

  • クライアントサイドで完結するサイト（HTML/CSS/JavaScript）を作るツール
    • 軽量なブログやサイトを作れる
    • GitHub PagesやAmazon S3などに載せるだけで公開可
  • Docute https://docute.js.org/#/home
    • クライアントサイド(JavaScript)で完結する（？）
  • Hugo
    • Goベースの静的サイトジェネレータ
    • 生成が早いらしい
  • Hexo
    • JavaScript(Node)ベースの静的サイトジェネレータ
  • Jekyll
    • GitHub

プレゼンテーション資料

  • DeckSet (Mac)
    • Markdownベースのプレゼンツール
    • 機能は十分で使いやすいけど、カスタマイズ性に難あり
  • Marp
    • クロスプラットフォームでMarkdownベースのプレゼンツール
  • Pandoc
    • reveal.jsなどのHTML5プレゼンを出力できる