RvtlWiki ver.2.02 (2017/06/11)
RvtlWikiは結城 浩 氏が公開されている YukiWiki (https://www.hyuki.com)の機能と文法を参考に rvtl というTinyBasic系の言語で作成した Wiki Engineの一種です。
ダウンロード
rvtlwiki_2.02.tar.gz (231KB) は文字コードがUTF-8のrvtl 用と64ビットの rvtl64 用、32ビットで文字コードがEUC用の3種類が含まれます。
自作のプログラムのうちで、RvtlWiki は10年以上にわたって最も活躍しています。
RvtlWiki 2.02 の変更点
rvtlwiki.cgi の追記機能で method の前のシングルクォートが抜けていた。
14250 "<form action='" $*=Z "' method='post' >" / "<fieldset>"
RvtlWiki 2.00 から2.01 の変更点
rvtlwiki.cgi
20950 "<a href='" $*=Z "?DispPage&page=" ?=F[i*4+1] "&UpdateTime=" ?=F[i*4+0] "'>"
render.cgi
12460 ^_jp_header 12470 ;=(L(1)=$98)&(L(2)=$85) M='C' C=1 c=3 #=^_endAnalyze : BLACK STAR 12480 ;=(L(1)=$96)&(L(2)=$A0) M='C' C=2 c=3 #=^_endAnalyze : BLACK SQUARE 12490 ;=(L(1)=$97)&(L(2)=$8F) M='C' C=3 c=3 #=^_endAnalyze : BLACK CIRCLE 12500 ;=(L(1)=$97)&(L(2)=$86) M='C' C=4 c=3 #=^_endAnalyze : BLACK DIAMOND 12510 ;=(L(1)=$96)&(L(2)=$B2) M='C' C=5 c=3 #=^_endAnalyze : BLACK UP-POINTING TRIANGLE 12520 ;=(L(1)=$98)&(L(2)=$86) M='C' C=6 c=3 #=^_endAnalyze : WHITE STAR
- 見出し文字列の指定に、行頭に以下の日本語記号も使用可能
- ★ <h2>
- ■ <h3>
- ● <h4>
- ◆ <h5>
- ▲ <h6>
RvtlWiki 1.05 から 2.00
- 出力タグを HTML5対応に修正
- rvtl コードと html データの文字コードを utf-8 に変更
- 見出し文字列の指定に、行頭に以下の日本語記号も使用可能
- 空行 2行で改行を挿入します。
- シングルクォートを使った文字属性の指定が増えました。
- 行頭から3文字以上の空白がある場合は整形済み(pre)となります。
YukiWikiとの違い
- ページタイトルの変更ができます。
- ページをグループに分類することができます。
- 強制改行「<br>」が 「--.」で挿入できます。
- テーブルの rowspan が可能です。
- 文字飾りは2種類ですが、スタイルシートで形式を変更できます。
- 見出しは4段階あります。
- 整形済みのフォーマット指定は4種類あります。
- 画像挿入の指定方法が異なります。
- 行頭はスペースでも整形済み(<pre>)になりません。
- > による引用文はありません。
- Wikiのページ名へのリンクは[[ページ名]]ではかけません。
- 大文字小文字を混ぜた英文字列はWikiのページ名としてリンクになりません。
- テーブル中にコンマ(,)を書くことはできません。
- コメントフォームは設置できません。
- ページ差分をとることはできません。
- 検索機能がありません。
バージョンアップ手順
RvtlWiki 2.02 は文字コードが UTF-8 になっています。文字コードが EUC の RvtlWiki 1.0x からバージョンアップする場合は rvtlwiki_euc 以下を使って下さい。 以下のファイルを上書きコピーしてください。
- rvtlwiki.cgi と render.cgi
- data ディレクトリのrvtlwiki.css と rvtlwiki.dat
pages ディレクトリは変更する必要はありません。 バージョンアップ後はページを編集して保存しないと変更は反映されません。
インストール手順
RvtlWiki(rvt) を動作させるためには rvtl または rvtl64 が必要です。 rvtl を /usr/bin/にコピーしてください。
apache もインストールする必要があります。
また rvtl を rvtlw というファイル名で /usr/bin/ 以下にシンボリックリンク を作成するか、
cd /usr/bin sudo ln -s rvtl rvtlw
または rvtl を rvtlw というファイル名でコピーしてください。rvtl は小さいのでコピーでもジャマにはなりません。
cd /usr/bin cp rvtl rvtlw
RvtlWikiは複数のファイルで構成されています。rvtlwiki.cgiには実行可能 属性(755)、pages ディレクトリ以下のファイル読み書き可能(666)、その他は 読みだし可能(644)である必要があります。
httpサーバの実行ユーザが apache、www-data や nobody 等のユーザとなって いて、suEXEC の設定になっていない場合は、pages ディレクトリの権限は 777 (読み書き検索可)、その下にある pages.txt、groups.txt の権限は 666 (読み書き可) としてください。
cd rvtlwiki chmod 755 data chmod 644 data/* chmod 777 pages chmod 777 pages/*.txt
--+-- rvtlwiki.cgi RvtlWiki の本体CGI | +-- render.cgi テキストからHTMLへのレンダリングCGI | +-- .htaccess Apache用の設定ファイル | +-- readme.txt このファイル。実行には不要です。 | +-- data -+-- rvtlwiki.png RvtlWiki のロゴ | | | +-- rvtlwiki.dat Wikiの使用法の表示データ | | | +-- rvtlwiki.css RvtlWiki のスタイルシート | | | +-- frontpage.dat 表紙の表示データ | +--pages -+-- pages.txt ページ管理用ファイル | +-- groups.txt グループ管理用ファイル : +-- 各Wikiページのファイル :
- (1) 変更の必要はありませんが、必要ならrvtlwiki.cgiのはじめの方にある、U['W']、U['H']などの値を修正して下さい。
10180 :------------------------------------------------------------- 10190 : ユーザ設定 10200 :------------------------------------------------------------- 10210 u=U : 変更不可 10220 u*="./data/" : dataディレクトリのパス名 U[0] 10230 u=U+64 : 変更不可 10240 u*="./pages/" : pagesディレクトリのパス名 U[16] 10250 u=U+128 : 変更不可 10260 u*="https://www.example.com/rvtlwiki/": URL U[32] 10270 u=U+768 : 変更不可 10280 u*="RvtlWiki" : フロントページのタイトル 10290 u=U+512 : 変更不可 10300 u*="RvtlWiki New" : RSSタイトル 10310 u=U+640 : 変更不可 10320 u*="RvtlWiki RSS" : RSS description 10330 U['N']=256*1024 : 最大ページサイズ 10340 U['W']=80 : 編集領域の桁数 10350 U['H']=30 : 編集領域の行数 10360 U['R']=40 : 更新履歴表示件数
また、最大ページサイズを変更した場合は render.cgi の以下の部分も変更します。
10100 :------------------------------------------------------------ 10110 M=256 : 最大ページサイズ(KB)
- (2) dataディレクトリ中のfrontpage.datはhtml形式のファイルです。 必要に応じて書き換えてください。本文部分(<body></body>の内側)のみ を書きます。
- (3)ファイル一覧にあるファイルをサーバに転送します。転送モードやパーミッション を環境にあわせ適切に設定して下さい。
- (4) ブラウザでサーバ上の rvtlwiki.cgi の URL にアクセスします。
- (5) メニューの「新規ページ分類」からページ分類名を設定します。
- (6) メニューの「新規ページ」から新しいページを作成します。
ライセンス
このソフトはフリーソフトウェアです. GNU General Pulic Licenceにしたがって 自由に使用,配布,改変して頂いてかまいません。
著作権は 水谷 純<[email protected]> https://www.mztn.org/と 森竹 俊夫 Toshio Moritake <[email protected]> https://www.odin.hyork.net/ が保有しています。 本ソフトウェアによって生じた損害について著作者は責任を負いません。 また、著作者はバージョンアップの義務を負いません。
テキスト整形の基本ルール
基本的に入力した文字はそのまま出力されます。
- 連続した複数行は連結され、改行されません。
- 空行は段落の区切りとなります。
- 空行2行で改行 (<br />) が挿入されます。
- HTMLのタグは単なる文字列(そのまま表示)となります。
以下のルールでテキストを入力すると色々な形式で表示することができます。
見出し
- 行頭に * (アスタリスク)を書くと、続く文字列は大見出しになります。
- 行頭に ** を書くと、続く文字列は中見出しになります。
- 行頭に *** を書くと、続く文字列は小見出しになります。
- 行頭に **** を書くと、続く文字列は最小見出しになります。
- 見出しがあると自動的に目次が作られます。
- 見出し文字列の指定に、行頭に以下の日本語記号も使用可能
- ★ <h2>
- ■ <h3>
- ● <h4>
- ◆ <h5>
- ▲ <h6>
箇条書き、水平線、引用文
- マイナス(-)を行頭に書くと、箇条書きになります。- -- --- の3レベルがあります。
- マイナス4個(----)を行頭に書くと、水平線になります。
強制改行
- 行頭を --. にすると改行 (<br>)が挿入されます。
画像挿入
以下の形式で画像ファイルを指定します。
[[[テキスト|URL]]]
テーブル
- ピリオド(.)を行頭に書くと、テーブル(表)のタイトル行になります。
- コンマ(,)を行頭に書くと、テーブル(表)が作成できます。
- セルの中に等号を2つ(==)入れると、左隣のセルに連結(colspan)します。
- 列方向の連結(rowspan)は || のように文頭に「|」の数で連結数を指定します。
- セルの左右に空白を入れると左右、中央揃えができます。
.タイトル行,左揃え,右揃え,中央揃え,||縦連結 ,セル,1, 2, 3 ,セル,1, 2, 3 ,|| 4 ,横連結,1,==,==
タイトル行 | 左揃え | 右揃え | 中央揃え | 縦連結 |
---|---|---|---|---|
セル | 1 | 2 | 3 | |
セル | 1 | 2 | 3 | 4 |
横連結 | 1 |
整形済み領域
- 行頭から3文字以上の空白がある場合は整形済み(pre)となります。
- --( と --) で囲まれた行は書いたまま表示されますが、リンクや文字飾りは有効です。
- ---( と ---) で囲まれた行はリンクや文字飾りも書いたまま表示されます。
- ----( と ----) で囲まれた行は書いたまま表示されますが、リンクや文字飾りは有効です。
- -----( と -----) で囲まれた行は書いたまま表示されますが、リンクや文字飾りは有効です。
- スタイルシートで表示形式を変更できます。
行頭で空白3つ以上で整形済み領域 空白を4つ Four spaces at the beginning of line. 8 spaces at the beginning of line.
ハイパーリンク
- https://www.mztn.org/のようなURLは自動的にリンクになります。URLの終わりが空白か行末であることが必要です。
[[テキスト|URL]] の形式も可能です。
文字飾り
- シングルクォート2個ではさんだ部分は、ボールドになります。
- シングルクォート3個ではさんだ部分は、赤ボールドになります。
- スタイルシートで表示形式を変更できます。
- シングルクォート2個+文字+シングルクォートとシングルクォート4個ではさんで、次の例のように文字の属性を変更できます。
--( ''黒ボールド'' '''赤ボールド''' ''b'青'''' ''g'グリーン'''' ''c'シアン'''' ''r'赤'''' ''m'マジェンタ'''' ''y'黄色'''' ''w'白'''' ''0'黒ボールド'''' ''1'青ボールド'''' ''2'グリーンボールド'''' ''3'シアンボールド'''' ''4'赤ボールド'''' ''5'マジェンタボールド'''' ''6'黄色ボールド'''' ''7'白ボールド'''' ''L'黒反転'''' ''B'青反転'''' ''G'グリーン反転'''' ''C'シアン反転'''' ''R'赤反転'''' ''M'マジェンタ反転'''' ''Y'黄色反転'''' ''W'白反転'''' https://www.mztn.org/ [[Jun's Homepage|https://www.mztn.org/]] [[[logo|./rvtlwiki.png]]] --)
黒ボールド 赤ボールド 青 グリーン シアン 赤 マジェンタ 黄色 白 黒ボールド 青ボールド グリーンボールド シアンボールド 赤ボールド マジェンタボールド 黄色ボールド 白ボールド 黒反転 青反転 グリーン反転 シアン反転 赤反転 マジェンタ反転 黄色反転 白反転 https://www.mztn.org/ Jun's Homepage
定義形式リスト
- コロン(:)を行頭に書くと、用語とその説明文のリストの形式となります。
:見出し:行を * で始めます。 :リスト:行を - で始めます。 :整形済みテキスト:段落を ---( ---) などで囲みます。 :表:行を 「.」または「,」で始めます。セルの区切りは「,」です。
- 見出し
- 行を * で始めます。
- リスト
- 行を - で始めます。
- 整形済みテキスト
- 段落を ---( ---) などで囲みます。
- 表
- 行を 「.」または「,」で始めます。セルの区切りは「,」です。
コメントフォーム
- 行頭に「?T」を書くとそのページの先頭に入力フォームが表示され、入力内容がページの先頭部分に書き込み時間とともに書き込まれます。
- 行頭に「?B」を書くとそのページの先頭に入力フォームが表示され、入力内容がページの最後部に書き込み時間とともに書き込まれます。
- 入力したテキストは整形ルールにしたがって変換されます。