「記法/」で始まるページを作成

記法案。それと記法の実装案。
 
  • -----------------------------------------------
いろいろな記法

WikiCreole: List Of Wiki Markup
WikiMatrix - Compare them all
記法

目次 † Edit
  1. 目次
  2. 関連
  3. 記法周辺のタグ
  4. 記法とは
  5. 思い付き
    1. Excel関数を参考に
    2. ページと見出しを、リンクする/されるの両方に
    3. タブでインデントしたい
    4. 見えない文字は無視したい
    5. 検索用クラスやめ
    6. 機能は検索時の比較方法もメソッドとして持つ。
    7. ヘルプは初心者向けのみ
    8. 変換ルールはページ内で定義
    9. 記法
    10. class属性を付けるならそれごと記法として実装
      1. :i/記法定義は記法→要素クラス→記法
      2. :Done/記法定義の方法
      3. :i/ページの内容はコードと見なせる
    11. 汎用のspan的記法
      1. Markdownの特徴
    12. 要素にidを付けるとき
  6. 方法
    1. 段落
    2. いろいろな記法
    3. 参考に
    4. いろいろな記法
    5. 記法/
    6. どこでも記法
    7. 特別なNotation
    8. 種別、影響範囲
    9. 曖昧な記法を解釈
    10. 記法が含むもの

関連 † Edit
汎用記法は全ての要素を表現できる記法。要素クラス名をパラメーターとして受け取れる。
検索:記法
ToMarkdown()などを持つのはビルトイン要素。
プラグイン要素はそういった記法系に無い。汎用記法と、それにマッピングしたシンタックスシュガーでのみ表記できる。

記法周辺のタグ † Edit

 Array

記法とは † Edit
機能呼び出し記法のシンタックスシュガー。
呼び出す機能ごとに定義。1つの機能呼び出しについて複数記法を定義していい。 
----
*
**
***
&(...);
#...

などのWiki特有の書き方のこと。
それと、これらの書き方で書かれたテキストのこと。
「マークダウン」などと同じ用途・目的。→キーワード:Markdown Google:Markdown
WikiTextもWikiFormatも同じ意味で使われていそう。
ここでは記法を含むテキストをWikiTextと言うことにしている。
Google:Wiki-Notation
Google:Wiki-Format
Google:WikiText
Google:Wiki Formatted Text
実体は機能の呼び出し方（機能を呼び出したいときの書き方）。
→ X/Element/Notation[?]

思い付き † Edit

Excel関数を参考に † Edit

ページと見出しを、リンクする/されるの両方に † Edit
ページ名を表す記法、見出しを表す記法を用意。
段落始めに書けばページ名や見出しを定義する。それ以外に書くと指定したページや見出しへのリンクになる。

タブでインデントしたい † Edit
テキストエディターを使うとインデントしやすくなる。

見えない文字は無視したい † Edit
使うとすれば記法を越えない程度に。
空白を取り除いても同じ記法になるように。

検索用クラスやめ † Edit
「検索」に書かれているクラスを廃止。
Notationクラスで行う。
Notationの機能…
  • 検索式→オブジェクトの単行表現
  • ページのテキスト→オブジェクトの複数行表現
  • オブジェクト同士を比較したときの適合度算出
    具象クラスが同じ場合も先祖が共通の場合も使える。
    先祖が共通の場合は適合度がやや下がる。
    クラスメソッド。
  • オブジェクト→テキスト（HTML)

…といったことができる。

機能は検索時の比較方法もメソッドとして持つ。 † Edit
色とか。色機能（色を示す表現を色オブジェクトに置き換える機能）色を示す記法機能。 
#FFF
White

…などが 
#FFC

などと近く（高い適合率）になるように。

ヘルプは初心者向けのみ † Edit
詳細な説明なら定義ページを見ればいい。

