tiddlywiki 5.3.8 → 5.4.0

package/editions/ja-JP/tiddlers/wikitext/Literal Attribute Values.tid

@@ -0,0 +1,32 @@
+created: 20230615045409162
+modified: 20260225112930690
+original-modified: 20230615045432768
+tags: [[Widget Attributes]] WikiText
+title: Literal Attribute Values
+ja-title: リテラル属性値
+type: text/vnd.tiddlywiki
+
+リテラル属性値では、いくつかの異なる引用スタイルを使用できます:
+
+* シングルクォート (例 `attr='value'`)
+* ダブルクォート (例 `attr="value"`)
+* 三重ダブルクォート (例 `attr="""value"""`)
+* スペースを含まない値には引用符は必要ありません (例 `attr=value`)
+
+リテラル属性値には改行を含めることができます。例: 
+
+```
+<div data-address="マウスハウス、
+マウスレーン、
+ローデントビル、
+ラットランド。"/>
+```
+
+三重ダブルクォートを使用することで、単一ダブルクォートを含む属性値を指定できます。例: 
+
+```
+<div data-address="""マウスハウス、
+"マウス"レーン、
+ローデントビル、
+ラットランド。"""/>
+```

package/editions/ja-JP/tiddlers/wikitext/Macro Calls.tid

@@ -0,0 +1,60 @@
+caption: マクロ呼び出し
+created: 20150220182252000
+modified: 20260321104805874
+original-modified: 20230419103154328
+tags: WikiText Macros
+title: Macro Calls
+ja-title: マクロ呼び出し
+type: text/vnd.tiddlywiki
+
+!! 紹介
+
+このTiddlerでは、[[マクロ|Macros]]を呼び出すさまざまな方法について説明します。
+
+!! マクロ呼び出しトランスクルージョンのショートカット
+
+[[マクロ|Macros]]を呼び出すには、マクロ名とパラメータ値を`<<`二重山括弧`>>`で囲みます。
+
+```
+<<mymacro param:"これはパラメータ値です">>
+```
+
+デフォルトでは、パラメータはマクロの定義と同じ順序でリストします。パラメータに名前とコロンを付けることで、異なる順序でリストすることも可能です。
+
+パラメータに値が指定されていない場合は、[[マクロ定義|Macro Definitions]]でそのパラメータに指定されているデフォルト値が代わりに使用されます。(デフォルト値が定義されていない場合は、パラメータはブランクになります。)
+
+各パラメータ値は、`'`シングルクォーテーション`'`、`"`ダブルクォーテーション`"`、`"""`三重ダブルクォーテーション`"""`、または`[[`二重角括弧`]]`で囲むことができます。三重ダブルクォーテーションを使用すると、値にほぼあらゆる文字列を含めることができます。値にスペース、シングルクォーテーション、ダブルクォーテーションが含まれていない場合は、区切り文字は必要ありません。
+
+この構文の正式な[[説明|Macro Call Syntax]]も利用可能です。
+
+[[パーサーモード|WikiText parser mode: macro examples]]に関する[[例|Macro Calls in WikiText (Examples)]]と議論を参照してください。
+
+!! <<.wlink TranscludeWidget>>ウィジェットを用いたマクロ呼び出し
+
+ショートカット構文は、トランスクルードするマクロの名前を指定する`$variable`属性を持つ<<.wlink TranscludeWidget>>ウィジェットに展開されます。
+
+```
+<$transclude $variable="mymacro" param="これはパラメータ値です"/>
+```
+
+ウィジェット自体は、パラメータ値を指定できるなど、ショートカット構文よりも柔軟です。
+
+!! 属性値にマクロ呼び出しを割り当てる
+
+マクロの実行結果は、ウィジェットやHTML要素の属性に割り当てることができます。マクロの実行結果はWiki変換されませんが、[[パラメータの置換|Macro Parameter Handling]]は実行されます。
+
+```
+<div class=<<myclasses "Horizontal">>>
+...
+</div>
+```
+
+!! フィルターでマクロ呼び出しを使用する
+
+マクロ呼び出しはフィルタ内で使用できます:
+
+```
+<$list filter="[<mymacro param:'value'>]">
+...
+</$list>
+```

package/editions/ja-JP/tiddlers/wikitext/Macro Definitions.tid

