#title(MDwiki：Markdownベースの超シンプルCMS)
MDwikiは、Markdownベースのとてもシンプルなコンテンツ管理ツール。
非常に便利だったけど、ほとんど日本語情報がなかったので整理しておきます。
#ref(mdwiki.png)
-オフィシャルサイト [[MDwiki - Markdown based wiki done 100% on the client via javascript:http://dynalon.github.io/mdwiki/#!index.md]]
#contents
* 特徴 [#r237042d]
- mdwiki.htmlというひとつのファイルだけあれば利用できる
で、Markdown記法で書かれたテキストファイル(拡張子 .md、以下mdファイル)を、このmdwiki.htmlと同じフォルダに置く。
これだけで、mdファイルがWebページとして表示されます。
サーバーにスクリプトやDBを設置する必要もないし、いちいちmdファイルを変換する必要もありません。
- mdwiki.htmlのなかに、JavascriptとBootstrapベースのテンプレートが埋め込まれている
- Gimmicks（ギミックス） という追加機能で、GoogleマップやFacebookなど今どきのソーシャルサービスにも対応。
- ただ、クライアントサイドでhtmlが作られるので、検索エンジンに引っかからない(何か手があるらしい)。
- 作ったのは、 Timo Dörr(Dynalon)さん。ライセンスは、GPLv3 + 追加条項
* サンプル [#p461b515]
-[[Welcome...:http://dynalon.github.io/mdwiki-examples/cafe/#!index.md]]
-[[Trave blogl:http://dynalon.github.io/mdwiki-examples/travel_blog/#!index.md]]
-[[Muscle Cars of the 70's:http://dynalon.github.io/mdwiki-examples/muscle_cars/#!index.md]]
* はじめ方 [#wc87a061]
+ ドキュメントをmdファイルとして準備。文字コードはUTF-8。1行目は、見出し1にする(#記号)。最初のページのファイル名は、index.mdとします。
+ MDwikiをダウンロード。https://github.com/Dynalon/mdwiki/releases
+ index.mdとmdwiki.htmlを同じフォルダにおく
-- Firefoxなら、mdwiki.htmlを開くと、自動的にindex.mdが変換されて表示
-- どこかにWebサーバーがあるなら、そこにおいてもいい。社内とかイントラネットで使うなら、[[XAMPP>xampp]]とか用意するのが早いかも。
* 使い方 [#qb447bda]
使い方も、とてもシンプル
**ページアクセス [#e6596744]
- 「mdwiki.html」を開く場合は、index.mdが変換されて表示される
- 下記のように「mdwiki.html」の後ろに「#!」＋mdファイル名をつけると、そのmdファイルが変換されて表示される
- 例 http://example.com/mdwiki.html#!myfile.md
**ページ内のナビゲーション [#lf7c5c0e]
- 見出し1が、ページタイトルになって、見出し2がたくさんあるとサイドに一覧表示される
** 書式設定 [#vbeafc28]
markdownでやる。画像やリンクもOK。
http://dynalon.github.io/mdwiki/#!layout.md
**共通ヘッダー [#h93a546c]
- 下記のように、navigation.mdファイルを書いて、同じフォルダに置くと、上部の共通ヘッダーにメニューが表示される
# サイトタイトル
[Home](home.md)
[About](about.md)
[Download](download.md)
* 各種設定 [#m39d17f6]
** テーマの切り替え [#r991278e]
公式サイトの右上にあるやつ。
Theme chooserというギミックスでできる。
http://dynalon.github.io/mdwiki/#!customizing.md#Theme_chooser
**ギミックス [#h6ae0750]
Gimmicks（ギミックス） という追加機能で、GoogleマップやFacebookなど今どきのソーシャルサービスにも対応。
こんなのが、ありますね。
- Alerts
- GitHub Gists
- Facebook Likebutton
- Fork me on GitHub - Ribbon
- Google Maps
- UML Diagrams via yUML.me
- Math
- Twitter
- Youtube
- Disqus
http://dynalon.github.io/mdwiki/#!gimmicks.md
** スタイルシート [#nbf1d158]
mdwiki.htmlに埋め込まれているので、そこをいじる。
デフォルトでは、Twitter bootstrapが組み込まれていて、さらに追加のcssがある。
個人的には、追加部分をmdwiki.cssという外部cssファイルに切り出して、そちらでいじっている。見出しなどのスタイルを変えるときも、そこでやる。
** カスタマイズ [#mf9f6330]
config.jsonというファイルを同じフォルダにおくと、カスタマイズできる。こんな設定がある。
- サイドナビのON/OFF
- オリジナルの改行指定
- フッターテキストの追加
- アンカー記号
{
"useSideMenu": true,
"lineBreaks": "gfm",
"additionalFooterText": "All content and images © by John Doe",
"anchorCharacter": "#"
}
詳細は、http://dynalon.github.io/mdwiki/#!customizing.md#Configuration
* ライセンス [#g1dbae40]
- GPLv3 + 追加条項
- 追加条項は、GoogleマップのコードとかTwitterボタンとかは、GPLv3の対象外とか言っている(たぶん)
-- https://github.com/Dynalon/mdwiki/blob/master/LICENSE.txt
* 関連情報 [#wa74862f]
-[[MDwiki - Markdown based wiki done 100% on the client via javascript:http://dynalon.github.io/mdwiki/#!index.md]]
** レビュー [#e93a58c7]
少し増えていた
-[[MDwiki·Markdownをコンテンツに使ったCMS/Wikiシステム MOONGIFT:http://www.moongift.jp/2013/11/mdwiki-markdown%E3%82%92%E3%82%B3%E3%83%B3%E3%83%86%E3%83%B3%E3%83%84%E3%81%AB%E4%BD%BF%E3%81%A3%E3%81%9Fcmswiki%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0/]]
-[[MarkDownで書いたファイルを置くだけでWiki化できるMDWikiを導入してみた。 - Qiita:http://qiita.com/nusa/items/8b07a8d75abc2044fa87]]
-[[MDWikiを導入してみてわかったこと - Qiita:http://qiita.com/nusa/items/54cc7b38517192b3caf4]]
-[[MDwikiに感動した - Qiita:http://qiita.com/tukiyo3/items/4cbfa1d2338c061df015]]
-[[MDwikiでローカルにオレオレWikiを作成する - 気になったことをいろいろやってみる:http://ogeji.hatenablog.com/entry/2015/06/05/121109]]
-[[MDwikiはじめました | 3D技術研究所Blog:http://3dtech.jp/blog/?p=101]]
-[[【MDwiki】HtmlとMarkdownファイルを置くだけで作成できる！自分専用Wikiツールのご紹介: シーサー渋谷ではたらく技術担当のブログ（SSGブログ）:http://techdev.seesaa.net/article/436995731.html]]
-[[[dropbox][wiki]MDWikiについての情報をまとめる | ブログ | そうだ車輪と名づけよう 5th:http://www.atyks.org/blog/detail/2015-10-22-1]]
-[[MDwikiに関するTips - hphm’s diary:http://hphm.hateblo.jp/entry/2015/03/23/124819]]
-[[MDWikiの導入方法 - MIN:http://min.hatenablog.jp/entry/2016/02/06/155242]]
-[[MDwikiをOwncloudと連携させてWebで編集できるようにした - ひよこになりたい:http://zipsan.hatenablog.jp/entry/20151014/1444816696]]
-[[MDWikiに関する6件の投稿 - Qiita:http://qiita.com/tags/MDWiki]]
** 類似ツール [#c80aec70]
-[[Markdown・Textile・Wiki記法をサポートしたJavaScript製ドキュメントフレームワーク「Invisible.js」を公開しました(オープンソース) | Chrome Life:http://www.chrome-life.com/javascript/554/]]
-[[好きなブラウザで動作するMarkdownビューアlocal-notes.jsを公開しました:http://henry.animeo.jp/blog/2013/11/29/local-notes-js/]]
-[[marked.js :https://github.com/chjj/marked]]
あと、MDwikiという名前のツールが、他にもいくつかあって、ちょっとまぎらわしい
-[[erickrdch/mdwiki:https://github.com/erickrdch/mdwiki]]
-http://www.mdwiki.net/
** そのほか [#m5cd1bf7]
Markdownの書き方
-[[Markdown記法>markdown]]
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
