tiddlywiki 5.3.8 → 5.4.1

package/editions/ja-JP/tiddlers/howtos/Concatenating text and variables using macro substitution.tid

@@ -8,7 +8,7 @@ type: text/vnd.tiddlywiki
 
 !! 重要
 
-<<.from-version "5.3.0">> テキストと変数を連結するには、[[置換された属性|Substituted Attribute Values]]や[[置換フィルター演算子|substitute Operator]]を使用することをお勧めします。
+<<.from-version "5.3.0">>以降、テキストと変数を連結するには、[[置換された属性|Substituted Attribute Values]]や[[置換フィルター演算子|substitute Operator]]を使用することをお勧めします。
 
 ~TiddlyWikiでは、変数の値をさまざまなテキスト文字列と組み合わせることがよくあります。一部のプログラミング言語では、このプロセスはテキストの"連結"と呼ばれることがよくあります。
 

package/editions/ja-JP/tiddlers/howtos/Hard_Linebreaks_with_CSS.tid

@@ -0,0 +1,28 @@
+created: 20170126174506507
+modified: 20260223105027444
+original-modified: 20170126211042714
+tags: [[Hard Linebreaks in WikiText]]
+title: Hard Linebreaks with CSS
+ja-title: CSSを使用した強制改行
+type: text/vnd.tiddlywiki
+
+TiddlyWikiバージョン5.1.16以降、`data-`属性を使用してカスタムスタイルを適用できるようになりました。参照: [[カスタムスタイルを適用する方法|How to apply custom styles]]
+
+[[Custom data-styles]]スタイルシートTiddlerには、次の定義が含まれています: 
+
+```
+[data-tags*="example-hardlinebreaks"] .tc-tiddler-body {
+  word-break: normal; 
+  word-wrap: break-word;
+  white-space: pre-wrap;
+}
+```
+
+タグなしでレンダリングすると、"CSSを使用した強制改行 - 例"の内容は次のように表示されます: 
+
+>{{Hard Linebreaks with CSS - Example}}
+
+----
+
+TIddlerを開いて、適用されているカスタムCSSルールを確認してください: [[CSSを使用した強制改行 - 例|Hard Linebreaks with CSS - Example]]
+

package/editions/ja-JP/tiddlers/howtos/Hard_Linebreaks_with_CSS_-_Example.tid

@@ -0,0 +1,16 @@
+created: 20170126161803543
+modified: 20260223105159019
+original-modified: 20170126211025840
+tags: example-hardlinebreaks [[Hard Linebreaks in WikiText]]
+title: Hard Linebreaks with CSS - Example
+ja-title: CSSを使用した強制改行 - 例
+type: text/vnd.tiddlywiki
+
+
+次のテキストは、特別な[[Wikiテキスト|WikiText]]構文を使用せずに改行されます。したがって、Wikiテキストのほとんどの機能にアクセスできます
+
+これは行です
+そして、これは新しい行です
+一方で、これはさらに別の行です
+そして、これは最後の行です
+この行は別の行です

package/editions/ja-JP/tiddlers/marketplace/TiddlyWiki Marketplace.tid

@@ -0,0 +1,20 @@
+title: TiddlyWiki Marketplace
+ja-title: TiddlyWiki マーケットプレイス
+tags: Community
+modified: 20260208114419033
+original-modified: 20221204165636777
+created: 20221204165636777
+
+<span style="float:right;">[img width=200px [TiddlyWiki Marketplace Banner]]</span>
+
+TiddlyWikiマーケットプレイスへようこそ。この新しいフォーラムは、個人や組織がTiddlyWikiを中心に構築された商用製品やサービスを提供するスペースを提供するようにデザインされています:
+
+* 有料ホスティングサービス
+* カスタムソリューションの開発
+* トレーニングコース
+* 1対1のトレーニングセッション
+* "Fix my wiki"デバッグセッション
+
+<a href="https://talk.tiddlywiki.org/c/marketplace/22" class="tc-btn-big-green" style="border-radius:4px;background-color:#ff5c48;" target="_blank" rel="noopener noreferrer">
+~TiddlyWikiマーケットプレイス
+</a>

package/editions/ja-JP/tiddlers/plugins/Dynaview Plugin.tid

@@ -1,7 +1,7 @@
 created: 20180111122953142
 modified: 20241223104409794
 original-modified: 20181113084151268
-tags: OfficialPlugins
+tags: OfficialPlugins [[Plugin Editions]]
 title: Dynaview Plugin
 ja-title: 動的表示プラグイン
 type: text/vnd.tiddlywiki

package/editions/ja-JP/tiddlers/plugins/Innerwiki Plugin.tid

@@ -1,7 +1,7 @@
 created: 20190127104143725
 modified: 20241223111102675
 original-modified: 20190127104143725
-tags: OfficialPlugins
+tags: OfficialPlugins [[Plugin Editions]]
 title: Innerwiki Plugin
 ja-title: インナーウィキプラグイン
 type: text/vnd.tiddlywiki

package/editions/ja-JP/tiddlers/plugins/Share Plugin.tid

@@ -1,7 +1,7 @@
 created: 20201228143125000
