;; ------------------------------------------------------------ ;; hnf command guide ;; 2004.06.19 ; コマンド、文法、簡易説明、詳細説明、の順で記述。 ; 行頭の文字で、内容を分けられます。 ; ; コメント行 ; > サブメニュー開始 ; < サブメニュー終了 ; @> 解説記事開始 ; @< 解説記事終了 ;; ------------------------------------------------------------ >記事タイトルコマンド NEW NEW 1行の文章 記事タイトル セクションのタイトルを記述します。タイトル行は，リンク可能なように自動的にアンカー(a name) が定義されます。アンカー は上から順に数字が増えていきますので， NEW と NEW の間に新しいセクションを追加してはいけません。 NEW と NEW の間に新しいセクションを追加するとどこかのページから リンクされている場合，リンク先がずれてしまいます。 NEW は必須のコマンドです。必ず記述してください。 LNEW LNEW url 1行の文章 記事タイトル(リンクつき) NEW と同様セクションのタイトルを指定しますが，url へリンクが 張られます。例: LNEW http://www.h14m.org/ ハイパー日記システム RLNEW RLNEW 引数1 引数2 1行の文章 記事タイトル(置換有リンクつき) NEWコマンド同様、新しいセクションのタイトルを 記述しますが、同時にRLINKコマンド同様にリンクを指定します。 CAT CAT カテゴリ1 [カテゴリ2 ...] カテゴリ分類 セクションのカテゴリ(分類)を記述します。日記の内容を， カテゴリで分類したい場合に使用します。使用しなくても構いません。 CATコマンドは NEW, LNEW または RLNEW の直前にのみ指定できます。 タイトル行にカテゴリ別のアイコンを表示させることも可能です。 詳細は，日記のカテゴリ分類の方法をご覧下さい。 例: CAT lynx install GRP GRP グループ1 [グループ2 ...] ひみつ記事 ひみつ交換日記機能を利用します。 GRPコマンドはそのセクションに CAT がある場合は、CAT の直前に、CAT がない場合は、NEW, LNEW または RLNEW の直前にのみ指定できます。 詳細は，ひみつ交換日記機能をご覧下さい。例: GRP ruri shinomu < >サブ記事タイトルコマンド SUB SUB 1行の文章 サブ記事タイトル セクション内のサブ・セクションのタイトルを記述します。サブ・セクションもリンク可能なように自動的にアンカー(a name) が定義されます。SUB と SUB の間に新しいサブ・セクションを 追加してはいけません。理由は NEW と同じです。 LSUB LSUB url 1行の文章 サブ記事タイトル(リンクつき) SUB と同様サブ・セクションのタイトルを指定しますが，url へリンクが張られます。例: LSUB http://www.h14m.org/ ハイパー日記システム RLSUB RLSUB 引数1 引数2 1行の文章 サブ記事タイトル(置換有リンクつき) SUBコマンド同様、新しいサブ・セクションのタイトルを 記述しますが、同時にRLINKコマンド同様にリンクを指定します。 < >リンク・コマンド LINK LINK url 説明文章 リンク リンクを張ります。 例は，「 ハイパー日記システム 」と表示されます。例: LINK http://www.h14m.org/ ハイパー日記システム URL URL url 説明文章 リンク(URL表記つき) URL を記述しリンクを張ります。例では「 ハイパー日記システム(http://www.h14m.org/) 」と表示されます。URL を明示したい場合に使用します。例: URL http://www.h14m.org/ ハイパー日記システム RLINK RLINK 引数1 引数2 説明文章 リンク(置換有) 「説明文章」としてリンクされる点は，LINKコマンド と同様ですが， ~/diary/conf/rlink.txt で定義した URL に最初の 引数1 が置き換えられます。 よくリンクする URL を設定し日記の記述を省略するために用意されました。定義ファイルrlink.txt は 『定義文字列[スペース]URL』と記述します。例えば，「hoge http://www.example.ne.jp/~hoge/diary/」のように記述します。 この場合，上記のコマンド例は， http://www.example.ne.jp/~hoge/diary/?19981201 へのリンクを張ります。例: RLINK hoge ?19981201 説明文章 < >段落コマンド P P 段落開始 タグ