@@ -0,0 +1,69 @@
+created: 20150220181617000
+modified: 20260321112056546
+original-modified: 20230419103154328
+tags: WikiText Macros
+title: Macro Definitions
+ja-title: マクロ定義
+type: text/vnd.tiddlywiki
+
+!! 紹介
+
+このTiddlerの説明では、[[マクロ|Macros]]を定義するさまざまな方法について説明します。
+
+!! マクロ定義プラグマ
+
+マクロは、Tiddlerの先頭に[[プラグマ: \define|Pragma: \define]]を使用することで作成します。定義されたマクロは、そのマクロを定義したTiddler内、およびそれをトランスクルードするすべてのTiddlerで使用できます。
+
+```
+\define mymacro(param)
+これはマクロのテキストです (param=$param$)
+\end
+```
+
+!! ネストしたマクロ定義
+
+マクロ定義は、`\end`マーカーでマクロ名を指定することで、必要なレベルまでネストできます。ネストしたマクロ定義は、それを含む定義の先頭に記述する必要があります。例:
+
+<<wikitext-example-without-html src:"""\define special-button(caption:"クリック")
+\define actions()
+<$action-sendmessage $message="tm-notify" $param="HelloThere"/>
+\end actions
+<$button actions=<<actions>>>
+$caption$
+</$button>
+\end special-button
+
+<<special-button>>
+""">>
+
+外側のマクロがレンダリングされる際に発生するマクロパラメータのテキスト置換は、ネストした定義にも適用されることに注意してください。つまり、一般的に、ネストしたマクロ内ではマクロパラメータのテキスト置換を使用すべきではありません。
+
+ネストしたマクロのパラメータにも、`<<__変数名__>>`構文を介してアクセスできます。通常の変数と同様に、これらのパラメータはネストした子マクロ(および孫マクロなど)内でも使用可能です。
+
+!! Setウィジェットを用いたマクロ定義
+
+マクロは[[変数|Variables]]の特別な型として実装しているため、内部的には<<.wlink SetWidget>>ウィジェットによって定義されます。
+
+```
+<$set name="mymacro" value="これはマクロのテキストです">
+...
+</$set>
+```
+
+<<.note """<<.wlink SetWidget>>ウィジェットを使用してマクロを定義する際、現時点ではパラメータを指定することはできません。""">>
+
+!! マクロ定義のインポート
+
+[[プラグマ: \import|Pragma: \import]]や<<.wlink ImportVariablesWidget>>ウィジェットを使用すると、別のTiddlerからマクロ定義をコピーできます。
+
+!! `$:/tags/Macro`タグ
+
+グローバルマクロは、[[システムタグ: $:/tags/Macro|SystemTag: $:/tags/Macro]]を使用して定義できます。
+
+[[システムタグ: $:/tags/Macro/View|SystemTag: $:/tags/Macro/View]]は、メインビューテンプレートとプレビューパネル内でのみ使用可能なマクロを定義するために使用します。
+
+[[システムタグ: $:/tags/Macro/View/Body|SystemTag: $:/tags/Macro/View/Body]]は、メインビューテンプレートの本体とプレビューパネル内でのみ使用可能なマクロを定義するために使用します。
+
+!! JavaScriptマクロ
+
+マクロは<<.js-macro-link "JavaScriptモジュールとして記述">>することもできます。

package/editions/ja-JP/tiddlers/wikitext/Macro Parameter Handling.tid

