markdownを使う準備

道具の分類

以下の２つのソフトウェアは、２つの分類（右図）のそれぞれについて代表的なものの１つ。
他にも多数あるが本科目では以下の２つを前提に説明する。

MarkdownPad2 インストール
- 同上
```
   cinst markdownpad2 -y
```
  markdownエディタ
  
  または配布元などからダウンロードしてインストール
- または、「markdown オンライン」でオンラインで編集できるサイトを使えるようにしておくこと。
- いずれも、この種類のエディタのポピュラーな形態として、左側がソース入力画面、右側がプレビュー（結果表示）画面という構成になっていることが多い。
- 作成したものは一般的に .md という拡張子のファイルとして保存することになっている。
  オンラインで作成するときは、その作成物の保存方法については調査した上で使うこと。
kramdown インストール（Rubyのライブラリ）
- コマンドプロンプトで
```
   gem install kramdown
```
  （Slimを入れたときと同じ proxy設定要）

変換の方法

markdownpad2の機能
- HTMLへのエクスポート
- HTMLとして文書全体をコピー（してから別の場所に貼り付けて使う）
- ライブプレビュー（画面の右半分）または「ブラウザでMarodownを表示」によってプレビューもできる。
  - このときはファイルへの保存はされない。

kramdown コマンド

 kramdown -h
 :: この出力（使い方説明）は長すぎて流れていってしまう可能性がある
 kramdown  mdソースファイル名
 ::
 kramdown  mdソースファイル名 > html出力ファイル名

SLIMの中に埋め込む：
以前（SLIMの紹介時）に提示した例section)や、SLIMファイルにあるように、
```
 markdown:
   ## markdownの例
   ここにあるようにmarkdown部を2文字分字下げする
```
という書き方をしておくと、slimrbコマンドで変換でき、 * SLIM（ページ全体の構成を記述する）と、markdown(原稿を書く)を１つのファイルで併用できる。 * このとき内部で必要に応じてkramdownなどの補助的プログラムが呼び出される。

rakeファイルにルールを記述する：
以前に作ったrakefile.rb に、以下のような行を記述すると、(SLIMの時と同様に) rakeコマンドで自動的に変換される。

 MSRCS = FileList["*.md"]
 MOBJS = MSRCS.ext('html')
 ## この２つの大文字の名前は、rakefileの内部で
 ## 変数名として使われるものなので
 ## 名前は何でもいい。ただし、上記のMOBJSは
 ## 以下の行でタスク名の１つとしてもう一度使う。

 task :default => SOBJS+MOBJS
 ## SLIMのタスク名 SOBJS とともに、MBOJSも有効にする

 rule '.html' => ['.md'] do |t|
   sh "kramdown #{t.source} > #{t.name}"
 end
 ## この３行で変換の方法を具体的に示す

kramdownを（コマンドではなく）rubyのライブラリとして使う：
以下にプログラムの例を掲載する。（詳細の説明は省く）

 #!ruby -Ku
 require 'kramdown'
 cssName= 'default.css'
 incName= 'inc.html'
 puts <<EOS
 <!Doctype html>
 <meta charset="utf-8">
 EOS
 File.exist? incName and puts File.open(incName).read
 File.exist? cssName and 
   puts %Q!<link rel="stylesheet" type="text/css" href="#{cssName}">!
 puts Kramdown::Document.new(STDIN.read).to_html