【roff形式を手書きは無理ゲー】manページをMarkdown + Pandocで作成【with manページお作法】 by nao · 公開済み 2020年12月19日 · 更新済み 2020年12月25日 前書き:manualページは伝統的なドキュメント manページは、UNIX系OSのドキュメントであり、コマンドやシステムコールなどの説明が記載されています。 Unix v7の時代(1979年)から変化が少ないため、2020年現在の視点で見ると表現力に難があります。具体的には以下のような欠点があり、manページを良質なドキュメントとするには文章力を試されます。 画像を挿入できない ハイパーリンク非対応 Terminalからしか参照できない(manページをHTMLに変換して公開しているサイトはあります) 勿論、manページより表現力が高いTexinfo、Docbookなどの代替ドキュメ
![【roff形式を手書きは無理ゲー】manページをMarkdown + Pandocで作成【with manページお作法】](https://cdn-ak-scissors.b.st-hatena.com/image/square/8d8748a07723d73b9c73b73b67c9cab0c2885126/height=288;version=1;width=512/https%3A%2F%2Fdebimate.jp%2Fwp-content%2Fuploads%2F2020%2F12%2Fbooks-1845614_640-min.jpg)