@@ -0,0 +1,80 @@
+created: 20220917154902906
+modified: 20260322113926744
+original-modified: 20230419103154328
+tags: WikiText Macros
+title: Macro Parameter Handling
+ja-title: マクロパラメータの処理
+type: text/vnd.tiddlywiki
+
+!! 紹介
+
+[[マクロ|Macros]]のパラメータは、2つの異なる方法で処理されます:
+
+# マクロの内容が使用される前に、各パラメータに対して必ずテキスト置換が実行されます
+# マクロの内容をWiki化すると、パラメータは変数として利用できるようになります。変数名は、パラメータ名を二重アンダースコアで囲んで作成します
+
+やや紛らわしいことに、状況によってはこれら両方のメカニズムが発生する場合があります。これは[[マクロを使用する際の落とし穴|Macro Pitfalls]]に関連しています。
+
+!! パラメータと変数のテキスト置換
+
+マクロのテキストが使用される前に、以下の置換処理が行われます:
+
+* パターン`$param$`は、指定されたパラメータの値に置き換えられます。
+* パターン`$(variable)$`は、指定された変数の値に置き換えられます。
+
+マクロが呼ばれるたびに、プレースホルダーにはパラメータや変数の実際の値が代入されます:
+
+<$macrocall $name="wikitext-example-without-html" src="""\define say-hi-using-parameters(name,address)
+こんにちは、私は$name$です。$address$に住んでいます。
+\end
+
+<<say-hi-using-parameters name:"Bugs" address:"Rabbit Hole Hill">>
+"""/>
+
+変数置換を使った例を示します:
+
+<$macrocall $name="wikitext-example-without-html" src="""\define say-hi-using-variables()
+こんにちは、私は$(name)$です。$(address)$に住んでいます。
+\end
+
+\define name() Bugs
+
+<$let address="Rabbit Hole Hill">
+<<say-hi-using-variables>>
+</$let>
+"""/>
+
+<<.warning """挿入されるテキストに置換トークンが含まれている場合、それらも処理されることに注意してください。これにより、予期しない結果が生じるかもしれません。""">>
+
+!! パラメータを変数としてアクセス
+
+マクロがWiki化されると、パラメータは、パラメータ名を二重アンダースコアで囲んだ変数としてアクセスできます。たとえば、パラメータ`address`は変数`__address__`としてアクセスします。
+
+したがって、上記の例は次のように表現することもできます:
+
+<$macrocall $name="wikitext-example-without-html" src="""\define say-hi-using-parameters(name,address)
+こんにちは、私は<<__name__>>です。<<__address__>>に住んでいます。
+\end
+
+<<say-hi-using-parameters name:"Bugs" address:"Rabbit Hole Hill">>
+"""/>
+
+パラメータを変数としてアクセスできるのは、Wiki化されたマクロの場合のみであり、例えばマクロが属性値として使用される場合にはアクセスできません。
+
+!!! パラメータを変数としてアクセスする利点
+
+このテクニックの主な利点は、パラメータ値がリテラル文字列としてマクロに代入されるのを回避できる点であり、引用符を含むパラメータに関する問題を回避できる点にあります。
+
+例えば、このマクロを考えてみましょう。これは、単一のパラメータを引数として別のマクロを呼び出します:
+
+```
+\define film-quote(line) <$macrocall $name="anothermacro" actor="Bugs Bunny" line="""$line$"""/>
+```
+
+上記のコードは、引数に三重ダブルクォートが含まれている場合(例:`<<film-quote '3回引用します """ - ほらね!?'>>`)、マクロが呼び出されると失敗します。パラメータ変数を使用することで回避できます: 
+
+```
+\define film-quote(line) <$macrocall $name="anothermacro" actor="Bugs Bunny" line=<<__line__>>/>
+```
+
+詳細は[[マクロを使用する際の落とし穴|Macro Pitfalls]]を参照してください。

package/editions/ja-JP/tiddlers/wikitext/Paragraphs in WikiText.tid

@@ -0,0 +1,25 @@
+created: 20131205155836435
+modified: 20260223101955973
+original-modified: 20131214170445345
+tags: WikiText
+title: Paragraphs in WikiText
+ja-title: Wikiテキストでの段落
+type: text/vnd.tiddlywiki
+caption: 段落
+
+TiddlyWikiで段落の終わりを示すには、`enter`を2回押し、2重改行を入力する必要があります:
+
+```
+これは最初の段落です。
+
+そしてこれは二番目の段落です。
+```
+
+段落内の単一の改行は無視されます。例えば:
+
+<<wikitext-example src:"これは
+短い行で
+構成された
+段落です">>
+
+この動作が不便な場合は、[[Wikiテキストでの強制改行|Hard Linebreaks in WikiText]]を使用することもできます。

package/editions/ja-JP/tiddlers/wikitext/Substituted Attribute Values.tid