変換ルールはページ内で定義 † Edit
記法→内部形式（Element系オブジェクト）のルール
RegExp→Element系クラス名
…という形式で定義。
1ページに1クラス分の複数書式を定義。ページ名と対応するクラスはハードコーディング（変更不可能）で良い。
それらをまとめたページを作れば記法定義の一覧になる。

でも、Notationを単なる 正規表現→機能名とパラメーター とすれば1ページにいくらでもまとめてもいいかも知れない。
例外がなければ。
  1. 目次
  2. 関連
  3. 記法周辺のタグ
  4. 記法とは
  5. 思い付き
    1. Excel関数を参考に
    2. ページと見出しを、リンクする/されるの両方に
    3. タブでインデントしたい
    4. 見えない文字は無視したい
    5. 検索用クラスやめ
    6. 機能は検索時の比較方法もメソッドとして持つ。
    7. ヘルプは初心者向けのみ
    8. 変換ルールはページ内で定義
    9. 記法
    10. class属性を付けるならそれごと記法として実装
      1. :i/記法定義は記法→要素クラス→記法
      2. :Done/記法定義の方法
      3. :i/ページの内容はコードと見なせる
    11. 汎用のspan的記法
      1. Markdownの特徴
    12. 要素にidを付けるとき
  6. 方法
    1. 段落
    2. いろいろな記法
    3. 参考に
    4. いろいろな記法
    5. 記法/
    6. どこでも記法
    7. 特別なNotation
    8. 種別、影響範囲
    9. 曖昧な記法を解釈
    10. 記法が含むもの

Notation定義を参照するときのキーは？
特定ページ、または特定のページ以下にあるページ集合？

記法 † Edit
記法は読むためのもの。書くためのものではない。

class属性を付けるならそれごと記法として実装 † Edit
1つの記法のインスタンスごとにclass属性を付けてスタイルを変えたい
→それを含めて新記法にすべき。汎用のspan的記法も用意すれば十分。

:i/記法定義は記法→要素クラス→記法 † Edit

:Done/記法定義の方法 † Edit

:i/ページの内容はコードと見なせる † Edit
記法はコードのようなもの。実行結果がページの閲覧時に組み込まれる。
他の言語のコードを書くのならシンタックスハイライトとか自動リンクとか。コンテンツ扱い。実行のようなことはしないで。

汎用のspan的記法 † Edit
スタイル適用のための<span>生成。パラメーターにclass名。別途スタイルシートを用意してもらう。

Markdownの特徴 † Edit
http://space.hatena.ne.jp/pmint/entry/14218542507645637066

要素にidを付けるとき † Edit
プレースホルダー記法にidパラメーターを。
なにかで目印にするための記法。

方法 † Edit
埋め込み式ページ[?]を応用して実装。
記法を、「機能呼び出し記法が書かれたページ」を埋め込むことで実現できる。
そうすれば記法→機能呼び出しをページで定義・カスタマイズできる。
…というのはパラメーターなしの機能呼び出しだけ。
ほとんどのNotationは記法/定義に書かないといけない。

段落 † Edit
空行で段落の開始、終了。
段落末尾で段落の属性指定。実はどこに書いてもいい。
左寄せ、中寄せ、右寄せは段落属性。行単位ではないので行頭には書かない。
Wikitextコメントの中にさらに記法を書けば、これは見えない特殊な記述だとわかりやすい。
変換前/後が何であるか、何をどうするのかの違い。

いろいろな記法 † Edit

参考に † Edit


WikiCreole: List Of Wiki Markup
WikiMatrix - Compare them all
Help:Cheatsheet - Wikipedia, the free encyclopedia
段落の体裁をいろいろ用意してもいい。AsciiDocのように。
その指定は段落属性で言葉で記述。定義上の名称、見た目、見た目を擬態語で、何の脈絡もない定義上の番号で、管理者設定による名称などいろいろな言葉で。

