タグ

gitとmarkdownに関するrichard_rawのブックマーク (4)

  • 『いちばんやさしいGit&GitHubの教本』執筆開始から終了までのできごと - よこなのへたのよこずき

    共著で出させていただいたいちばんやさしいGit&GitHubの教 人気講師が教えるバージョン管理&共有入門 (「いちばんやさしい教」シリーズ)について、「執筆作業」って実際のところどんな感じなの?といった内容を、実体験とともに記録します。 昨年の終わりに書いた、執筆を進めるための自己管理に関するエントリもありまーす。 ihcomega.hatenadiary.com については、多分もう1エントリくらい書きます。内容にフォーカスしたやつ。 📕執筆のきっかけ jjug.doorkeeper.jp もう3年前になりますが、共著者のしょぼちむさん(@syobochim)とJJUGナイトセミナーでGitの入門セッションをやったことがあります。これを知った編集担当のリブロワークス大津さんより、JJUG宛に執筆のご依頼をいただいたのがスタートでした。2018年の1月終わり頃です。 声をかけてく

    『いちばんやさしいGit&GitHubの教本』執筆開始から終了までのできごと - よこなのへたのよこずき
    richard_raw
    richard_raw 2019/01/16
    リアルタイムプレビューできるAtomプラグインいいですね!Vivliostyleというのか。
  • gitbookで設計書を作成したら最高だった話 - フォトシンス エンジニアブログ

    こんにちは。Akerunエンジニアの @ishturk です。 Akerun Advent Calendarの記事です。 今日は設計書の話です。 設計書をどんなツールで書くかは、僕らソフトウェアエンジニアの尽きない悩み(楽しみ)ですね。 最近はまったツールが最高に良かったので紹介させてください。 僕のツールに求める要件は以下です。 編集がカジュアルにできる UMLが書ける。あとから編集できる(画像での貼付けは編集できないのでNG) バージョンの管理ができる 好きになれる(重要) 変遷と pros/cons MS Word pros 良くも悪くもスタンダードなツールですね。 だれでも編集できるのが強みです。 Visioと組み合わせれば、UMLも後から編集可能です cons Visioは標準にするには少々値が張ります。 バイナリ形式なのでバージョン管理はしづらいです。 ページが増えたり画像を貼

    gitbookで設計書を作成したら最高だった話 - フォトシンス エンジニアブログ
    richard_raw
    richard_raw 2017/12/27
    Sphinxみたいなの。/「SUMMARY.md」にファイル単位の文書構造を書くんですね。
  • 第406回 Node.js製のGitBookでお手軽に電子書籍作成 | gihyo.jp

    GitBookはMarkdownで記述しGitで管理しているドキュメントを、簡単にHTMLPDF、EPUB、MOBIなどで公開できるサービスです。今回はこのGitBookで使われているgitbookコマンドを用いて、Ubuntu上でドキュメントを生成する方法を紹介します。 今風な文書執筆・公開環境としてのGitBook 人類の進化は文書の作成と共にあります。より良い文書の存在が、質の高い教育、確実な情報の伝達、技術文化の進歩を導いてきました。連載が掲載されているgihyo.jpでも、今年の新春特別企画に「ドキュメントの構造化による、良いドキュメントの作成方法」が掲載され注目を集めているように、いかにより良い文書をよりお手軽に作成できないか苦心されている方も多いことでしょう。 今回紹介する「GitBook」は、技術者であれば使っている人が多いであろう「Git」と「Markdown」を使

    第406回 Node.js製のGitBookでお手軽に電子書籍作成 | gihyo.jp
    richard_raw
    richard_raw 2016/01/28
    ローカルで動かしたいけどwily用のnode.jsはないのか……。/電子書籍変換はCalibreを使ってるんですね。
  • markdown->TeXの変換だけで卒論を仕上げるのに便利だったツール10個まとめ - mizchi's blog

    卒論書き上がったので環境を後続の人類のためにどうやって作ったかメモっておく。 環境はMacだったけどMacTeX以外たぶんLinuxでもいける。その指導教員に入れられたmacportsのTeXTeXShopを窓から投げ捨てろ。というのが要旨。 MacTeX MacTeX - TeX Users Group http://tug.org/mactex/ 2014年において他の環境を入れる必然性は殆ど無い。これ一。 iconv この時代sjisを扱うのは人生をムダにするだけなので、研究室の秘伝タレたるtexもまずutf8に変換。 その後 ¥ を \ に置換するのは必要だったけどオプションでどうにかなるのかもしれない。 iconv -s -f SHIFT_JIS -t UTF-8 hoge.sty > hoge.utf8.sty pandoc markdowntexに変換できるツール。革命

    markdown->TeXの変換だけで卒論を仕上げるのに便利だったツール10個まとめ - mizchi's blog
    richard_raw
    richard_raw 2014/01/21
    こういう環境で仕上げたかった……。/pandocのためだけにcabal入れてましたけどformulaあったんかい。
  • 1