@@ -0,0 +1,35 @@
+base-url: http://tiddlywiki.com/
+created: 20230615050814821
+modified: 20260326113238925
+original-modified: 20251021134906488
+tags: [[Widget Attributes]] WikiText
+title: Substituted Attribute Values
+ja-title: 置換属性値
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.3.0">>
+置換属性値には、2種類の異なる引用スタイルを使用できます:
+
+* 一つのバッククォート <$codeblock code="attr=`value`"/>
+* 3重のバッククォート <$codeblock code="attr=```value```"/>
+
+属性値は、フィルタ式や変数のプレースホルダーを対応する値に置き換えたバッククォートで囲まれたテキストです。フィルタ式のプレースホルダーは変数のプレースホルダーよりも前に置換されるため、返される値に対してさらに変数置換を行うことができます。
+<<.warning "そのテキストに含まれるその他のWiki構文はそのまま残されます。">>
+
+|プレースホルダー構文|説明|h
+|`$(varname)$`|変数のテキスト置換。未定義の変数は空の文字列に置き換えられます。 |
+|`${ filter expression }$`|フィルタ式を評価した最初の結果でテキストを置換します。 |
+
+! 例
+
+!! 変数の値を文字列へ代入
+
+<$macrocall $name=wikitext-example-without-html src="""<$text text=`こんにちは、これは "$(currentTiddler)$" Tiddlerです`/>"""/>
+
+
+!! 変数の値とフィルタ式の評価結果を文字列へ代入
+<$macrocall $name=wikitext-example-without-html src="""<$text text=`このTiddlerのタイトルは "$(currentTiddler)$" で、最終更新日は ${[{!!modified}format:date[YYYY年MM月DD日]]}$ です`/>"""/>
+
+{{Concatenating variables to create a URL}}
+
+{{Concatenating a text reference to create a URL}}

package/editions/ja-JP/tiddlers/wikitext/Table Classes Captions Headers and Footers.tid

@@ -0,0 +1,22 @@
+created: 20220819100636227
+modified: 20260302113247123
+original-modified: 20220819101309072
+tags: [[Tables in WikiText]]
+title: Table Classes, Captions, Headers and Footers
+ja-title: 表クラス、キャプション、ヘッダー、フッター
+type: text/vnd.tiddlywiki
+
+表のCSSクラス、キャプション、ヘッダー、フッターは、特別な擬似行として指定できます。次の例をご覧ください:
+
+* `|myclass anotherClass|k` は、表にCSSクラス"myclass"と"anotherClass"を割りあてます
+* `|これはキャプションです |c` は、表にキャプション"これはキャプションです"を付与します
+* `|ヘッダー|ヘッダー|h` は、テキスト"ヘッダー"を含むセルのヘッダー行を追加します
+* `|フッター|フッター|f` は、テキスト"フッター"を含むセルのフッター行を追加します
+
+<<wikitext-example-without-html src:"""|myclass anotherClass|k
+|これはキャプションです |c
+|セル1 |セル2 |
+|セル3 |セル3 |
+|ヘッダー|ヘッダー|h
+|フッター|フッター|f
+""">>

package/editions/ja-JP/tiddlers/wikitext/Tables in WikiText CSS Utility Classes.tid

