;
; sample.txt
;
; Copyright (C) 2001 by Hiroshi Yuki <hyuki@hyuki.com>
; http://www.hyuki.com/makeweb/
;
; This program is free software; you can redistribute it and/or
; modify it under the same terms as Perl itself.
;
-include=define.txt
-title=MakeWebのサンプル文書
-subtitle=サブタイトル
-author=著者の名前
-copyright=2001
-this=http://somewhere/document/sample.html
-home=http://somewhere/author/index.html
-mail=author@somewhere
-header

*目次

-detailcontents

*はじめに

-(
この文書は、
MakeWebのサンプルです。
--
MakeWebをインストール後、
以下のコマンドでこの文書(HTMLファイル)を作成することができます。
-)

==(
perl makeweb.pl sample.txt sample.html
==)

-(
><"sample.txt">
sample.txt
を読むと、
MakeWebの入力ファイルの書き方の基本がわかります。
--
なお、例として取り上げた文章は結城浩の
>「翻訳の部屋」
http://www.hyuki.com/trans/
からの引用です。
-)

*段落


-*通常の段落

-(
１ドル８７セント。
それで全部。
しかもそのうち６０セントは小銭でした。
小銭は一回の買い物につき一枚か二枚づつ浮かせたものです。
乾物屋や八百屋や肉屋に無理矢理まけさせたので、
しまいに、<<こんなに値切るなんて>>という無言の非難で頬が赤くなるほどでした。
デラは三回数えてみました。
でもやっぱり１ドル８７セント。
明日はクリスマスだというのに。
--
これでは、まったくのところ、粗末な小椅子に突っ伏して泣くしかありません。
ですからデラはそうしました。
そうしているうちに、
人生というものは、わあわあ泣くのと、しくしく泣くのと、微笑みとでできており、
しかも、わあわあ泣くのが大部分を占めていると思うようになりました。
--
（オー・ヘンリー作『賢者の贈り物』より）
-)

-*整形済みの段落

-(
整形済みの段落は、入力ファイルの改行や空白を生かしたい場合に使われます。
-)

--(
きらきらの おほしさま
  こんばん はじめの おほしさま
かなうかな かなうといいな
  こんばん ねがう ねがいごと
--)

-*エスケープ処理つき段落

-(
エスケープ処理つき段落は、プログラムやメールなどを文書に含めるときに使います。
この段落内では、
<|&|>は<|&amp;|>に、
<|<|>は<|&lt;|>に、
<|>|>は<|&gt;|>に、
<|"|>は<|&quot;|>に、それぞれ変換されます。
またMakeWebのコマンドも解釈されず、文字列として出力されます。
この段落は整形済みとして扱われます。
-)

---(
# "1"〜"9"を"01"〜"09"にする
if ($month < 10) {
    $month = "0$month";
}
---)

*別行立て段落

-*通常の別行立て段落

-(
別行立ての段落は、説明文の例示などに使われます。
背景色は使用するスタイルシート（ここでは<"makeweb.css">）を変更すれば自由に変えることができます。
-)

=(
１ドル８７セント。
それで全部。
しかもそのうち６０セントは小銭でした。
小銭は一回の買い物につき一枚か二枚づつ浮かせたものです。
乾物屋や八百屋や肉屋に無理矢理まけさせたので、
しまいに、<<こんなに値切るなんて>>という無言の非難で頬が赤くなるほどでした。
デラは三回数えてみました。
でもやっぱり１ドル８７セント。
明日はクリスマスだというのに。
--
これでは、まったくのところ、粗末な小椅子に突っ伏して泣くしかありません。
ですからデラはそうしました。
そうしているうちに、
人生というものは、わあわあ泣くのと、しくしく泣くのと、微笑みとでできており、
しかも、わあわあ泣くのが大部分を占めていると思うようになりました。
--
（オー・ヘンリー作『賢者の贈り物』より）
=)

-*整形済みの別行立て段落

-(
別行立て段落にも整形済みのものがあります。
-)

==(
きらきらの おほしさま
  こんばん はじめの おほしさま
かなうかな かなうといいな
  こんばん ねがう ねがいごと
==)

-*エスケープ処理つき別行立て段落

-(
別行立て段落にも、エスケープ処理つきのものがあります。
この段落は整形済みとして扱われます。
-)

===(
# "1"〜"9"を"01"〜"09"にする
if ($month < 10) {
    $month = "0$month";
}
===)

*箇条書き

-*番号なしの箇条書き

-[
- わあわあ泣く
- しくしく泣く
- 微笑む
-]

-*番号つきの箇条書き

-<
- わあわあ泣く
- しくしく泣く
- 微笑む
->

-*リンクになった箇条書き

-[
>- Google
http://www.google.com/
>- Yahoo!
http://www.yahoo.com/
>- Yahoo!JAPAN
http://www.yahoo.co.jp/
-]

-*階層をもった箇条書き

-<
- ロボット型

-[
>- Google
http://www.google.com/
-]

- 登録型

-[
>- Yahoo!
http://www.yahoo.com/
>- Yahoo!JAPAN
http://www.yahoo.co.jp/
-]

- メタサーチ型

-[
>- WAKANO
http://www.wakano.co.jp/
- 他にもあるかな
-]

->

*リンク

-*段落中のリンク

-(
検索するときには、
>Google
http://www.google.com/
を使っていますか、
それとも
>Yahoo!
http://www.yahoo.com/
を使っていますか。
-)

-*箇条書き中のリンク

-[
>- Google
http://www.google.com/
>- Yahoo!
http://www.yahoo.com/
-]

*用語の解説

=[
= Perl
プログラミング言語の一種。
モットーは、There's More Than One Way To Do It.
= Java
プログラミング言語の一種。
モットーは、Write Once, Run Anywhere.
= HTML
マークアップ言語の一種。
= MakeWeb
テキストファイルをHTMLファイルに変換するPerlスクリプト。
=]

-footer