mieki256's diary



2013/08/03() [n年前の日記]

#1 [prog] Markdownでドキュメントを書いてたり

ある程度プログラムができてきたので、ヘルプ相当というか、githubにアップするために必要な readme.md を ―― Markdown文書を書き始めたり。

Markdownというのは、「素のテキストファイルとして眺めても読みやすく」「HTMLその他にもサクッと変換しやすい」文書のフォーマット、とでもいうか。

常用してる xyzzy で Markdown を書けなくもないのだけど、HTML変換結果をリアルタイムプレビューをしてくれる _MarkdownPad - The Markdown Editor for Windows を使って書いてたり。ちなみに、Windows用のエディタです。Mac用ではないです。

自分で作った _markdowneditorpyqt で書いてもいいのだけど。元々、昔の MarkdownPad の動作に不満があったり、 _MarkDown#Editor が自分の環境では何故か動作に問題があったから、仕方なく自分で作ってお茶を濁してただけの話だったわけで。でも、MarkdownPad が動くなら ―― 日本語入力その他にも対応してくれているなら、そっちを使わない手はないよなあ、と。

他にも、 _Markdown Previewer というサービスを使うのも良さそうだなと。何かしらのエディタで Markdown を書いて保存するたびにリアルタイムプレビューしてくれるサービスらしくて。…サービスという分類でいいのだろうか? そういう処理をしてくれるhtml、と呼ぶべきなのかな? 何にせよ、自分が普段から使い慣れているエディタで、プレビューもできてしまうあたりは素晴らしいと思ったり。

Markdown というと、少し前までは、 と、そんな感じで、Windowsユーザにとっては残念な状況があったのだけど。最近はWindowsでもちゃんと使えるアプリやサービスが揃ってきた印象があって、実にありがたいなと。

htmlの変換には BlueFeather を使わせてもらったり。 :

_BlueFeather

BlueFeather は、Markdown → html変換ツール。Ruby製。目次を自動生成してくれたり、変換時にcss指定も挿入してくれたり、Markdown Extra + α が使えたり等、いくつか機能追加されてるツール。
  • 目次の自動生成がなかったら、人間様が目次部分も書かないといかんわけで。それだと、絶対に見落とし・記述ミスが発生する。
  • cssを自動挿入できないと、htmlに変換するたびに、毎回人間様がコピペして追加しないといけないわけで。地味に面倒臭い。
そんなわけで、BlueFeather、便利です。ありがたや。

ただ、独自記述が Markdown 文書内に増えてしまうので、他のMarkdown関連アプリで眺めた際に、謎文字列が表示されて、ちとアレな感じも。変換時のコマンドラインオプションで指定等できれば解決するのかもしれないけど、cssやタイトル指定はともかく、目次はどこに挿入すべきかは指定方法が思いつかない。その点、文書内でアレコレ指定するほうが使い勝手はいいのかもしれないので、判断に悩むというか。

以上、1 日分です。

過去ログ表示

Prev - 2013/08 - Next
1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30 31

カテゴリで表示

検索機能は Namazu for hns で提供されています。(詳細指定/ヘルプ


注意: 現在使用の日記自動生成システムは Version 2.19.6 です。
公開されている日記自動生成システムは Version 2.19.5 です。

Powered by hns-2.19.6, HyperNikkiSystem Project