AsciiDocによる継続的ドキュメント開発〜１．インストールと基本的な使い方 - dackdive's blog
はじめに ドキュメントを書くための言語としておそらく今一番ポピュラーなのは Markdown だと思いますが、 かっちりした仕様書やユーザーマニュアルなど、より本格的なドキュメント作成にはやや機能不足と感じることがあります。 私も以前、ドキュメントを Gitbook で作れないか検討したことがあったんですが 表を書くのがめんどくさかったり、図のキャプションなどに対応していなかったことから断念しました。 そこで、今回は Markdown よりも表現力の高い言語として知られる AsciiDoc を試してみます。 AsciiDoc は O'reilly でも採用されているほか、Pro Git や JavaScript Promise の本 などの非常に完成度の高い技術ドキュメントが AsciiDoc で書かれています。 （参考記事） ・テクニカルライティングの未来を先取り ー Asciidoc
AsciidoctorをdockerとAtomエディタでいい感じに使えた - Qiita
= Hello, AsciiDoc! Doc Writer <doc@example.com> An introduction to http://asciidoc.org[AsciiDoc]. == First Section * item 1 * 日本語 [source,ruby] puts "Hello, World!" image::http://asciidoctor.org/images/octocat.jpg[GitHub mascot] [source,ruby] .a.rb ---- puts "Hello, World!" ---- // : コメントアウト <<< : 改ページ = : 見出し1 == : 見出し2 出力例 htmlは以下。pdfは本みたいでかっこいい。 変換
そろそろExcelで資料作るのやめたい - Qiita
(追記） このアイデアを一部利用したエディタを作りました→完全に単一のHTMLファイルで動作するMarkdownエディタ作った 概要 Excelの代わりにHTML5+markdownを使うといいんじゃないの？というお話し。 エクセル方眼紙つらい SIer界隈ではいまだにExcelが大流行です。Excelは使いどころさえ間違えなければ大変強力で便利なツールですが、いかんせん使いどころを間違えた資料が多すぎるなと感じています。 例えば開発環境などの導入手順書とかバグの調査報告書とか、どう考えてもExcelに向いてない資料まで頑張ってExcelで作っていたりします。使いどころを間違えたExcelの資料は、非常にメンテナンス性が悪いです。 Excelで作られた資料を手直ししたら改行位置がずれて一行一行手動で直した 1行増えただけで罫線がずれて1ページ1ページチマチマと泣きながら直した 追記しようと
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