を表示します。段落を分けます。Pコマンドは、/Pコマンドで閉じる必要があります。 /P /P 段落終了 Pコマンドを閉じます。タグ

を表示します。 < >装飾コマンド FONT FONT 引数1 引数2 文章 フォント属性指定 タグ を表示します。上記例では，「赤い文字」と表示されます。例: FONT COLOR red 赤い文字 STRIKE STRIKE 文章 打ち消し線 タグ を表示します。 「文章」と表示されます。 LSTRIKE LSTRIKE url 文章 打ち消し線(リンクつき) STRIKEコマンドと同様 タグ を表示しますが，同時に リンクを張ります。例: LSTRIKE http://www.h14m.org/ ルリ少佐万歳 STRONG STONG 文章 強調 タグ を表示します。例は， 「ルリ少佐万歳」と表示されます。例: STRONG ルリ少佐万歳 SPAN SPAN class_name 文章 汎用的なインライン要素 タグ を表示します。 class は CSS で事前に定義しておく必要があります。 DIV DIV class_name ブロック要素開始 タグ
を表示します。 class は CSS で事前に定義しておく必要があります。 DIV は /DIV で閉じる必要があります。 /DIV /DIV ブロック要素終了 タグ
を表示します。 < >画像コマンド IMG IMG {r|l|n} ファイル名 説明文字列 画像表示 タグ を表示します。r は画像を右に，l は画像を左に表示します。1.03-pl1 からは n も指定可能に なりました。n を指定すると align を付けません。説明文字列は画像の説明を 記述します。なお、画像の表示サイズは、ImgWidthMaxSize により自動的に調整されます。例: IMG l pic1.gif ルリの写真 LIMG LIMG url {r|l|n} ファイル名 説明文字列 画像表示(リンクつき) タグ を表示しリンクを張ります。r は画像を右に，l は画像を左に表示します。 n を指定すると align を付けません。説明文字列は画像の説明を 記述します。例: LIMG http://www.h14m.org/ l pic1.gif ルリの写真 MARK MARK 引数 定義アイコン表示 あらかじめ定義されたアイコンを表示します。 引数もあらかじめ定義されたものを指定します。 MARK は テーマ により定義されています。また，自分で定義することも可能です。 アイコンを指定する引数については，互換性を確保する観点から， ハイパー日記システム・プロジェクトで 標準マークを定めて公開します。例: MARK !! < >箇条書コマンド UL UL 順序無しリスト開始 タグ
    を表示します。UL の後には，LIコマンドが必要です。また，/UL で ULコマンドを 閉じる必要があります。 /UL /UL 順序無しリスト終了 タグ
を表示します。 OL OL 順序付きリスト開始 タグ
    を表示します。OL の後には，LIコマンドが必要です。また，/OL で OLコマンドを 閉じる必要があります。 /OL /OL 順序付きリスト終了 タグ
を表示します。 LI LI 文章 リスト項目 タグ
  • を表示します。LI を書く前に ULまたはOLコマンドが必要です。 DL DL 定義リスト開始 タグ
    を表示します。 DT DT 定義語 文章 タグ
    を表示します。DT を書く前に DLコマンドが必要です。 DD DD 定義の説明 文章 タグ
    を表示します。DD を書く前に DLコマンドが必要です。 /DL /DL 定義リスト終了 タグ
    を表示します。 < >引用系コマンド PRE PRE 整形済みテキスト開始 タグ
     を表示します。PRE は /PRE で閉じる必要があります。
