![[ファイルの関係図]](process.jpg "makeweb.plはsample.txtとdefine.txtを元に、sample.htmlを作る。")
MakeWebやこのマニュアルに関するご意見は 結城浩 yoshid50@sk.tsukuba.ac.jp までお送りください。 このHTMLファイルを作成したのは Mon Jul 16 03:22:36 2007です。
筑波大学第三学群社会工学類の経営工学専攻です。
などに興味をもっています。 さらに詳しいプロフィールは iddyを御覧ください。
MakeWebには、HTMLのタグに変換されるコマンドがあります。
短くて書きやすいMakeWebのコマンドを使って、 面倒なHTMLタグを書かずにHTMLファイルを生成することができます。
MakeWebの-includeコマンドを使うと、 C言語の#includeのように、ファイル中に別ファイルを挿入することができます。
この機能を使うと、共通のヘッダ、フッタ、メニューバーなどを持たせるのが容易になります。 また別ファイルに自分のアドレスや住所、著作権表記などを用意してインクルードすれば、 ページ記述の手間を省くことができます。
MakeWebはセミコロン(;)で始まる行はコメントとして扱われ、 その内容はHTMLファイルには出力されません。
ユーザは自分で新たなコマンドを作成することができます。
複雑なURLをあちこちのHTMLファイルに直接埋め込むと、 後の変更が困難になる上、入力ミスやコピーミスが生じる恐れがあります。 そのURL置換されるコマンドを MakeWeb の入力ファイル上に定義しておけば、 埋め込む場所は一個所で済むようになります。
MakeWebは、結城浩の「MakeWebのページ」から無料でダウンロードすることができます。
以下にファイル一覧を示します。
makeweb.pl MakeWeb本体
define.txt 定義ファイル
makeweb.txt ユ・踉札供�踉札坤泪縫絅�髟阡札�即浴諷怛發瞭�力ファイル)
makeweb.html ユ・踉札供�踉札坤泪縫絅�髟阡札�即挽楊�
鞳鳰 轣諷�繧�韭 轣諷�繧���轣諷�繧�蔗迪
とするとmakeweb.htmlができる
sample.txt サンプル(MakeWebの入力ファイル)
sample.html サンプル(HTML)
perl makeweb.pl sample.txt sample.html
とするとsample.htmlができる
quickref.txt クイックリファレンス(perldoc)
perldoc makeweb.pl > quickref.txt
とするとquickref.txtができる
process.jpg ファイルの関係図
makeweb.css スタイルシ・踉札��
轣諷肅跂 メイクファイル例
上記のうち、実行に最低限必要なファイルは makeweb.pl のみです。 ただし実際には、ゼロから入力ファイルを作るのは難しいので、 sample.txt, makeweb.txt, define.txtなどを 自分用に修正して使うのがよいでしょう。
MakeWebは以下の環境で動作確認しました。
MakeWebのインストールは以下の手順で行います。
makeweb.batを作る
makeweb.batを環境変数PATHの通っているところに移動する。
MakeWeb用のディレクトリ中のファイルをすべて削除してください。
MakeWebは以下のように起動します。
perl makeweb.pl input.txt output.html
ここでinput.txtはMakeWebの入力ファイルであり、
output.htmlは出力ファイル(HTML)です。
sample.txtとsample.htmlファイル同梱のファイル
sample.txtは、入力ファイルのサンプルです。
MakeWebにこのファイルを与えると、
sample.htmlが作られます。
Webブラウザやテキストエディタを使ってこの2つのファイルを比較すると、
MakeWebがどんなことをやっているのかがわかります。
また、sample.txtを変更してからsample.htmlを作り直してみるのもよいでしょう。
sample.txtはdefine.txtファイルを利用しています。
これらのファイルは自由に変更してお試し下さい。
sample.htmlの作り方以下のように入力すると、
sample.txtからsample.htmlを作ることができます。
perl makeweb.pl sample.txt sample.html
以下に、sample.htmlを表示するための、ファイルの関係図を示します。
サンプルファイルsample.txtを読めば、
主なコマンドの使い方はわかるようになっていますが、
ここでは主なコマンドの使い方を紹介します。
全てのコマンドは、
quickref.txt参照してください。
MakeWebは入力ファイルを一行ごとに処理していきます。 ここでいう一行とは、画面上の物理的な一行ではなく、 改行までの論理的な一行です。
MakeWebのコマンドは、通常行の先頭から開始します。
行頭にセミコロン(;)がある行は無視されます。 例えば、以下のように書くと「;コメントです」の部分は出力されません。
;コメントです
行頭に不等号(>)がある行はリンクを表します。 その次の行にURLを書きます。例えば、
>私のホ・踉札爛據�踉札� http://www.hyuki.com/
と記述した場合、
私のホームページ
というリンクになります。
行頭にアスタリスク(*)がある行はセクションのタイトルになります。 セクションのタイトルは、コマンド-contentsを使ってまとめることができます。 また、セクションの終わりには、そのページの先頭へのリンクが自動的に挿入されます。 以下のように書きます。-contentsはどこにあってもかまいません。
-contents *セクション1 *セクション2 *セクション3
例えば、このマニュアルの 目次は、-contentsコマンドを使って作っています。
行頭にマイナスとアスタリスク(-*)がある行はサブセクションのタイトルになります。 サブセクションのタイトルは、コマンド-detailcontentsを使ってまとめることができます。 以下のように書きます。-detailcontentsはどこにあってもかまいません。
-detailcontents *セクション1 -*セクション1.1 *セクション2 -*セクション2.1 -*セクション2.2 *セクション3 -*セクション3.1 -*セクション3.2 -*セクション3.3
例えば、このマニュアルの 詳細目次は、-detailcontentsコマンドを使って作っています。
以下のように書くと番号なしの箇条書きになります。
-[ - 箇�苳賜書え� 箇�苳賜書え� 箇�苳賜書え� �� 鹿頏緇 寂蝟 竚癈鷭≫蜩韭癨⊂ 受貍殊蘊 箇条書き
以下のように書くと番号つきの箇条書きになります。
-< - 箇�苳賜書え� 箇�苳賜書え� 箇�苳賜書え� ��苳鹿頏緇 寂蝟 竚癈鷭≫蜩韭癨⊂ 種貍殊蘊 箇条書き
行頭に感嘆符(!)がある行は強調になります。例えば、
ここで !強調 をしたいです。
ここで 強調 をしたいです。
行頭に縦棒(|)がある行は、特殊な置換を行いません。 コマンドそのものを記述したいときに用います。
|--(
次のようにすると新しいコマンド-mymailを定義します。
-mymail=hyuki@hyuki.com
この定義を行っただけでは何も出力されません。 この定義以降、-mymailを使うと、定義の内容が展開されます。
-mymail=hyuki@hyuki.com ... 私のメ・踉札襯�髟阡札疋譽垢蓮�髟阡�� �逋轣蕕任后�<-mymail>う髟阡擦討縫瓠�踉札襪�ださいね。
... 私のメールアドレスは、 hyuki@hyuki.com です。hyuki@hyuki.comあてにメールくださいね。
ここでは2個所に展開されています。 行の途中で展開させたいときには、 <-mymail> というコマンドを使います。
複数行にわたるコマンドを定義する場合には、次のように書きます。
-begin=download -( MakeWebをダウ瘢雹ンロ・踉札匹靴燭い箸�には・髟阡� >MakeWeb Home Page http://www.hyuki.com/makeweb/ からどう瘢雹う苳察�� �� �緕篏粹�鉤閨鹿頏緇 腫ぢここでは、-downloadコマンドを定義しています。-download以下のように展開されます。
MakeWebをダウンロードしたいときには、 MakeWeb Home Pageからどうぞ。
ファイルの挿入
別のファイルの内容を挿入します。 以下のようにするとファイルdefine.txtを挿入します。
-include=define.txtエラーメッセージ
MakeWebは何らかの誤りを見つけるとエラーメッセージを出力して終了します。
例えば、以下のような入力があったとします。 -( ... -)の対応関係がおかしくなっています。
-( こんにちは。 -(このとき、MakeWebは次のようなエラーメッセージを出力して終了します。
makeweb.txt(3):Missing -).これは入力ファイル
makeweb.txtの3行目を処理している最中に、 -)が不足していることを検出したという意味です。利用のコツ
pl2batコマンド
makeweb.plからmakeweb.batを作っておくとよい。
makeweb.css, define.txt, sample.txtをコピーして、それを修正してページデザインしてみるとよい。
makeweb.cssを修正する。
define.txtを修正する。
define.txtに-yourcommand=contentの形式を追加して<-yourcommand>を使う。
define.txtに-begin=yourcommand ... -end=yourcommandの形式を追加して、<-yourcommand>を使う。
makeweb.plを書き換えて、自分のコマンドを作る。
define.txtに入れる。
MakeWebのすべての組み込みコマンドは対応するフックコマンド(hook command)を持っています。 これは、組み込みコマンドの振る舞いをユーザが簡単に変更できるようにするための仕組みです。 例えば、以下では組み込みコマンド-( ... -)が使われています。
-( こんにちは。 -)
MakeWebは、上記の内容を、フックコマンドを使っていったん次のように変換します。
<-pbegin> こんにちは。 <-pend>
ここで、 組み込みコマンド-(にはフックコマンド-pbeginが対応し、 組み込みコマンド-)にはフックコマンド-pendが対応しています。
この後、MakeWebは通常のコマンド展開と同じ処理によって、 次のように変換します。
<p> こんにちは。 </p>
ですから、 フックコマンド-pbeginと-pendを自分の入力ファイルや定義ファイル中で別定義してしまえば、 組み込みコマンド-( ... -)の振る舞いを変えることができます。
組み込みコマンドとフックコマンドの対応についてはmakeweb.pl内部を参照してください。
たくさんの機能がなくなっていますが、 これらの多くはスタイルシートを活用したよりスマートな解決方法を現在検討中です。
MakeWebに関するバグ報告・要望・意見などは大歓迎します。 yoshid50@sk.tsukuba.ac.jpへお送りください。
このプログラムはフリーソフトです。 Perl自身と同じ条件で、再配布・修正可能です。
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
MakeWebのユーザに感謝します。 発表以来、数多くのユーザから献身的なテストとレポートをいただきました。 ここに深く感謝します。