@@ -0,0 +1,83 @@
+created: 20220817153236691
+modified: 20260404112841923 
+original-modified: 20221010074314452
+tags: [[Tables in WikiText]]
+title: Tables in WikiText CSS Utility Classes
+ja-title: Wikiテキストの表に関するCSSユーティリティクラス
+type: text/vnd.tiddlywiki
+
+Wikiテキストの表は、CSSクラスを適用することでスタイルを設定できます。Wikiテキストの表の基本情報やスタイルの設定方法については、[[Wikiテキストでの表|Tables in WikiText]]を参照してください。
+
+{{Table Classes, Captions, Headers and Footers}}
+
+上記のように、結果として生成される表は左揃えで、コンテンツに合わせてサイズが調整されます。これは、ブラウザの表レイアウトのデフォルト動作です。別の動作を実現するには、"`k`行"にさまざまなCSSクラスを追加します。
+
+! ユーティリティクラス
+
+{{Utility Classes}}
+
+! 例
+
+以下の例では表にスタイルクラスを適用していますが、"汎用ユーティリティクラス"は、DIV要素やその他の[[HTMLブロック要素|HTML Block Elements]]にも使用できます。
+
+!! 中央寄せの表
+
+表を水平方向に中央寄せにするには、`tc-center`を使用します:
+
+<<wikitext-example-without-html src:"""|tc-center|k
+|これはキャプションです |c
+|セル1 |セル2 |
+|セル3 |セル4 |
+|ヘッダー|ヘッダー|h
+|フッター|フッター|f
+""">>
+
+!! 中央寄せの表、80%幅
+
+full-tiddler-widthである表に、左右の余白を追加するには、`tc-max-width-80`を使用できます
+
+<<wikitext-example-without-html src:"""|tc-center tc-max-width-80|k
+|これはキャプションです |c
+|セル1 |<<.lorem>> |
+|<<.lorem>> |セル4 |
+|ヘッダー|ヘッダー|h
+""">>
+
+!! 最大幅の表
+
+表をTiddlerの幅いっぱいに広げるには、`tc-max-width`を使用します
+
+<<wikitext-example-without-html src:"""|tc-max-width|k
+|ヘッダー|ヘッダー|h
+|セル1 |セル2 |
+|セル3 |セル4 |
+""">>
+
+!! 最初の列の幅が最小の表
+
+次の例は、`tc-first-col-min-width`により、最初の列の幅がコンテンツに合わせて調整されるシンプルな"フォーム"を示しています。
+
+<<wikitext-example-without-html src:"""|tc-max-width tc-first-col-min-width|k
+|ヘッダー|ヘッダー|h
+|セル1 |<$edit-text tiddler="$:/temp/test-table-input" tag="input" field="test"/> |
+|セル3 |<$edit-text tiddler="$:/temp/test-table-input" field="text"/>  |
+""">>
+
+!! 最大幅のテキストウィジェットを備えた表
+
+ここでは、前の"フォーム"にクラス`tc-edit-max-width`を追加することで、[[Textウィジェット|TextWidget]]にフルの幅を与えるようにスタイルが付けられています。
+
+<<wikitext-example-without-html src:"""|tc-max-width tc-first-col-min-width tc-edit-max-width|k
+|ヘッダー|ヘッダー|h
+|セル1 |<$edit-text tiddler="$:/temp/test-table-input" tag="input" field="test"/> |
+|セル3 |<$edit-text tiddler="$:/temp/test-table-input" field="text"/>  |
+""">>
+
+!! 枠線の無い表
+
+以下は最大幅の表です。この表には最大幅の[[Textウィジェット|TextWidget]]が含まれています。最初の列は最小幅に設定されています。さらに、最初の列のすべてのリンクは、ウィンドウのサイズ変更に関係なく、改行(折り返し)__しない__ように設定されています。
+
+<<wikitext-example-without-html src:"""|tc-max-width tc-first-col-min-width tc-edit-max-width tc-table-no-border tc-first-link-nowrap|k
+| セル1|<$edit-text tiddler="$:/temp/test-table-input" tag="input" field="test"/> |
+|^ [[Tiddlerへのリンク|Link to a tiddler]]<br>さらに詳しい説明|<$edit-text tiddler="$:/temp/test-table-input" field="text"/>  |
+""">>

package/editions/ja-JP/tiddlers/wikitext/Tables in WikiText.tid

