秀丸Wiki　- Markdownを利用したHTML変換マクロ

はじめに

　テキストとしても見栄えが良いとされているMarkdown書式をHTMLに変換します。変換されたHTMLを雛形のファイルに流し込んで、Webページを作成することを目的としています。

　このマクロは秀丸エディタのマクロとMarkdownを利用してテキストをHTMLに変換します。雛形となるHTMLファイルにMakrdownで変換した内容を挿入します。ホームページを作るのにちょっとだけ楽になります。

　本当はMarkdownではなくdeplateを利用して開発したのですが、Markdownの方がテキストとしたときに見やすいかなと思いまして、Markdownに変更しました。

※本マクロ単品では変換はできません。Markdownを利用してHTMLに変換します。

動作テスト環境
OS:Windows XP SP2
秀丸エディタ Ver 7.09
Perl 動作環境

基本機能

　基本機能は以下のとおりです。

Markdown.plを利用してテキストをHTMLファイルに変換します。
秀丸WikiのWikiNameからリンクを作成します。[[WikiName]]を [WikiName](WikiName.html)に一次変換し、Markdownで最終的なHTMLファイルに変換します。
テンプレートを利用することで、そのままWebにアップ可能なHTMLファイルを作成します。

設定

ダウンロード

　秀丸Wikiダウンロードします。MarkdownはPerlをインストールしてあることが前提になります。

ダウンロードページ　秀丸Wikiのマクロに梱包されています。
Markdown　
ActivePerl

インストール

　マクロ一式を解凍し、フォルダ毎コピーして秀丸のマクロに登録して下さい。なお、PerlとMarkdownが必要となります。Markdown.plはマクロと同じフォルダに入れて下さい。

1. markdown.pl,template.txtをマクロと同じ場所に保存して下さい。

2. main.css ファイルを変換ファイルと同じ場所に保存して下さい。（必須ではありませんが、Webの見栄えが変わります）

3. markdown.mac を秀丸のマクロに登録して下さい。

4. 秀丸でキー割り当てをおこなう変換がスムーズにできます。（必須ではありません）

※ Perlをインストールしてあることが前提条件になっています。markdown.plをexe化してある場合はマクロを書き換えることで、Perlが不要になります。（exe化の時にPerlが必要になるので１回はPerlをインストールする必要がります。）

アンインストール

　本マクロはレジストリなどを操作していません。基本的には削除することでアンインストールが完了します。

仕様

タイトル

　１行目にはタイトルを記述して下さい。１行目の改行コード手前までがHTMLのタイトルに変換されます。１行目にタイトルが記述されていない場合は、タイトルはなにも入りません。以下の例題は、本Webサイトの１行目のタイトルの例題です。

秀丸エディタ用　- Markdownを利用したHTML変換マクロ Ver 0.1β

## はじめに
　テキストとしても見栄えが良いとされている・・・

WikiName

秀丸WikiのWikiNameをMarkdownのリンクに変換します。

[[WikiName]]はWikiNameとして自動的にページのリンクが挿入されまます。WikiNameは英数字を用いて記述して下さい。

[[index][Title]] は、indexにリンク先のファイル名(拡張子除く)、Titleにタイトルを記述して下さい。リンクが作成されます。日本語を扱う場合はこちらの書式をお勧めします。

[[WikiName]]
[[index][HOME]]

テンプレートの例

　template.txtファイルが雛形です。以下に雛形の例題を示します。

テンプレート中に $TITLE と記述するとその箇所が、タイトル部分に置き換わります。
テンプレート中に $INDEX　と記述するとその箇所が目次に置き換わります。
テンプレート中に $BODY と記述するとその箇所が本文に置き換わります。

<!doctype HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
 http://www.w3.org/TR/html4/strict.dtd">
<html lang="ja">
<head>
	<meta http-equiv="content-type" content="text/html; charset=UTF-8">
	<title>$TITLE</title>
	<link rel="stylesheet" type="text/css" href="main.css">
</head>
<body>
	<div id="container">
		<div id="header">
			<h1>$TITLE</h1>
		</div>
		<div id="menu">
		<ul>
			<li><a href="http://potto.exblog.jp/">ぽっとの陽だまり研究室</a></li>
			<li><a href="http://advenbbs.net/bbs/potto.htm">掲示板</a></li>
		</ul>
		</div>
		<div id="wrapper">
			<div id="content">$BODY</div>
		</div>
		<div id="navigation">
		$INDEX
		</div>
		<div id="extra">
		</div>
		<div id="footer">
		<p>Copyright (C) 2006-2008 potto All rights reserved. </p>
		</div>
	</div>
</body>
</html>