/PRE	/PRE	整形済みテキスト終了	タグ
    を表示します。 CITE CITE 引用開始 タグ
    を表示します。引用を記述する場合に使います。 /CITEコマンドで閉じる必要があります。 /CITE /CITE 印象終了 タグ
    を表示します。 < >コメント系コマンド ! ! 一行の文章 コメント(HTMLソースに含む) HTMLでのコメント を表示します。つまり通常ブラウザでは表示されません。ただし HTMLソースを 読むと見ることができます。 Namazu for hns では検索可能です。 !# !# 一行の文章 コメント(HTMLソースに含まない) なにも表示されません。HTMLソースにも表示されません。 ただし，Namazu for hns では検索可能です。 FN FN 脚注開始 脚注を記載します。FNコマンドは引数をとりません。 脚注の内容は，次の行以降に記載して下さい。 /FNコマンドで閉じる必要があります。 FN 〜 /FN内には LINK, STRIKE, ~コマンド のみが使用可能です。脚注は各セクションの末尾に表示されます。 /FN /FN 脚注終了 FNコマンドを閉じます。 < >置換コマンド ALIAS ALIAS 引数 文字列置換 ~/diary/conf/alias.txt で定義した 文字列に 引数 が置き換えられます。 よくリンクする URLなど を設定し日記の記述を省略するために用意されました。定義ファイルalias.txt は， 「引数[スペース]置き換えたい文字列」と記述します。 例えば， 「hns ハイパー日記システム」のように記述します。 この場合，上記のコマンド例は， 「ハイパー日記システム」と変換されます。例: ALIAS hns < >テーブル系コマンド RT RT テーブル開始 RT方式 によるテーブル表示を行います。 RTコマンドは引数をとりません。 RT方式によるテーブル記述内容は，次の行以降に記述して下さい。 /RTコマンドで閉じる必要があります。 /RT /RT テーブル終了 RTコマンドを閉じます。 < >その他コマンド ~ ~ 改行 タグ
    を表示します。改行されます。このコマンドは， 文末にあったときのみコマンドして認識されます。 < ;; ------------------------------------------------------------ ;; 以下、解説記事。そのまま表示されます。 @>リンク拡張・解説 LNEW, LSUB, LINK, URL, LSTRIKE で指定する url が特定の書式の場合、以下のように変換されます。 #YYYYMMDD[x[Sy]] 自分の日記へのリンクに変換されます。 デフォルトでは 動的生成時は "$MyDiaryURI?YYYYMM[abc]#YYYYMMDDxSy" へのリンクに、 静的生成時は "./YYYYMM.html#YYYYMMDDxSy" へのリンクになります。 例: LINK #200104011 4月1日の第1セクション 動的生成では 4月1日の第1セクション と変換されます。 静的生成では 4月1日の第1セクション と変換されます。 #{YYYY,MM,DD[,x[,y]]} 自分の日記へのリンクに変換されます。#YYYYMMDDxSy と同様です。 #{any-string#YYYYMMDD[x[Sy]]} 自分の日記へのリンクに変換されます。 "#YYYYMMDDxSy" 以前は任意の文字列です。 例: LINK #{http://www.example.ne.jp/~hoge/diary/200104a?to=20010401#200104011} 4月1日の第1セクション "#200104011" と同様に変換されます。 ISBN:1-2345-6789-0 オンライン書店で ISBN コードを検索します。 CD:ABCD-1234 オンライン CD ショップ で CD 品番を検索します。 hns-dev:1 hns開発MLの 任意の番号のアーカイブを表示します。 hns-users:1 hnsサポートMLの 任意の番号のアーカイブを表示します。 @< ;; ------------------------------------------------------------ @>RTテーブル拡張・解説 RT方式: RT方式とは、rubikitch氏制作の RTtool で使用されている作表フォーマットです。 簡潔な書式で複雑な表も楽に記述可能です。 基本形: RT〜/RTで囲まれた領域に RT方式の記述 があった場合、テーブルに変換します。 RT 1,2,3 4,5,6 7,8,9 /RT タイトル設定・デリミタ変更・ヘッダ表示: 制御コマンドを記述することで、タイトル設定・デリミタの変更が 可能です。 制御コマンドと表の記述部の間には、空行を１行入れる必要があります。 captionコマンドで表のタイトルを設定できます。 delimiterコマンドでデリミタの変更を行うことが出来ます。 デフォルトのデリミタは","かTABです。 表の記述の途中に空行がある場合、それより上の部分をヘッダと見なします。 ヘッダ部分は HTML における THEAD 要素となり、TH タグで強調表示されます。 RT # コメント記述 caption = タイトル delimiter = : AAA : BBB : CCC 1 : 2 : 3 4 : 5 : 6 /RT 複雑な表の記述: スパン記号("||","==")で複雑な表も簡単に記述できます。 "||"記号でその場所のセルを上のセルと結合、 "=="記号で左のセルと結合します。 RT caption = ちょっと複雑な表 delimiter = : A : B : C : == : D : E 1 : 2 : 3 : 4 : 5 : 6 7 : == : || : 8 : == : 9 10 : 11 : 12 : || : == : 13 /RT 表の装飾: 表を構成する各ブロック(下図参照)に対して、表示属性を指定可能です。 なお、TBODY見出し部 は、tindex_span の指定が無い場合には出力されません。 TABLE全体(table_foo) THEAD部(thead_foo) TBODY部[見出し](tindex_foo) TBODY部[本体](tbody_foo) 使用できるコマンドは以下のとおりです。 TABLE全体 caption 表の題名 delimiter デリミタ table_class スタイルシート指定 table_border 枠線の幅(ピクセル) table_width テーブルの幅(ピクセルまたは%) table_height テーブルの高さ(ピクセルまたは%) table_frame 外枠の表示方法 (void,above,below,hsides,vsides,lhs,rhs,box,border) table_rules 内側罫線の表示方法 (none,groups,rows,cols,all) THEAD部 thead_class スタイルシート指定 thead_bgcolor BGCOLOR 指定 TBODY部 見出し tindex_span 見出しとしてグループ化する列数(def=0) tindex_class スタイルシート指定 tindex_bgcolor BGCOLOR 指定 tindex_width セルの幅(ピクセル) tindex_align セル配置(left,center,right) TBODY部 本体 tbody_bgcolor BGCOLOR 指定 tbody_class スタイルシート指定 tbody_width セルの幅(ピクセル) tbody_align セル配置(left,center,right) RT 記述例: RT caption = RT拡張コマンド delimiter = : tbody_bgcolor = white table_border = 2 tindex_span = 3 コマンド : == : == : 機能 TABLE全体: == : caption : 表の題名 || : == : delimiter : デリミタ || : == : table_class : スタイルシート指定 || : == : table_border : 枠線の幅(ピクセル) || : == : table_width : テーブルの幅(ピクセルまたは%) || : == : table_height : テーブルの高さ(ピクセルまたは%) || : == : table_frame : 外枠の表示方法 (void,above,below,hsides,vsides,lhs,rhs,box,border) || : == : table_rules : 内側罫線の表示方法 (none,groups,rows,cols,all) THEAD部 : == : thead_class : スタイルシート指定 || : == : thead_bgcolor : BGCOLOR 指定 TBODY部 :見出し: tindex_span : 見出しとしてグループ化する列数(def=0) || : || : tindex_class : スタイルシート指定 || : || : tindex_bgcolor: BGCOLOR 指定 || : || : tindex_width : セルの幅(ピクセル) || : || : tindex_align : セル配置(left,center,right) || : 本体 : tbody_bgcolor : BGCOLOR 指定 || : || : tbody_class : スタイルシート指定 || : || : tbody_width : セルの幅(ピクセル) || : || : tbody_align : セル配置(left,center,right) /RT @<