@@ -0,0 +1,74 @@
+caption: 表
+created: 20130914132100000
+modified: 20260301110050493
+original-modified: 20220819103416274
+tags: WikiText
+title: Tables in WikiText
+ja-title: Wikiテキストでの表
+type: text/vnd.tiddlywiki
+
+! 基本
+
+TiddlyWiki5は縦棒`|`記号を使って表をフォーマットします。感嘆符`!`はヘッダーセルを示すために使用します。
+
+<<wikitext-example-without-html src:"""|!セル1 |!セル2 |
+|セル3 |セル3 |
+""">>
+
+
+
+! セルの配置
+
+表のセルの配置は、セルコンテンツの前後にスペース文字を挿入することで制御します。例: 
+
+<<wikitext-example-without-html src:"""|左揃えのコンテンツ |
+| 右揃えのコンテンツ|
+| 中央揃えのコンテンツ |
+|+++ 配置がわかるように非常に幅の広い列を作成 +++|
+""">>
+
+
+
+! セルの垂直方向の配置
+
+セルの垂直方向の配置は、セルの先頭文字に上揃えの場合は`^`を、下揃えの場合は`,`を挿入することで行います。通常の水平方向の配置も可能です。例:
+
+```
+|^左上 |^ 上中央 |^ 右上|
+|左中央 | 中央 | 右中央|
+|,左下 |, 下中央 |, 右下|
+```
+
+例は次のように表示されます:
+
+| :: | ::::::::::::::::::::::::::: | ::::::::::::::::::::::::::: | ::::::::::::::::::::::::::: | :: |
+| ::<br>:: |^左上 |^ 上中央 |^ 右上| ::<br>:: |
+| ::<br>:: |左中央 | 中央 | 右中央| ::<br>:: |
+| ::<br>:: |,左下 |, 下中央 |, 右下| ::<br>:: |
+| :: | ::::::::::::::::::::::::::: | ::::::::::::::::::::::::::: | ::::::::::::::::::::::::::: | :: |
+
+左揃えのセルの最初の文字として`^`や`,`を使用する場合は、HTMLエスケープを使用できます:
+
+| `^` | &amp;#94; |
+| `,` | &amp;#44; |
+
+
+
+! セルの結合
+
+表のセルを上のセルと結合するには、特殊なセルテキスト`~`を使用します。セルをその左のセルと結合するには、テキスト`<`を使用します。セルをその右のセルと結合するには、テキスト`>`を使用します。例:
+
+<<wikitext-example-without-html src:"""|セル1 |セル2 |セル3 |セル4 |
+|セル5 |セル6 |セル7 |<|
+|セル5 |~|セル7 |セル8 |
+|>|セル9 |セル10 |セル11 |
+""">>
+
+
+
+! 表クラス、キャプション、ヘッダー、フッター
+
+{{Table Classes, Captions, Headers and Footers}}
+
+
+その他の例については、[[Wikiテキストでの表 CSSユーティリティクラス|Tables in WikiText CSS Utility Classes]]を参照してください

package/editions/ja-JP/tiddlers/wikitext/Transcluded Attribute Values.tid

@@ -0,0 +1,16 @@
+created: 20230615045327830
+modified: 20260303112704709
+original-modified: 20230615045353826
+tags: [[Widget Attributes]] WikiText
+title: Transcluded Attribute Values
+ja-title: トランスクルードされた属性値
+type: text/vnd.tiddlywiki
+
+トランスクルードされた属性値は、[[テキスト参照|TextReference]]を二重の中括弧で囲んで示します。例:
+
+```
+attr={{tiddler}}
+attr={{!!field}}
+attr={{tiddler!!field}}
+```
+<<.warning "属性値の値は、[[テキスト参照|TextReference]]から取得されたテキストそのものになります。そのテキストに含まれるWiki構文はそのまま残ります。">>

package/editions/ja-JP/tiddlers/wikitext/Transclusion Basic Usage.tid

