ドキュメント生成・変換ツール
Yuki Fujiwara edited this page Apr 18, 2017
·
3 revisions
- Pandoc を参照
- Sphinx
- HTML(マルチページのWebサイト), LaTeX文書, Word文書などが生成できる
- 基本的にreStructuredText(reST)で書く
- 最近はMarkdownでも書けるようになった
- CommonMarkベース
- 複雑な機能は書けない (reSTで書く)
- 最近はMarkdownでも書けるようになった
- ルビ拡張(shirouさん): https://bitbucket.org/r_rudi/sphinxcontrib-textstyle/
- MkDocs
- SphinxよりシンプルでMarkdownベースのドキュメント生成ツール
- TeX/LaTeX
- 数式を含む文書はもちろん、参考文献や節番号などの変数を使いまくる論文や書籍の執筆にも便利
- 出版に耐えうる組版ができ、対応する出版社も割とある(例:結城浩『数学ガール』シリーズ)
- はじめてTeXを使う人が知っておくといいことまとめ- Qiita
- TeX2img
- 困ったら TeX Wiki を見よう
- TeXユーザ会Slack: https://texuser.slack.com/shared_invite/MTY5ODg0ODM0NjczLTE0OTI0OTg4NjktOWRjNzJiNDZhMg
- Microsoft Word (Office)
- 見出し(アウトライン)機能や改ページなどをきちんと使えば、割と綺麗に長めの文書を作れる(本来は)
- Office 2007からファイル仕様がオープン化 (Office Open XML)
- ただのZipファイルなので、解凍すればXMLが読める
- LibreOffice
- ソフトウェアもデータ仕様もオープン(ありがたい)
- 実は
soffice
というコマンドラインツールが使える- PandocからのPDF出力に使えそう
- 一太郎
- 素人が使うレベルで、綺麗に1枚ものの文書を作れる(本来は)
- Wordでいうワードアートに相当するロゴ作成機能が結構いいらしい
- 罫線が楽に引ける(ので、Excel方眼紙を駆逐してほしかった)
- 地味に日本語対応のEPUB出力機能がある
- 文芸的プログラミングとは
- Donald E. Knuth (TeXの人)が提唱した、ドキュメントの中にソースコードを埋め込み、実行するスタイルのプログラミング
- Jupyter Notebook (Python)
- Pythonベースのドキュメンテーションシステム
- 旧: IPython Notebook
- 今はPython以外の言語でも使えるらしい
- Pythonの実行結果をドキュメントの中に埋め込める(文芸的プログラミング?)
- インストールのベストプラクティス
- 2016年末ではanaconda一択(が楽)
- 応用
- Pythonベースのドキュメンテーションシステム
- R
- RStudioというIDEの中で、Rのコードと実行結果を埋め込んだ文書(レポート)を作成できる
- Knitrというパッケージをインストールしてくれる
- R markdownというMarkdown方言を使う (Pandocベースらしい)
- 参考
- RStudioというIDEの中で、Rのコードと実行結果を埋め込んだ文書(レポート)を作成できる
- Kajero (JavaScript)
- Kajero
- Markdownベース
- D3などのJavaScript系グラフ・データ可視化ツールがそのまま使えるらしい
- クライアント向けJSライブラリなら何でも埋めこめるはず(想像が付かない)
-
電書ラボ
- 電子書籍で何か知りたかったら、とりあえずここが参考になる
-
電書ラボEPUB制作仕様
- 実用的なEPUB仕様案(KOBO、Kindle、Appleで配信できるEPUBファイルを作るための仕様)
- 電書ラボチェッカー
- EPUB 3.0 日本語組版要望表 | 日本電子書籍出版社協会
- 組版表現説明書 日本電子書籍出版社協会
- 電書ラボ
- 「アクセシビリティに考慮した電子書籍」づくりの例
- Markdown原稿を元に、一部Pandocを使っていただいたとのこと(Markdown→XHTML)
- https://twitter.com/magi1125/status/839449667628740609
-
アンテナハウス株式会社
- 瞬簡PDFシリーズの会社
- 社長がやたらとPDFとXMLの技術に詳しいので気になる
- Antenna House Formatter V6.4 リリースのお知らせ
- これが凄すぎる
- クライアントサイドで完結するサイト(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プレゼンを出力できる
この 作品 は クリエイティブ・コモンズ 表示 4.0 国際 ライセンスの下に提供されています。