Vivliostyleで今度こそはじめる「Markdownで技術同人誌」（前編）
2020年末、技術同人誌をはじめて書くならVivliostyleで決まり！ （ってそろそろ言いたい……） 技術書典に代表されるように、技術同人誌[1]が盛り上がりをみせています[2]。 私は以前に「技術同人誌をMarkdownで書く」とは、実際どういうことか？という記事を書いたことがあります。書いた時期は2018年末でした。当時は「初心者が原稿をMarkdownで書いてPDFとしてビルドし、比較的安全に印刷所へ入稿する方法」が確立されていなかったと記憶しています。 その時期から状況は変わり、初心者に勧められそうな「技術同人誌をMarkdownで書く」ためのツールが登場しました。それがVivliostyleのCreate Bookです。 Create Bookによって、次の同人誌の制作・入稿ワークフローが比較的手軽に実現できるようになりました。 プロジェクトの作成 Markdownによる本文
ghq v1リリースとghq-handbookのお知らせ | おそらくはそれさえも平凡な日々
https://github.com/motemen/ghq/releases/tag/v1.0.0 年末にアナウンスしていた通り、先程ghq v1.0.0をリリースしました。変更点は以下のエントリでお知らせしていたとおりです。その他Subversion周りの対応を無駄に頑張って強化したりしました。 https://songmu.jp/riji/entry/2019-12-28-ghq.html 是非ご利用ください。 年末年始休暇中にドキュメントを書いていたのですが、思ったよりもしっかりとした分量になったので、思い立って電子書籍にして販売してみることにしました。 https://leanpub.com/ghq-handbook 日本語で20ページほどです。値段は$1.99くらいにしたかったのですが、Leanpubで収益を上げる場合には$4.99が下限のようなので、その額に設定させてもらいま
「マークダウンで作る岩波新書」高瀬拓史氏(イースト)/20190731t - Speaker Deck
All slide content and descriptions are owned by their creators.
技術書の執筆、電子書籍ビルド、出版プラットフォーム - nullbooks
技術書の執筆、出版の方法が分からない 原稿のビルドやプレビュー、自動文字校正の環境を整備するのが面倒 出版社とのやり取りをする中で原稿と出版物が一致しなくなっていく 著者やレビュアーとの やり取りや取りまとめ、連絡が大変 執筆環境のツールがバラバラで使いにくい、手間が多い ブラウザで技術書の執筆、公開ができるので、誰でもすぐ技術書の執筆ができます エディターがMarkdown、各プログラミング言語のハイライトに対応しています 原稿を書籍と同じデザインでプレビューしたり、Epubをビルドできます 原稿から直接、出版物を作成できるので内容にズレが生じません 執筆中の文字数やページ数を常に知れるので、本の分量を意識して執筆できます さらに、以下の機能を追加予定です オンライン上での共同執筆、共著のための機能 文字校正 (textlint)やルール設定、一括での置換 レビューやコメントをオンライン
技術ドキュメントにもCIを~「ドキュメント作成システム構築ガイド」を読んで ~ - Qiita
ドキュメント作成システム構築ガイド を読み終えたので、その感想です。GitHubとCIサービスの組み合わせ方、gitやmarkdownの初歩的な使い方も丁寧に書かれているので、意外と新人向きの書籍かもしれません。 発売前に、エクセルで手順書を作るのはきっとやめた方がいいという自分の投稿に、その解決策としてCIに沿ったライティングの情報を追加したのですが、それが著者のお一人の目に留まったらしく、なんだか恐縮です。 概要 ソースコードの品質を高めるために、継続的インテグレーション(CI)が導入されてきたように、ドキュメントに対してもそれをやろうというものです。そのために バージョン管理システム(Git) Gitで差分が見やすい軽量マークアップ言語(markdown,asciidocなど) 文章を校正するためのツール(RedPen,textlintなど) PDFやHTMLなどに出力するためのツー
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