いろいろな記法 † Edit
  • 単行テキスト
  • 複数行テキスト
  • メールアドレス
  • URL
    http:、https:、ftp:のほかtwitter:なども。
  • 数値と計算式とフォーマット
    金額とか。
  • 日時と計算式
  • 時間（日時×2）と計算式
  • 選択・列挙型
    文字列の列挙型、列挙されていない値は持てない。選択可能数1または任意個。
  • ページ任意数
    とフィルタリングルール。フィルタリングで特定のページだけを選択肢に。ユーザー限定など。
    添付ファイル、添付イメージなどはページとして記述。

記法/ † Edit


URL、ISBN、ASIN、電話番号、住所などを特別扱いに。

どこでも記法 † Edit

特別なNotation † Edit
機能ではないもの。特別扱いする必要のあるもの。

種別、影響範囲 † Edit


WikiCreoleの実装にも適用。
影響範囲の小さい順に行修飾、文字修飾、段落…。
影響範囲が重なっている部分では、範囲の小さい記法が優先される。
以下、影響範囲の小さい順（優先度の高い順）
  1. 行修飾、ライン
    改行間の全てに影響。
    行頭に書く。行頭を含むNotation。1行にしか影響しないのは行頭に書くものなので。書き方の問題。 
    **見出し
  2. 行修飾（連結）
    行頭。で次の行も同じNotationならまとまる。というよりも前の行が同じなら連結。（もし衝突があったとしても）前の行の属性が優先されるので。 
    -リスト
-リスト
  3. 文字修飾、インライン
    どこからでも開始できる。
    改行を越えて影響するため、行修飾よりも広範囲。 
    //斜体//
  4. 段落修飾、パラグラフ
    空行（連続改行）間で有効。
    空行後に書く。というか、空行が無くてもこのNotationからを段落とみなす。
    少なくとも行頭に書く必要あり。このNotationだけで1行。というか改行を含むNotation。 
    >>
引用(brockquote)
<<

    末尾を<<で終わらせるようにすれば段落（空行）を越えられるが…→連結するなら、越えなくていい。
    >> ... <<で空行を越える記法はスクロール不要な長さなら影響範囲が分かりやすくなる。長い場合は段落ごとに>>を書いたほうが分かりやすい。
    斜体などの段落版があってもいい。
  5. 段落修飾（連結）
    段落修飾は全て連結可能にしていいはず。ゆえに段落修飾はどれも連結する。でも毎段落ごとにNotationが必要になるので、<<で終了させる形のほうが書くときの手間がかからない。→<<で閉じる？
  6. ページ
    1ページ全体に影響。なので、どこに書いてもいいが専用欄を設けてもいい。
    ページ冒頭か末尾に書くのが簡単？
    →ページ/属性にする
  • -------------------------------------

行頭後・空行後に書くものは改行処理前に解釈。それ以外は改行処理をした上で解釈。ただ空行は残すので空行後の物は改行処理の後でもいい。
改行→<br/>をする設定でもしない設定でも、文字修飾は改行を越える。空行も越えられるが…→WikiCreoleに合わせて越えないようにする。影響範囲が分かりやすい。

曖昧な記法を解釈 † Edit
書き手の意図を反映させるように。
記号の前後は必ず何らかの効果が現れるように。
 **リスト
で、
 …**太字**
のとき、
 …**B**B**… → …<b>B</b>B**…
 **B**… →<b>B</b>… または <li>B**…
 **…**B**… → <li>…<b>B</b>…
 **B**…**B**… →<b>B</b>…<b>B</b>… または <li>B<b>…</b>B**…
正しくは
 ****B** → <li><b>B</b>
ユーザーが入力した情報が失われてしまうのを防ぐため、余ったNotationは消さずに残す。
bとして解釈できる場合、行頭の**を2つの意味で捉える？
 **B** →<li><b>B</b>
他のケースで使いにくく（結果を予想できなく）なってしまいそう。

記法が含むもの † Edit
  • 記法
    入れ子。
  • 機能呼び出し
    • 機能名と入力するデータ列
  • 機能呼び出し以外のマークアップ
    もしあれば。
    （これも結局機能として扱うので、結局機能と同じ）