MDwiki

MDwiki とは Timo Dörr さんによって作成された CMS/Wiki です.
注意:MDwiki は Archived されています

MDwiki はJavaScript言語で書かれた静的サイトジェネレータ(static site generator)です.基本的には mdwiki.html というファイルだけが必要で他の静的サイトジェネレータに比べて簡単に利用できます.他にも様々な静的サイトジェネレータが存在しています(cf. StaticGen, Static Site Generators).
CMS/WikiCMSContent Management System の略で,Wiki は不特定多数のユーザが共同してブラウザから直接コンテンツを編集可能なウェブサイトという意味です.名前は MDwiki と wiki が付いていますが本来の Wiki の機能はありませんので注意が必要です.

MDwiki には次のような特徴があります.

  • 必要なものは mdwiki.html というテキストのみ
  • Markdown でコンテンツを作成
  • 13種類の Bootswatch を使用したテーマがある(切り替えも簡単)
  • 数式が使える(MathJax を使用)

ダウンロード

1. Mdwiki を ここ からダウンロードして展開
2. mdwiki.htmlindex.html に名前を変更
 ・mdwiki.html : 必要な機能をすべて含む(コードは Minify されている)
 ・mdwiki-slim.html: 必要最低限の機能しか含まない.オフラインでは動かない.
 ・mdwiki-debug.html: mdwiki.html の Minify していないもの

準備

詳しくは Quick Start を参照してください.

次のファイルを作成します.コンテンツはすべて Markdown で作成します.

  • index.md : トップページのコンテンツ
  • navigation.md : 全体のメニュー等の設定(その他に gimmicks の設定)

gimmicks とは MDwiki の機能で,使用すると数式や動画などをコンテンツに含めることができます.

問題点

Markdown で記述できて数式も書けるということで MDwiki でライブラリの整理をしようとしましたが止めました.理由はいくつかありますが止めた主な理由は次の2つです.

・ 数式で下添え字が2文字以上のものが書けない (e.g.  \,a_{n - m + 2} ) .下添え字が1文字なら書けます.
  集合の波括弧を inline で書くのをググるのでも大変だった(基本的な記法で躓くのはツライ).
・ 開発が Archived なのでソースコードを見るしかない

mdwiki.html にすべてのコードを含んでいるので検索・編集するのが大変です.また,複雑なページを書くと速度が気になるらしいです.

使用するのを止めましたが,数式を使用しない簡易なページを作成する分には簡単にスタートアップできるのでオススメです.
今は Hugo で作成中です.