@@ -0,0 +1,47 @@
+created: 20141129201509859
+modified: 20260402111456035
+original-modified: 20141130194810119
+tags: [[Transclusion in WikiText]]
+title: Transclusion Basic Usage
+ja-title: トランスクルージョンの基本的な使用法
+caption: 基本的な使用法
+
+! 単純なトランスクルージョン
+
+[[TiddlerA]]のコンテンツを[[TiddlerB]]に取り込むには、後者を編集して次のテキストを含めます:
+
+```
+これはTiddlerAのコンテンツです: {{TiddlerA}}
+```
+
+その結果、[[TiddlerA]]の''text''フィールドの内容(つまりメインコンテンツ)が[[TiddlerB]]内にレンダリングされます。
+
+! 使用法
+
+表記``{{TiddlerA}}``は``{{TiddlerA!!text}}``のショートカットです。これは、トランスクルージョンのデフォルトフィールドが''text''であるためですが、他の[[フィールド|TiddlerFields]]も明示的に使用できます。たとえば、次のようにしてTiddlerAが最後に変更された時刻を表示できます: 
+
+```
+TiddlerAは{{TiddlerA!!modified}}に更新されました
+```
+
+Tiddlerのタイトルを省略することで、トランスクルージョン表記を使用して、現在のTiddlerのフィールドの内容を表示することもできます。例:
+
+```
+このTiddlerは{{!!modified}}に更新されました
+```
+
+! 再帰エラー
+
+``{{!!text}}``や``{{}}``を使用するとエラー(//Recursive transclusion error in transclude widget//)が発生することに注意してください。これは、現在のTiddlerの内容を現在のTiddlerの内容(つまり、それ自身)に含めることは無意味なためです。このエラーメッセージに遭遇した場合は、直接的または間接的に何かをそれ自身に含めようとしていることを意味します(たとえば、Tiddler A がTiddler Bをトランスクルードし、Tiddler BがTiddler Cをトランスクルードし、Tiddler CがさらにTiddler Aをトランスクルードする場合など)。
+
+! もっと詳しく知るには
+
+TiddlyWikiでは、トランスクルージョンは上記のような生コンテンツを含めることだけに限定されません。トランスクルージョンのより高度な使用方法については、[[テンプレートを使用したトランスクルージョン|Transclusion with Templates]]を参照してください。
+
+参考:
+
+* [[トランスクルージョン|Transclusion]]
+* [[テンプレートを使用したトランスクルージョン|Transclusion with Templates]]
+* [[Wikiテキストでのトランスクルージョン|Transclusion in WikiText]]
+* [[テキスト参照|TextReference]]
+* [[Tiddlerのフィールド|TiddlerFields]]

package/editions/ja-JP/tiddlers/wikitext/Transclusion and Substitution.tid

@@ -0,0 +1,62 @@
+created: 20141018090608643
+modified: 20260329112320535
+original-modified: 20231030124224424
+tags: WikiText
+title: Transclusion and Substitution
+ja-title: トランスクルージョンと置換
+type: text/vnd.tiddlywiki
+
+[[Wikiテキスト|WikiText]]の強みは、あるTiddlerの内容を別のTiddlerの中に組み込むことができる点にあります。この機能にはいくつかの異なる形態があり、混同しやすい。
+
+主な違いは、テキストのトランスクルージョンとテキストの置換にあります。
+
+* トランスクルージョンは、以下のいずれかの値で動的に置き換えられます: 
+** Tiddlerフィールド
+** 変数
+* マクロ定義のテキストは、使用される前にテキスト置換処理が実施されます。
+
+! Tiddlerフィールドのトランスクルージョン
+
+[[Wikiテキストでのトランスクルージョン|Transclusion in WikiText]]では、トランスクルージョンの基本について説明しています。例えば:
+
+```
+{{MyTiddler}}
+```
+
+[[WikiテキストでのHTML|HTML in WikiText]]の説明にあるように、Tiddlerフィールドの値をHTMLの要素やウィジェットの属性として含めることもできます。例:
+
+```
+<$text text={{MyTiddler}}/>
+```
+
+[[フィルタ表記の紹介|Introduction to filter notation]]で説明しているように、[[フィルタのシンタックス|Filter Syntax]]を使用してTiddlerフィールドの値をトランスクルードすることもできます。例えば:
+
+```
+{{{ [tag{TiddlerContainingMyTag}] }}}
+```
+
+! 変数/マクロのトランスクルージョン
+
+パラメータや変数の置換によって定義された変数は"マクロ"と呼びます。変数/マクロの値は、次の構文でトランスクルードできます:
+
+```
+<<myMacro param:"パラメータの値">>
+```
+
+[[WikiテキストでのHTML|HTML in WikiText]]の説明にあるように、変数をHTML要素やウィジェットの属性値としてトランスクルードすることもできます。例: 
+
+```
+<$text text=<<myMacro>>/>
+```
+
+[[フィルタ表記の紹介|Introduction to filter notation]]で説明しているように、[[フィルタのシンタックス|Filter Syntax]]を使用して、変数をフィルタパラメータの値としてトランスクルードできます。例:
+
+```
+{{{ [tag<myMacro>] }}}
+```
+
+! テキスト置換
+
+テキスト置換は、マクロ/変数の値が使用されるときに発生します。[[置換属性値|Substituted Attribute Values]] and [[substituteオペレータ|substitute Operator]]で説明しています。
+
+置換とトランスクルージョンの主な違いは、置換は[[Wikiテキスト|WikiText]]のパースよりも前に行われる点です。つまり、置換を使ってWikiテキストの構造を構築できます。トランスクルージョンは独立して処理されるため、隣接するテキストと組み合わせてWikiテキストの構造を定義することはできません。