Markdown Here (MDH) 2.11.0 に更新した時の注意点

Firefox のアドオン Markdown Here 2.11.0 へのバージョンアップでの注意点。リッチテキストエディタを使って Markdown でブログなどの記述している方向け。

[TIPS] Markdown でセンタリングしたい

[TIPS] Markdown でセンタリングしたい

「Markdown でふりがなを振りたい」に続いて、Markdown で右寄せ・左寄せ・中寄せ (センタリング) したいときは、どうすればいいか？ (以下、レンダラは marked.js で動作確認した例です。)

PukiWiki からのデータ移行のシンプルな方法

PukiWiki から Markdown への変換

昨年 (2013年)、XP で運用していたマシンが壊れまして。それ以降、XP上のローカルサーバで長年運用してきた PukiWiki から、他のシステムにリプレイスすることを考えてました。

Wiki 以外の方法もなにかないかと、他の方法の模索をしてきたのだけど、やっぱり、Wiki はいいなと思います。

また一方で、ここ最近は Markdown も便利だと感じてました。Markdown そのものは、Wiki (CMS) ではなく、単なるドキュメントの書式でしかないのだけれども、最近は、JavaScript で書かれた Markdown レンダラーがある。こいつを使えば、Markdown でローカル Wiki みたいなことはできるんじゃないか・・ということを考えた。

で、とりあえず PukiWiki のデータを、なんとか他のシステムに移しやすい形にしたいなと。見てみたところ、

• PukiWiki のデータはテキストファイル (xxxx.txt) で、ひとつのディレクトリにフラットに格納される (pukiwiki/wiki/)


• ファイル名は、EUC コード (16進数) をそのまま文字列にしたもの。スラッシュなんかの記号を含んだものになる。


• ファイルの中身は、EUC-JP で、PukiWiki形式で記述されている。(これは、設定にもよるのかも)

ということがわかった。

PukiWiki のデータを OSX 上の HFS+ に展開する

変換するに手っ取り早い方法は、テキストファイルで表現されているデータ構造とデータを、ファイルシステム上に展開してしまう、というものです。

今使っているのは Mac なので、以下のことを考えました:

• 元のファイル名は見にくいので、デコードして、UTF-8形式で通常の文字列として表す
  
  
  • HFS+で使用できない特殊な記号が使用されていた場合は、必要に応じてなんらかのエスケープ処理をする
  
  
  • ただし、半角スラッシュの場合は、ディレクトリを掘る (HFS+ の仕様と上記仕様からくる制限)


• ファイルの内容は、EUC-JP から UTF-8 に、漢字コードを変換する


• PukiWiki 記法から、Markdown か MediaWiki の形式にする


• 検索システムは、grep か mdfind を使えばいい

ということを、考えました。

ディレクトリを掘るのは、やっぱフラットに数千ファイルあると、みるのが辛いからです。。。

スクリプト

既存のスクリプトがないか、けっこう探してみたのですが、どうも見当たらない……ぜったい誰か作ってるはずなのに……。まぁ、PukiWiki 自体がもう10年近くリリース止まってますしね。

仕方ない。ということで、Ruby で以下のようなものを作りました:

• pw2hfs.rb (変換スクリプト本体)


• nf-pw2md.rb (PukiWiki形式→Markdown形式変換フィルタ)

はじめは MediaWiki 形式にしようかと思いましたが、めんどくさいのでやめました。PukiWiki->Markdown変換は、適当です (一行一行の正規表現マッチングと置換)。あと、スクリプト内で、OSX に入っている iconv コマンドを使ってます。

使い方は、2つのスクリプトを、pukiwiki のデータの格納してあるディレクトリの一つ上において、結果出力用のディレクトリ dst/ を作ってから、pw2hfs.rb を実行します。しばらく待つと、dst/ 以下に、変換したものができます。

この結果と、Invisible.js かなにかを、組み合わせようと思ってます。Wiki の記法 (特に、Markdown 中での、ページ名のリンク ―スクウェア・ブラケットで2重に囲むアレ) 対応は、JavaScript 側でやったほうがいいかな……。

それでは。

[TIPS]Markdown で ふりがな

[TIPS] Markdown で ふりがな (ルビ) を使うには

ものすごくニッチなニーズかもしれないけども、Markdown でふりがなを振りたいとき、どうすればいいか？

Seesaa ブログを Markdown 記法で書くには: Markdown Here を利用する方法

必要とされる準備は以下のとおり:必要とされる準備は以下のとおり:

1. Seesaa ブログの設定で、リッチテキストエディタの有効化


2. Firefox のアドオン: Markdown Here のインストール

試した環境は、Mac OS X Mavericks + Firefox 26.0 です。

ちなみにここで紹介する方法は、Seesaa 以外でも適用することができ、かつまたもっともカンタンな方法だと思います。また、Markdown Here アドオンはトグルする機能を提供する拡張機能であるため、Markdown ⇔ HTML 双方向の変換はいつでもできます。

1. リッチテキストエディタを有効にする

• Seesa BLOG 管理画面で、設定＞詳細設定から、ブログ設定 を選択する


• 設定項目の リッチテキストエディタ (上から14項目目くらいにあるラジオボタン) を 利用する の方をチェックする


• 一番下の保存ボタンをクリックする

くわしくは、こちらから。

2. Markdown Here をインストールする

Markdown Here のHP から、インストールできます。なお、Markdown Here は、Firefox 以外にも、主要なブラウザには対応している模様です。

使い方

準備1., 2. をした上での書き方は、以下のとおりです:

• 新規投稿などで、textarea にてきとうに Markdown で書く


• 変換したいドキュメントの部分 テキストエリアを、選択する (テキスト全体が一括で変換されます)


• 右クリックではなく、Firefox の URI バーの右端のところに表示されている Markdown Here のアイコン (☆の右にある、紫色のばってんっぽいもの) をクリックする
  
  
  • →選択部分が、変換される


• めでたしめでたし

まとめ

• Markdown Here アドオンを利用した、カンタンで応用性の高い、Markdown 記法の利用方法を示した。


• この手法により、Seesaa ブログを Markdown 記法でカンタンに書くことが可能となる。


• この記事自体も、この記事で紹介した手法で書かれている。

References

• http://zerodama.seesaa.net/article/117019121.html “firefoxでseesaaブログのリッチテキストエディタを使うには, 2009. NoScript が悪さをすることがあるらしい。”


• http://free3.seesaa.net/article/269811182.html “Markdown記法でSesaaブログに書くには, 2012. こちらは別解。エディタの機能で行うという方法。”


• http://www.lifehacker.jp/2013/07/130720markdownhere.html “Lifehacker, GmailやEvernoteのテキストでもMarkdown! ブラウザ拡張機能『Markdown Here』, 2013.”


• https://help.github.com/articles/github-flavored-markdown “GitHub Flavored Markdown”

あーあー

しばらく何も書いてなかったけども、いきてます。

こう、いろいろ書いていたのですが、タグ打ちに非常にめんどくささを感じるようになってしまいまして。ローカルで Wiki なんかを、試してみたりしていました。やっぱり、Markdown とかを使いたいですね。。。

あ、あと、2008年に書いた『Ruby: 数字に桁区切りを入れたい (その1)』 を、微修正しました。