AsciiDocの文書をCodePipeline/CodeBuildでHTMLに変換してみた ｜ Developers.IO

2018/07/30 10 users かたいなか CodePipeline CodeBuild

こんにちは、かたいなかです。 今回はGithubにpushしたAsciiDocの文書をCodePipeline/CodeBuildでをHTMLに自動で変換する方法をご紹介します。 AsciiDocとは AsciiDocはドキュメントや記事、スライドショーなどを記述するためのテキストドキュメントのフォーマットです。AsciiDocのファイルはHTMLやPDF、EPUBなど様々な... 続きを読む

AsciiDoc と PlantUML と mermaid.js で素敵なテキストベース仕様書ライフ

2017/11/09 80 users plantUML UML フローチャート PDF テキスト

以前からテキストベースで仕様書(PDF)などを管理したいと思っていたのですが、ようやくその環境が整い、一度実際に運用してみてかなりいい感じだったので紹介したいと思います。 基本テキストは AsciiDoc で記述する UML は PlantUML で記述する フローチャートとかは必要に応じて mermaid.js も使う つまり基本テキストで表現・管理できるものはテキストで書く 成果物は PDF形... 続きを読む

【翻訳】テクニカルライティングの将来 ーGitHub上のAsciidocで技術書Pro Gitを協働執筆 | POSTD

2014/12/15 117 users テクニカルライティング 原著者 誘い POSTD 冒険

Pro Git第2版の驚くべき冒険と最終的なツールチェーン ほぼ6年前、私はApressから執筆が予定より遅れていたPro Gitと呼ばれる本の手伝いの誘いを受けました。結局原著者が書き続けないことを決めて、私が最初から […]Pro Git第2版の驚くべき冒険と最終的なツールチェーン ほぼ6年前、私はApressから執筆が予定より遅れていたPro Gitと呼ばれる本の手伝いの誘いを受けました。結... 続きを読む