-modified: 20241222103744408
-original-modified: 20201228143125000
-tags: OfficialPlugins
+modified: 20251214105341696
+original-modified: 20250302051857380
+tags: OfficialPlugins [[Plugin Editions]]
 title: Share Plugin
 ja-title: シェアプラグイン
 type: text/vnd.tiddlywiki
@@ -11,4 +11,6 @@ type: text/vnd.tiddlywiki
 この実験的なプラグインは、URL経由でTiddlerを共有するためのツールを提供します。これには以下が含まれます:
 
 * 起動時にブラウザのロケーションハッシュからTiddlerのグループをロードする機能
-* TiddlerのグループからURLを作成するためのウィザードとテンプレート
+* TiddlerのグループからURLを作成するためのウィザードとテンプレート
+
+デモは[ext[https://tiddlywiki.com/share|share]]を参照してください

package/editions/ja-JP/tiddlers/procedures/Procedure Calls.tid

@@ -0,0 +1,9 @@
+caption: プロシージャ呼び出し
+created: 20221007130006705
+modified: 20260429105903754
+original-modified: 20260125212303316
+title: Procedure Calls
+ja-title: プロシージャ呼び出し
+type: text/vnd.tiddlywiki
+
+<<.deprecated-since "5.4.0" "Calls">>

package/editions/ja-JP/tiddlers/procedures/Procedure Definitions.tid

@@ -0,0 +1,47 @@
+created: 20221007125701001
+modified: 20260329104617037
+original-modified: 20230921180332436
+tags: WikiText Procedures
+title: Procedure Definitions
+ja-title: プロシージャ定義
+type: text/vnd.tiddlywiki
+
+!! 紹介
+
+このTiddlerでは、[[プロシージャ|Procedures]]を定義するさまざまな方法について説明します。
+
+!! プロシージャ定義プラグマ
+
+プロシージャは、Tiddlerの先頭に[[プラグマ: \procedure|Pragma: \procedure]]を記述することで作成できます。定義は、そのプロシージャを定義したTiddlerの残りの部分、およびそのTiddlerをトランスクルードするすべてのTiddlerで使用できます。
+
+```
+\procedure my-procedure(param)
+これはプロシージャのテキストです (param=<<param>>)
+\end
+```
+
+[[プラグマ: \whitespace|Pragma: \whitespace]]の設定は、プロシージャ定義が行われるパースコンテキストから継承されることに注意してください。つまり、複数のプロシージャ定義を含むTiddlerの場合、Tiddlerの先頭に1つのwhitespaceプラグマを記述するだけでよく、プラグマを繰り返す必要なく、設定はプロシージャ定義に自動的に継承されます。
+
+!! Setウィジェットを使用したプロシージャ定義
+
+プロシージャは特殊な種類の[[変数|Variables]]として実装されているため、内部的には<<.wlink SetWidget>>ウィジェットによって定義されます。
+
+```
+<$set name="my-procedure" value="これはプロシージャのテキストです">
+...
+</$set>
+```
+
+<<.note """<<.wlink SetWidget>>ウィジェットを使用してプロシージャを定義する際に、現時点ではパラメータを指定することはできません。""">>
+
+!! プロシージャ定義のインポート
+
+[[プラグマ: \import|Pragma: \import]]や<<.wlink ImportVariablesWidget>>ウィジェットを使用すると、別のTiddlerからプロシージャ定義をコピーできます。
+
+!! `$:/tags/Global`タグ
+
+グローバルプロシージャは、[[システムタグ: $:/tags/Global|SystemTag: $:/tags/Global]]を使用して定義できます。
+
+[[システムタグ: $:/tags/Global/View|SystemTag: $:/tags/Global/View]]は、メインビューテンプレートとプレビューパネル内でのみ使用可能なプロシージャを定義するために使用します。
+
+[[システムタグ: $:/tags/Global/View/Body|SystemTag: $:/tags/Global/View/Body]]は、メインビューテンプレートの本文とプレビューパネル内でのみ使用可能なプロシージャを定義するために使用します。

package/editions/ja-JP/tiddlers/procedures/Procedure Parameter Handling.tid

@@ -0,0 +1,26 @@
+created: 20221007130538285
+modified: 20260329110806303
+original-modified: 20230419103154329
+tags: WikiText Procedures
+title: Procedure Parameter Handling
+ja-title: プロシージャパラメータの処理
+type: text/vnd.tiddlywiki
+
+!! 紹介
+
+プロシージャの内容がWiki化されると、[[プロシージャ|Procedures]]パラメータは変数として利用可能になります。
+
+!! パラメータを変数としてアクセス
+
+プロシージャをWiki化すると、パラメータを変数としてアクセスできるようになります。
+
+例えば:
+
+<$macrocall $name="wikitext-example-without-html" src="""\procedure say-hi(name,address)
+こんにちは、私は<<name>>です。<<address>>に住んでいます。
+\end
+
+<<say-hi name:"Bugs" address:"Rabbit Hole Hill">>
+"""/>
+
+パラメータを変数としてアクセスすることは、Wiki化されたプロシージャ内でのみ機能し、例えばプロシージャが属性値として使用される場合には機能しません。

package/editions/ja-JP/tiddlers/procedures/calls/Calls.tid

@@ -0,0 +1,66 @@
+caption: 呼び出し
+created: 20221007130006705
+modified: 20260429224543285
+original-modified: 20260301030947969
+tags: WikiText Procedures Functions Macros
+title: Calls
+ja-title: 呼び出し
+type: text/vnd.tiddlywiki
+
+!! 紹介
+
+このTiddlerでは、[[プロシージャ|Procedures]]、[[関数|Functions]]、[[マクロ|Macros]]を呼び出すさまざまな方法について説明します。構文の正式な説明については、[[呼び出し構文|Call Syntax]]を参照してください。
+
+!! トランスクルージョンショートカットでの呼び出し
+
+呼び出しを実行するには、呼び出し先の名前とパラメータ値を`<<`二重の山括弧で囲みます`>>`。
+
+```
+<<my-procedure param:"これはパラメータ値です">>
+```
+
+デフォルトでは、パラメータは定義と同じ順序で解釈されます。パラメータ値に名前と等号を付けることで、異なる順序でリストすることができます。
+
+パラメータに値が指定されていない場合は、[[プロシージャ定義|Procedure Definitions]]、[[関数定義|Function Definitions]]、[[マクロ定義|Macro Definitions]]でそのパラメータに指定されているデフォルト値が使用されます。(デフォルト値が定義されていない場合は、パラメータは空白になります。)
+
+各パラメータ値は、`'`シングルクォーテーション`'`、`"`ダブルクォーテーション`"`、`"""`三重のダブルクォーテーション`"""`、`[[`二重の角括弧`]]`で囲むことができます。三重のダブルクォーテーションを使用すると、値にほぼあらゆる文字列を含めることができます。値にスペース、シングルクォーテーション、ダブルクォーテーションが含まれていない場合は、区切り文字は不要です。シングルクォーテーション、または、三重のバッククォーテーションで囲まれた[[置換属性値|Substituted Attribute Values]]もサポートされています。
+
+[[パーサーモード|WikiText parser mode: macro examples]]に関する議論を参照してください。
+
+!!! 例
+
+<<testcase TestCases/Calls/ProcedureStaticAttributes>>
+
+<<testcase TestCases/Calls/ProcedureDynamicAttributes>>
+
+!! <<.wlink TranscludeWidget>>ウィジェットを用いた呼び出し
+
+ショートカット構文は、トランスクルードするプロシージャの名前を指定する`$variable`属性を持つ<<.wlink TranscludeWidget>>ウィジェットに展開されます。
+
+```
+<$transclude $variable="my-procedure" param="これはパラメータ値です"/>
+```
+
+ウィジェットは、ショートカット構文よりも柔軟性が高く、カスタムウィジェットで上書きすることも可能です。
+
+!! 呼び出し結果を属性値に割り当てる
+
+呼び出しから返されるテキストは、ウィジェットやHTML要素の属性に直接割り当てることができます。呼び出しの結果はWiki化されないため、[[パラメータ処理|Procedure Parameter Handling]]は行われません。
+
+```
+<div class=<<myclasses>>>
+...
+</div>
+```
+
+!! フィルタでの呼び出しの使用
+
+呼び出しはフィルタ内で使用できます。テキストはWiki化されないため、パラメータは無視されます。
+
+//現在サポートされているのはリテラル文字列パラメータのみであることに注意してください//
+
+```
+<$list filter="[<my-procedure>]">
+...
+</$list>
+```

package/editions/ja-JP/tiddlers/reference/Reference.tid

@@ -0,0 +1,17 @@
+created: 20140910212931897
+list: Concepts Definitions WikiText Macros Variables SystemTags Widgets Filters Messages Commands Mechanisms Developers
+modified: 20260216114219952
+original-modified: 20180927080640647
+tags: TableOfContents
+title: Reference
+ja-title: リファレンス
+type: text/vnd.tiddlywiki
+color: #F45757
+
+次のトピックでは、TiddlyWikiの正式リファレンスドキュメントを提供します: 
+
+<div class="tc-table-of-contents">
+
+<<toc-selective-expandable 'Reference'>>
+
+</div>

package/editions/ja-JP/tiddlers/roadmap/RoadMap.tid

@@ -1,11 +1,16 @@
 created: 20130823203800000
-modified: 20241226114145100
-original-modified: 2020051619421803
+modified: 20260406053945249
+original-modified: 20260220093010752
 tags: About
 title: RoadMap
 ja-title: ロードマップ
 type: text/vnd.tiddlywiki
 
-TiddlyWiki 5は現在、多くの人々に信頼されている成熟した安定したプロジェクトです。同時に、開発者とユーザーの幅広いコミュニティのおかげで、さまざまな方向に急速に進化しています。この逆説的な状況が可能なのは、プロジェクトが下位互換性を厳密に維持し、既存の機能に加えて新しい機能を追加しているためです
+TiddlyWikiは、オリジナルの[[TiddlyWiki Classic]]のリリースから9年後の2013年に初めてリリースされました。以来41回のリリースを経て、TiddlyWikiは着実に柔軟性と信頼性を高めてきました。将来に向けても、v5.4.x、v5.5.x、そして最終的にはTWXXといった野心的な計画があります。
 
-正式なロードマップはありませんが、検索と置換、リッチテキスト編集など、まだ完全に実装されていない領域がかなりあります。現在の作業は~GitHub(https://github.com/TiddlyWiki/TiddlyWiki5/)で確認できます
+バージョン番号はv5.x.0の形式に従っています。~TiddlyWikiは現在v<<version>>であり、現在v5.4.0に向けて取り組んでいます。
+
+GitHubには詳細なプロジェクト計画が掲載されていますが、主なマイルストーンは以下のとおり計画しています:
+
+* TiddlyWiki v5.4.0に続き、v5.4.xのリリースが順次行われ、バグ修正や機能の段階的な改善が行われます。重大な後方互換性の問題がある場合は、それらの改善は次リリースのv5.5.0に反映され、軽微な後方互換性の調整が行われます。
+* 今後、v5.6.0、v5.7.0などのリリースを続け、後方互換性を損なうことなく次のメジャーな再設計をリリースする準備が整うまで続けます。このリリースを~TiddlyWiki XX("~TiddlyWiki Twenty"、またはTWXX)と呼んでいます。

package/editions/ja-JP/tiddlers/saving/Encryption.tid

@@ -1,12 +1,12 @@
 created: 20130825160900000
-modified: 20241110103519303
-original-modified: 20160610083350724
+modified: 20260430074718157
+original-modified: 20250617140259415
 tags: Features [[Working with TiddlyWiki]]
 title: Encryption
 ja-title: 暗号化
 type: text/vnd.tiddlywiki
 
-TiddlyWiki5を単一のHTMLファイルとして使用すると、[[Stanford JavaScript Crypto Library]]を使用してコンテンツを暗号化できます。
+TiddlyWiki5を単一のHTMLファイルとして使用すると、[[Stanford JavaScript Crypto Library]]を使用してCCMモードのAES 256ビット暗号化でコンテンツを暗号化できます。
 
 # サイドバーの''ツール''タブに切り替えて、南京錠アイコンのボタンを探します
 # ボタンに<<.icon $:/core/images/unlocked-padlock>> ''パスワードの設定''と表示されている場合、現在のウィキは暗号化されていません。ボタンをクリックすると、以降の保存を暗号化するために使用されるパスワードの入力を求められます
@@ -16,5 +16,5 @@ TiddlyWiki5を単一のHTMLファイルとして使用すると、[[Stanford Jav
 
 TiddlyWikiには、パスワード/暗号化に関連する、2つの無関係な機能があることに注意してください: 
 
-* TiddlySpotに保存するときにパスワードを設定する機能。これは、''コントロールパネル'' <<.icon $:/core/images/options-button>>の"保存"タブで行います。
-* [[Node.js|TiddlyWiki on Node.js]]のサーバ構成で標準のHTTP基本認証を使用する機能。これは、ServerCommandを使用してコマンドラインで実行されます。SSLと組み合わせると、GoogleやDropboxなどのオンラインサービスで得られるのと同じレベルの暗号化転送が実現されますが、ディスク上のデータは暗号化されません
+* [[Tiddlyhost]]に保存するときにパスワードを設定する機能。これは、''コントロールパネル'' <<.icon $:/core/images/options-button>>の"保存"タブで行います。
+* [[Node.js|TiddlyWiki on Node.js]]のサーバ構成で標準のHTTP基本認証を使用する機能。これは、[[Listenコマンド|ListenCommand]]を使用してコマンドラインで実行されます。SSLと組み合わせると、GoogleやDropboxなどのオンラインサービスで得られるのと同じレベルの暗号化転送が実現されますが、ディスク上のデータは暗号化されません

package/editions/ja-JP/tiddlers/saving/Saving via WebDAV.tid

@@ -4,7 +4,8 @@ created: 20160216191710789
 delivery: Protocol
 description: SharePointなどの製品で利用できる標準Webプロトコル
 method: save
-modified: 20220615155048712
+modified: 20260204105130569
+original-modified: 20260102081028704
 tags: Android Chrome Firefox [[Internet Explorer]] Linux Mac Opera PHP Safari Saving Windows iOS Edge
 title: Saving via WebDAV
 ja-title: WebDAV経由の保存
@@ -20,6 +21,9 @@ type: text/vnd.tiddlywiki
 
 *   [[rclone|https://rclone.org/commands/rclone_serve_webdav/]]
 **  実行方法は次のようにシンプルです: <br/>`rclone serve webdav some_directory_containing_tiddlywiki_files`
+* [[copyparty|https://github.com/9001/copyparty]]
+** Copypartyには~WebDAVサーバが付属しています。`copyparty -v .::rwd:c,daw`を実行するだけで、カレントフォルダをサーバーとして公開し、[[http://[::1]:3923/]]にアクセスしてTiddlyWikiを利用できます
+** Copypartyが既存のファイルを上書きできるようにするには、読み取り、書き込み、削除の権限を付与し、`daw` volflagを追加する必要があることに注意してください。
 *   [[micromata dave - シンプルなWebDAVサーバー|https://github.com/micromata/dave]]
 * [[dav-server|https://github.com/edrex/dav-server]]はHTML ~TiddlyWikiのフォルダーを素早く提供する方法です。
 *   [[hacdias webdav server|https://github.com/hacdias/webdav/]]
@@ -45,6 +49,10 @@ type: text/vnd.tiddlywiki
 
 * RCXは、//rclone//をベースにしたAndroid用のオープンソースファイルマネージャーです。//F-Droid//と//Google Play//の両方で利用できます。統合されたWebDAVサーバーのおかげで、ポケットの中に保存しているwikiを編集できます。ローカルネットワーク上の他のデバイスと共有することもできます。
 
+!! iOS
+
+* ~WebDAVサーバーを提供できるネイティブアプリはありませんが、 [[iSH Shell|https://apps.apple.com/cn/app/ish-shell/id1436902243]]上でrcloneやcopypartyを、または、[[a-Shell|https://apps.apple.com/cn/app/a-shell/id1473805438]]上でcopypartyを使用できます。
+
 !! サーバー
 
 多くの[[NAS|https://en.wikipedia.org/wiki/NAS]]や[[Subversion|https://en.wikipedia.org/wiki/Apache_Subversion]]サーバーは特に何もしなくても~WebDAVをサポートします。ただし、独自のサーバーをセットアップするには、多少の手間がかかる場合があります:

package/editions/ja-JP/tiddlers/saving/Saving.tid

@@ -1,7 +1,7 @@
 created: 20140912140651119
 modified: 20241005104741984
 original-modified: 20220812144516626
-saving-browser: Firefox Chrome Edge [[Internet Explorer]] Safari Opera [[Standalone App]]
+saving-browser: Firefox Chrome Edge Safari Opera [[Standalone App]]
 saving-os: Windows Mac Linux Android iOS
 tags: [[Working with TiddlyWiki]]
 title: Saving
@@ -10,7 +10,7 @@ type: text/vnd.tiddlywiki
 
 
 \define alltagsfilter()  
-<$vars tag1="tag[" tag2="]" lb="[" rb="tag[Saving]sort[delivery]]">
+<$vars tag1="tag[" tag2="]" lb="[" rb="tag[Saving]sort[delivery]!tag[$:/deprecated]]">
 <$set filter="[list<stateTiddler>addprefix<tag1>addsuffix<tag2>]+[join[]addprefix<lb>addsuffix<rb>]" name="alltags" select=0>
 <$text text=<<alltags>>/>
 </$set>

package/editions/ja-JP/tiddlers/system/TableOfContents.tid

@@ -1,6 +1,6 @@
 caption: {{$:/language/SideBar/Contents/Caption}}
 created: 20140809114010378
-list: HelloThere [[Quick Start]] Learning [[Working with TiddlyWiki]] [[Customise TiddlyWiki]] Features Filters Languages Editions Plugins Platforms Reference Community About
+list: Welcome HelloThere [[Quick Start]] Learning [[Working with TiddlyWiki]] [[Customise TiddlyWiki]] Features Filters Languages Editions Plugins Platforms Reference Community About
 list-before: 
 modified: 20240929115051922
 original-modified: 20230322150307580

package/editions/ja-JP/tiddlers/system/download-empty.tid

@@ -2,7 +2,7 @@ title: $:/editions/ja-JP/download-empty
 type: text/vnd.tiddlywiki
 
 \define saveTiddlerFilter()
-[[$:/core]] [[$:/isEncrypted]] [[$:/themes/tiddlywiki/snowwhite]] [[$:/themes/tiddlywiki/vanilla]] [[$:/languages/ja-JP]] [[$:/language]] -[[$:/boot/boot.css]] -[type[application/javascript]library[yes]] -[[$:/boot/boot.js]] -[[$:/boot/bootprefix.js]] +[sort[title]]
+[[$:/core]] [[$:/isEncrypted]] [[$:/themes/tiddlywiki/snowwhite]] [[$:/themes/tiddlywiki/vanilla]] [[$:/languages/ja-JP]] [[$:/language]] -[[$:/boot/boot.css]] -[type[application/javascript]library[yes]] -[[$:/boot/boot.js]] -[[$:/boot/bootprefix.js]] -[has[plugin-type]field:platform[server]] +[sort[title]]
 \end
 \define savingEmpty()
 yes

package/editions/ja-JP/tiddlers/variables/Behaviour of variables invoked via widget attributes.tid

@@ -0,0 +1,15 @@
+created: 20230726143332803
+modified: 20260404110322627
+original-modified: 20240619210723396
+tags: [[Variable Usage]]
+title: Behaviour of variables invoked via widget attributes
+ja-title: ウィジェット属性を介して呼び出される変数の動作
+type: text/vnd.tiddlywiki
+
+|tc-first-col-min-width|k
+|!宣言方法|!動作|
+|\define|本文テキストに対してパラメータのテキスト置換が実行されます。それ以上の処理は行われません。テキスト置換後の結果が属性の値として使用されます|
+|<<.wlink SetWidget>>, <<.wlink LetWidget>>, <<.wlink VarsWidget>>, \procedure, \widget|本文はそのまま取得され、属性の値として使用されます|
+|\function|ファンクション(例: .myfun)が`<div class=<<.myfun>>/>`で呼び出されると、`<div class={{{[function[.myfun]]}}}/>`の同義になります。他のフィルタ付きトランスクルージョン(つまり、三重中括弧)と同様に、最初の結果以外はすべて破棄されます。最初の結果が属性の値として使用されます。この形式で呼び出された場合でも、ファンクションは再帰的に処理されることに注意してください。つまり、ファンクション内のフィルタ式は別のファンクションを呼び出すことができ、処理は継続されます|
+
+<<.from-version "5.4.0">> `<<var>>`の代わりに[[複数値変数の属性|Multi-Valued Variable Attribute Values]]構文`((var))`を使用すると、最初の値だけでなく、値のリスト全体が属性に渡されます。これは主に、TranscludeWidgetを介して[[複数値変数|Multi-Valued Variables]]をプロシージャや関数のパラメーターに渡す場合に便利です。

package/editions/ja-JP/tiddlers/wikitext/Anchor Links using HTML.tid

@@ -0,0 +1,202 @@
+created: 20190311094603013
+modified: 20260308111654603
+original-modified: 20201130064330388
+tags: [[HTML in WikiText]]
+title: Anchor Links using HTML
+ja-title: HTMLを使用したアンカーリンク
+
+<a id=<<qualify "#Top">>></a>
+
+<h2 id="#Introduction:Anchor-Links-using-HTML">''TiddlersでのHTMLアンカーリンク''</h2>
+
+
+
+* <a href=<<qualify "##Introduction">>>何をするものか?</a>
+* <a href=<<qualify "##How-do-I-make-them">>>どうやって作るか?</a>
+* <a href=<<qualify "##Anchor-link-limitations">>>制限と注意すべき点</a>
+* <a href=<<qualify "##More_examples">>>More examples</a>
+* <a href=<<qualify "##Suggestions-for-elements">>>使用するHTML要素の提案</a>
+* <a href=<<qualify "##Suggestions-for-ids">>>使用するターゲット名の提案</a>
+* <a href=<<qualify "##qualify-example">>>トランスクルードによるID重複の回避</a>
+* <a href=<<qualify ##Style_Hints>>>スタイルのヒント</a>
+
+<a id=<<qualify "#Introduction">>></a>
+
+!! 何をするものか?
+
+TiddlyWikiでは、アンカーリンクを使って、レンダリングしたTiddler内のターゲットポイントや個別のセクションにリンクすることができます。これにより、読者は長いTiddlerコンテンツ内を移動しやすくなります。
+
+例えば、このリンク<a href=<<qualify "##Bottom_of_tiddler">>>末尾</a>は、このTiddlerの一番下に移動します。その下の"先頭に戻る"リンクは、このTiddlerの一番上に戻ります。
+
+<a href=<<qualify "##Top">>>先頭に戻る</a>
+
+<a id=<<qualify "#How-do-I-make-them">>></a>
+
+!! どうやって作るか?
+
+アンカーリンクを作成する手順は2ステップだけです。
+
+* まず、希望する場所にターゲットポイント('アンカー'と呼ぶ)を作成します。
+* 次に、読者が必要とする可能性のある場所にリンクを追加します。
+
+それで終わりです。
+
+
+''ステップ1: 'アンカー'(リンクのターゲット)を作成する''
+
+```
+<a id="#Bottom_of_tiddler"></a>
+```
+
+* 任意のHTML5タグに<<.attr id>>属性を追加し、'アドレス'値の前に`#`を1つ配置します。<a href=<<qualify "##Suggestions-for-elements">>>使用できるタグの提案を紹介します。</a>
+* このコードをターゲットの場所に配置します。例: Tiddlerの末尾。
+
+''ステップ2: ターゲットのアンカーへのリンクを作成する''
+
+```
+<a href="##Bottom_of_tiddler">末尾</a>
+```
+* ターゲットとまったく同じ'アドレス'値を使用して`<a href>`リンクを作成しますが、その前に二重の`##`文字が付きます。
+* このコードを、読者にとって最も役立つ場所に配置します。
+
+上記の例は、このTiddlerの上部にある目次など、~TiddlyWikiのさまざまな状況に合わせて調整できます。
+
+''本当にそんなに簡単なのでしょうか? ''
+
+はい、とても簡単です。ただし... ~TiddlyWikiには、標準のHTML5アンカーリンクとは若干異なる点があり、~TiddlyWiki特有の制限もあります。
+
+<a href=<<qualify "##Top">>>先頭に戻る</a>
+
+<h2 id=<<qualify "#Anchor-link-limitations">>>制限と注意すべき点</h2>
+
+''ステップ1:'' ターゲットアンカーの作成
+
+* 標準HTML5 とは異なり、~TiddlyWikiでは、<<.attr id>>属性に続くターゲットアドレス値の前に1文字の`#`を書く必要があります。(例.1の#Bottom_of_tiddlerで使用されている1文字の`#`に注意してください。)
+* 標準のHTML5とは異なり、~TiddlyWikiのアンカーリンクは大文字と小文字を区別します。上記の例では、#Bottom_of_tiddlerは機能しますが、#bottom_of_Tiddlerは機能しません。
+* 一部のブラウザでは、%文字を含むアンカーへのナビゲーションが失敗するバグがあるため、リンクでは%文字を使用しないでください(以下の警告を参照)。
+* <a id=<<qualify #note.1-return>>/>リンク内に空白を使用しないでください(下記の<a href=<<qualify ##note.1>> title="クリックすると注.1に進む">注.1</a>を参照)。
+* 各リンクアドレスはTiddlyWiki内で一意である必要があります。トランスクルージョンによって同じ<<.attr id>>属性のインスタンスが複数作成された場合、上記の条件を満たす最初のインスタンスにナビゲーションが行われます。これを回避するには、次の例と同様のスタイルで、<<.attr id>>属性と<<.attr href>>属性の両方に[[qualifyマクロ|qualify Macro]]を使用します: <a href=<<qualify ##qualify-example>> >トランスクルージョン時にIDの重複を回避する</a>
+
+''ステップ2:'' ターゲットへのリンクの作成
+
+* <<.attr href>>の値は、ターゲットアンカーの<<.attr id>>の値より1文字多い''2文字''の`#`で始まる必要があることに注意してください。 
+* ~TiddlyWikiのアンカーリンクは大文字と小文字が区別されることに注意してください
+
+''ステップ3:'' ターゲットへの移動
+
+通常、リンクをクリックすると、~TiddlyWikiはウィンドウをスクロールして、ターゲットのアンカーがウィンドウの上部に表示されるようになりますが、いくつかの制限があります: 
+
+* ~TiddlyWikiのアンカーリンクは、Tiddlerがストーリーリバー内にない場合、またはサイドバーに表示されていない場合は機能しません。
+* ~TiddlyWikiのアンカーリンクは、Tiddlerがストーリーリバーやサイドバーにあるものの、アンカーでマークされたターゲットポイントがページ上に表示されていない場合(例: Tiddlerが折りたたまれている、または、アンカーが非表示の$revealウィジェット内にある、など)には機能しません。このようなアンカーリンクをCtrl+クリックすると、新しいブラウザウィンドウ/タブが開き、ベースのウェブページが読み込まれ、期待されるTiddlerには移動しません。
+* コントロールパネル > 外観 > 表示スタイルがzoomin(単一ページビュー)に設定されており、Tiddlerがストーリーリバーの先頭にない場合(つまり、表示されていない場合)、Tiddlywikiのアンカーリンクは機能しません。
+* アンカーリンクをクリックすると、ブラウザのナビゲーション履歴が更新され、リンクのhref値がウェブページのURLに追加されます。これは、コントロールパネル > 設定 > 操作履歴の値が"履歴を残さない"に設定されている場合でも発生します。
+
+<$macrocall $name=.note _="""<span id=<<qualify #note.1>>><a href=<<qualify ##note.1-return>> title="click to return">1.</a></span> [ext[HTML5の仕様|https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id]]では、<<.attr id>>属性の値に空白文字を含めてはならないとされています。現在 ^^(2020年12月)^^では、空白文字を含む<<.attr id>>値でも動作する場合があります。ただし、すべてのブラウザで動作するとは限らず、将来的にも動作が保証されるものではありません。"""  />
+
+<<.warning "一部のブラウザでは、 ''id''値に`%`文字と2桁の数字が含まれるアンカーターゲットへの移動に失敗する場合があります。これはブラウザのバグであり、~TiddlyWikiでは修正できません。安全のため、`%`文字の使用は避けてください。">>
+
+<a href=<<qualify "##Top">>>先頭に戻る</a>
+
+<h2 id=<<qualify "#More_examples">>>その他の例</h2>
+いずれの場合も、ターゲットコードは読者が移動する先に配置され、リンクコードは読者の移動元となる場所に配置されます。
+
+```
+<h2 id="#heading-01"> ターゲットの見出し</h2>
+
+<a href="##heading-01">ターゲットの見出しへのリンク</a>
+
+```
+
+次のようになります:
+
+<hr>
+<h2 id="#heading-01">ターゲットの見出し</h2>
+
+<a href="##heading-01">ターゲットの見出しへのリンク</a>
+<hr>
+
+```
+<section id="#unique001">
+
+!! ターゲットのセクション
+
+HTMLタグ`<section>`は通常、章、ヘッダー、フッター、ドキュメントのその他のセクションなど、HTMLドキュメント内のセクションを定義するために使用されます。
+</section>
+
+このアンカーリンクをクリックすると、<a href="##unique001">ターゲットのセクションへのリンク</a>に移動します。
+```
+
+次のようになります:
+
+<hr>
+<section id="#unique001">
+
+!! ターゲットのセクション
+
+HTMLタグ`<section>`は通常、章、ヘッダー、フッター、ドキュメントのその他のセクションなど、HTMLドキュメント内のセクションを定義するために使用されます。
+</section>
+
+このアンカーリンクをクリックすると、<a href="##unique001">ターゲットのセクションへのリンク</a>に移動します。
+<hr>
+
+<a href=<<qualify "##Top">>>先頭に戻る</a>
+
+<h2 id=<<qualify "#Suggestions-for-elements">>>''使用するHTML要素の提案''</h2>
+
+<<.attr id>>属性を使用して位置をマークするHTML要素の提案:
+
+| ! 要素 | ! サンプルコード | ! 備考 |
+|<<.def anchor>> |<$text text="""<a id="#part001-of-TiddlerName"></a>"""/> |どこでも完璧に動作するはず|
+|<<.def heading>> |<$text text="""<h2 id="#a-new-heading">新しい見出し</h2>"""/>|見出しにも<<.attr id>>属性を持たせることができる|
+|<<.def section>> |<$text text="""<section id="#sect001-of-TiddlerName">これは新しいセクションです</section>"""/>|`section`要素を使用する場合、独自の<<.attr id>>を持つべき|
+|<<.def span>> |<$text text="""<span id="#007">ここにマーカー007があります</span>"""/>|`span`要素を使用して段落の途中に<<.attr id>>を挿入することができる|
+
+<a href=<<qualify "##Top">>>先頭に戻る</a>
+
+<h2 id=<<qualify "#Suggestions-for-ids">>>使用するターゲット名の提案</h2>
+
+| ! | ! サンプルコード | ! 備考 |
+|<<.def 推奨>> |<$text text="""<a id="#part001-of-TiddlerName"></a>"""/> |Tiddler名を含めてると、一意の<<.attr id>>が簡単にできます|
+|<<.def "回避: 空白">> |<$text text="""<h2 id="#0 0 1">新しい見出し</h2>"""/>|空白はすべてのブラウザで機能するとは保証されません|
+|<<.def "回避: %">> |<$text text="""<section id="#sect001%20of%20TiddlerName">これは新しいセクションです</section>"""/>|URIエンコード(スペースを%20に変換する等)は一部のブラウザで機能しない可能性があります|
+|<<.def "回避: 重複ID">> |<$text text="""<span id="#007">ここにマーカー007があります</span>"""/>|<<.attr id>>値はWiki全体で一意である必要があります|
+|<<.def "回避: 重複ID">> |<$text text="""<a id="#007"></a>"""/>別のマーカー007です|<<.attr id>>値が重複している場合、一方が無視されます|
+
+<a href=<<qualify "##Top">>>先頭に戻る</a>
+
+<h2 id=<<qualify "#qualify-example">>> ''トランスクルードによるID重複の回避''</h2>
+<<.attr id>>とこのヘッダーへのアンカーリンクは次のように作成されています:
+
+```
+<a href=<<qualify "##qualify-example">>>トランスクルードによるID重複の回避</a>
+
+<h2 id=<<qualify "#qualify-example">>>トランスクルードによるID重複の回避</h2>
+```
+;これが機能するために:
+
+* <<.attr href>>と<<.attr id>>の値は、[[属性のマクロ呼び出し構文|HTML in WikiText]]が使用され、[[qualifyマクロ|qualify Macro]]を使用して一意の<<.attr id>>値が作成されます。
+* <<.attr id>>とアンカーリンクは両方とも同じTiddler内にある必要があります。
+* `=`と`<<`の間には引用符を入れないでください。
+* ターゲット名を囲む二重引用符はオプションですが、推奨されます。
+* ターゲット名の後には、`<<qualify`マクロを閉じる2つの`>>`文字と、`<a`タグを閉じる1つの`>`文字、全部で3つの`>`文字が必要です。
+
+<a href=<<qualify "##Top">>>先頭に戻る</a>
+
+<h2 id=<<qualify #Style_Hints>>>''スタイルのヒント'' </h2>
+
+リンクを外部リンクのように見せたくない場合は、`<a>`要素の<<.attr class>>属性に値<<.def tc-tiddlylink>>を指定します。また、リンクを斜体と太字にしたい場合は、以下のように追加のクラス<<.def "tc-tiddlylink-missing tc-tiddlylink-shadow">>を指定します。
+
+```
+<a class="tc-tiddlylink" href="##Introduction:Anchor-Links-using-HTML">先頭に戻る</a> または、<a class="tc-tiddlylink tc-tiddlylink-missing tc-tiddlylink-shadow" href=<<qualify ##Hints>>ヒント</a>に戻る.
+```
+<a class="tc-tiddlylink" href="##Introduction:Anchor-Links-using-HTML">先頭に戻る</a> または、<a class="tc-tiddlylink tc-tiddlylink-missing tc-tiddlylink-shadow" href=<<qualify ##Style_Hints>>>スタイルのヒント</a>に戻る.
+
+サイドバーの目次のリンクに<<.attr id>>属性を含める場合は、以下に示す方法と同様に、リストされたTiddlerの<<.field caption>>フィールドに属性を含めることができます:
+
+```
+<span id=#some-value>キャプション</span>
+```
+
+<a id=<<qualify "#Bottom_of_tiddler">>></a>
+
+<a href=<<qualify "##Top">>>先頭に戻る</a>