tiddlywiki 5.3.4 → 5.3.6

package/editions/ja-JP/tiddlers/howtos/Constructing JSON tiddlers.tid

@@ -0,0 +1,18 @@
+created: 20220427174702859
+modified: 20241019104110533
+original-modified: 20230922122551197
+tags: [[JSON in TiddlyWiki]] Learning
+title: Constructing JSON tiddlers
+ja-title: JSON Tiddlerの構築
+
+TiddlyWikiでのJSONの使い方の概要については、[[TiddlyWikiでのJSON|JSON in TiddlyWiki]]を参照してください
+
+JSONデータは単なるプレーンテキストであるため、Wikiテキストで生成するためのさまざまな手法が存在します
+
+高いレベルでは、TiddlyWiki独自のTiddler形式でJSONデータを生成する方法がいくつかあります: 
+
+* [[JSONTiddlerウィジェット|JSONTiddlerWidget]]
+* [[jsontiddlerマクロ|jsontiddler Macro]]
+* [[jsontiddlersマクロ|jsontiddlers Macro]]
+
+JSONデータを手動で構築する場合、特殊文字が適切にエスケープされていることを確認するために[[jsonstringifyオペレーター|jsonstringify Operator]]が必要です

package/editions/ja-JP/tiddlers/howtos/Creating SubStories.tid

@@ -0,0 +1,34 @@
+created: 20140214215718317
+modified: 20241016112045089
+original-modified: 20211127032217828
+tags: Learning
+title: Creating SubStories
+ja-title: サブストーリーを作成する
+type: text/vnd.tiddlywiki
+
+この例では、メイン[[ストーリー|Story River]]から独立したTiddler内にサブストーリーを作成する方法を示します。NavigatorWidgetとListWidgetを連携します:
+
+# リンクをクリックすると、[[ストーリー|Story River]]にTiddlerを追加します。リンクのクリックに対応するTiddlerに移動します(NavigatorWidgetの''story''属性)
+# Tiddlerの閉じるボタンがクリックされたときに、[[ストーリー|Story River]]からTiddlerを削除します(NavigatorWidgetの''story''属性)
+# Tiddlerの開閉をアニメーションします(ListWidgetの''storyview''属性)
+# 開いているTiddlerのリストを表示します(ListWidgetの''filter''属性と''template''属性)
+# Tiddlerを[[ドラフトモード|DraftMechanism]]で表示します(ListWidgetの''editTemplate''属性)
+# [[ナビゲーション履歴|HistoryMechanism]]を追跡します(NavigatorWidgetとListWidgetの両方の''history''属性)
+# そのほかいろいろ!
+
+コード例は次のとおりです(関連する議論については、StateMechanismも参照してください):
+
+<$macrocall $name='wikitext-example-without-html'
+src='<$navigator story="$:/temp/DemoStoryList" history="$:/temp/DemoHistoryList">
+
+{{$:/core/ui/SideBarSegments/search}}
+
+<$list
+  filter="[list[$:/temp/DemoStoryList]]"
+  history="$:/temp/DemoHistoryList"
+  template={{$:/config/ui/ViewTemplate}}
+  editTemplate={{$:/config/ui/EditTemplate}}
+  storyview="classic"
+  emptyMessage="上の検索ボックスを使用してください。クリックした検索リンクは、メインストーリーではなくここで開きます<p>何を検索すればよいか浮かびませんか?では、このリンクをクリックしてください:[[こんにちは|HelloThere]]</p>"/>
+
+</$navigator>'>

package/editions/ja-JP/tiddlers/howtos/Editing Tiddlers with Emacs.tid

@@ -0,0 +1,40 @@
+created: 20140406210404245
+modified: 20241017113402647
+original-modified: 20140919161501896
+tags: Learning
+title: Editing Tiddlers with Emacs
+ja-title: TiddlerをEmacsで編集する
+type: text/vnd.tiddlywiki
+
+Michael Foglemanは、TiddlyWikiの.tidファイルを編集するための[[tid-mode|https://github.com/mwfogleman/tid-mode]]と呼ばれる[[Emacs|http://www.gnu.org/software/emacs/]]のメジャーモードを作成しました。これはtext-modeから派生し、便利なマイナーモードorg-structとsubwordを使用し、.tidファイルを保存するときに変更時刻を更新します
+
+彼はまた、EmacsでTiddlyWikiを使用するための2つのヘルパー関数も作成しました。1つ目は、DiredでTiddlerディレクトリを開きます。2つ目はブラウザでTiddlyWikiを開きます
+
+```
+(defun open-wiki ()
+  "Opens a TiddlyWiki directory in Dired."
+  (interactive)
+  (dired "~/Dropbox/wiki/tiddlers/"))
+```
+  
+```
+(defun browse-wiki ()
+  "Opens TiddlyWiki in the browser."
+  (interactive)
+  (browse-url "127.0.0.1:8080/"))
+```
+
+後者の関数では、ブラウザの指定が必要になる場合があります:
+
+```
+(setq browse-url-browser-function 'browse-url-generic
+      browse-url-generic-program "chromium")
+```
+
+これらの関数をglobal-set-key関数でバインドできます:
+
+```
+(global-set-key (kbd "C-c w") 'open-wiki)
+```
+
+現時点では、これらはtid-modeに統合されていません

package/editions/ja-JP/tiddlers/howtos/Editing Tiddlers with Vim.tid

@@ -0,0 +1,11 @@
+modified: 20241020104154015
+original-modified: 20160111190002
+created: 20140406210404245
+tags: Learning
+title: Editing Tiddlers with Vim
+ja-title: TiddlerをVimで編集する
+type: text/vnd.tiddlywiki
+
+Devin Weaverは https://github.com/sukima/vim-tiddlywiki に[[Vim|http://www.vim.org/]]プラグインを作成しました
+
+TiddlyWikiのシンタックスのほとんどをサポートしており、`modified`フィールドを自動更新するファイルタイププラグインが含まれています

package/editions/ja-JP/tiddlers/howtos/Editor toolbar.tid

@@ -0,0 +1,22 @@
+created: 20160817093933820
+modified: 20241104105233416
+original-modified: 20190118161349442
+tags: Features [[Formatting text in TiddlyWiki]]
+title: Editor toolbar
+ja-title: エディタツールバー
+type: text/vnd.tiddlywiki
+
+!! 使い方
+
+エディタツールバーは、テキストのフォーマットを簡単に設定するのに役立つツールバーです。編集モードの場合、Tiddlerのテキスト入力フィールドの上に表示されます。Microsoft WordやLibre Office Writeなどのデスクトップテキストエディターと似た外観をしています
+
+!! エディタツールバーの機能
+機能ボタンを押すと、テキストフィールドにWikiTextが挿入されます。例えば、太字のボタンを押すと、`'' ''`が挿入されます
+
+テキストの一部を''選択''していると、マークアップコードが選択されたテキストを自動的に囲みます
+
+[[MarkDown|Markdown Plugin]]などの別のモードを使用している場合は、ツールバーがその構文に変更され、適切なコードが挿入されます。ただし、以前に入力したテキストやマークアップは変更されません
+
+標準のWikiTextフォーマットに加えて、エディタツールバーには次のボタンがあります: 
+
+<<list-links "[tag[Editor toolbar]sort[title]]">>

package/editions/ja-JP/tiddlers/howtos/Formatting List Results as Tables with CSS - Specified Columns Methods.tid

@@ -0,0 +1,51 @@
+created: 20161209172820513
+modified: 20241020104954951
+original-modified: 20161220161653258
+tags: Learning
+title: Formatting List Results as Tables with CSS - Specified Columns Methods
+ja-title: CSSを使用してリスト結果を表フォーマットで出力する - 固定列メソッド
+type: text/vnd.tiddlywiki
+
+``<$list>``ウィジェットの結果を単純な1つのリストではなく、複数列の形式でフォーマットしたい場合があります。この方法では、~CSSを使用してリストを列として設定し、必要な列の数がわかっていることを前提としています。ここでの方法は、テーブルに含める列の数を反映するスタイルを作成し、そのスタイルを結果のリスト出力に適用することです
+
+他のテーブル作成テクニックについては、以下も参照してください: 
+
+* [[CSSを使用してリスト結果を表フォーマットで出力する - 可変列メソッド|Formatting List Results as Tables with CSS - Variable Column Method]]
+* [[リスト結果を表フォーマットで出力する(CSS無し)|Formatting List Results as Tables (no CSS)]]
+
+
+!!! 1) `$:/tags/Stylesheet`でタグ付けされた列に対して、以下を含むTiddlerを作成します:
+
+```
+/* FOUR COLUMN MODE */
+.fourcolumns {
+   display:block;
+   column-count:4;
+   column-gap:1em;
+   -moz-column-count:4;
+   -moz-column-gap:1em;
+   -webkit-column-count: 4;
+   -webkit-column-gap:1em;
+}
+```
+
+列数を示す値がさまざまな場所に必要なことに注意してください
+
+!!! 2) 次に、出力を次のようにフォーマットします: 
+
+```
+@@.fourcolumns
+<$list filter="[tag[Filter Operators]]" variable="foo">
+<<foo>><br>
+</$list>
+@@
+```
+
+!! フィルター演算子の一部のリストを示す例
+
+@@.fourcolumns
+<$list filter="[tag[Filter Operators]limit[24]]" variable="foo">
+<<foo>><br>
+</$list>
+@@
+

package/editions/ja-JP/tiddlers/howtos/Formatting List Results as Tables with CSS - Variable Column Method.tid

@@ -0,0 +1,85 @@
+created: 20161209172820513
+modified: 20241020105248614
+original-modified: 20161220162845058
+tags: Learning
+title: Formatting List Results as Tables with CSS - Variable Column Method
+ja-title: CSSを使用してリスト結果を表フォーマットで出力する - 可変列メソッド
+type: text/vnd.tiddlywiki
+
+``<$list>``ウィジェットの結果を単純な1つのリストではなく、複数列の形式でフォーマットしたい場合があります。この方法では、CSSを使用してリストを列として設定します。応答性が高く、ウィンドウが小さすぎる場合は、表示する列の数を減らすために改行位置を変更します
+
+固定の列数を直接指定するのではなく、リストの最大幅(Tiddlerの幅をトランスクルージョンする可能性があります)と各項目の幅を指定します。左から右にリストされ、新しい行に折り返されます
+
+他のテーブル作成テクニックについては、以下も参照してください: 
+
+* [[CSSを使用してリスト結果を表フォーマットで出力する - 固定列メソッド|Formatting List Results as Tables with CSS - Specified Columns Methods]]
+* [[リスト結果を表フォーマットで出力する(CSS無し)|Formatting List Results as Tables (no CSS)]]
+
+!! 既存の~TiddlyWikiタグ50個を使用したリストの例
+
+```
+<div class="dynamic-table">
+  <$list filter="[has[tags]tags[]sort[title]first[50]]">
+    <span class="item">
+      <$transclude tiddler="$:/core/ui/TagTemplate"/>
+    </span>
+  </$list>
+</div>
+```
+
+!! リストで使用するスタイルシートの例
+
+```
+<style>
+.dynamic-table {
+  max-width:700px; /* could transclude tiddler width instead */
+  -ms-box-orient: vertical; /* might be unnecessary */
+  display: -webkit-box;
+  display: -moz-box;
+  display: -ms-flexbox;
+  display: -moz-flex;
+  display: -webkit-flex;
+  display: inline-flex;
+  -webkit-flex-wrap: wrap;
+  flex-wrap: wrap;
+  flex-direction: row;
+}
+
+.item {
+  max-width:160px; min-width:160px;
+  flex: 0 0 2em; /* -grow, -shrink, -basis */
+}
+</style>
+```
+
+!! 結果
+
+<div class="dynamic-table">
+  <$list filter="[has[tags]tags[]sort[title]first[50]]">
+    <span class="item">
+      <$transclude tiddler="$:/core/ui/TagTemplate"/>
+    </span>
+  </$list>
+</div>
+
+<style>
+.dynamic-table {
+  max-width:700px; /* could transclude tiddler width instead */
+  -ms-box-orient: vertical;
+  display: -webkit-box;
+  display: -moz-box;
+  display: -ms-flexbox;
+  display: -moz-flex;
+  display: -webkit-flex;
+  display: inline-flex;
+  -webkit-flex-wrap: wrap;
+  flex-wrap: wrap;
+  flex-direction: row;
+}
+
+.item {
+  max-width:160px; min-width:160px;
+  flex: 0 0 2em; /* -grow, -shrink, -basis */
+}
+</style>
+

package/editions/ja-JP/tiddlers/howtos/Formatting_List_Results_as_Tables_(no_CSS).tid

@@ -0,0 +1,51 @@
+created: 20161220154952676
+modified: 20241020104643991
+original-modified: 20161220161706470
+tags: Learning
+title: Formatting List Results as Tables (no CSS)
+ja-title: リスト結果を表フォーマットで出力する(CSS無し)
+type: text/vnd.tiddlywiki
+
+``<$list>``ウィジェットの結果を単純な1つのリストではなく、複数列の形式でフォーマットしたい場合があります。次のメソッドでは、実際のテーブル構造を作成し、[[n番目の演算子|nth Operator]]を使用して各行の改行を実現します。この方法では応答性はありません。つまり、ウィンドウが小さすぎる場合、表示する列を減らすための位置変更を行いません
+
+一番外側のリスト構造では、項目番号に改行が発生することを示すカウントを指定する必要があります。したがって、次の例では、各行は4個の項目の後で区切られるため、順序は1、5、9、・・・になります。これには、存在する項目の最大数を事前に知っておく必要があることに注意してください。n-1個の項目に設定される内部制限もあります(nは必要な列の数です)
+
+内側の`<$list>`ウィジェット内で駆動フィルター演算子を繰り返す必要があることにも注意してください。明らかに、このテクニックはマクロの実装に役立ちます
+
+他のテーブル作成テクニックについては、以下も参照してください: 
+
+* [[CSSを使用してリスト結果を表フォーマットで出力する - 可変列メソッド|Formatting List Results as Tables with CSS - Variable Column Method]]
+* [[CSSを使用してリスト結果を表フォーマットで出力する - 固定列メソッド|Formatting List Results as Tables with CSS - Specified Columns Methods]]
+
+!! 項目数が70未満の4列テーブルのコード例
+
+```
+<table>
+<$list filter="1 5 9 13 17 21 25 29 33 37 41 45 49 53 57 61 65" variable ="rows">
+    <$list filter="[tag[Filter Operators]limit[50]] +[nth<rows>]" variable="cell">
+        <tr>
+        <td> <<cell>> </td>
+        <$list filter="[tag[Filter Operators]limit[50]] +[allafter<cell>limit[3]]" variable="this">
+            <td> <<this>> </td>
+        </$list>
+        </tr>
+    </$list>
+</$list>
+</table>
+```
+
+!! 結果
+
+<table>
+<$list filter="1 5 9 13 17 21 25 29 33 37 41 45 49 53 57 61 65" variable ="rows">
+    <$list filter="[tag[Filter Operators]limit[50]] +[nth<rows>]" variable="cell">
+        <tr>
+        <td> <<cell>> </td>
+        <$list filter="[tag[Filter Operators]limit[50]] +[allafter<cell>limit[3]]" variable="this">
+            <td> <<this>> </td>
+        </$list>
+        </tr>
+    </$list>
+</$list>
+</table>
+

package/editions/ja-JP/tiddlers/howtos/Height of text editor.tid

@@ -0,0 +1,8 @@
+created: 20160817103854725
+modified: 20241104105649800
+original-modified: 20160817105415313
+tags: [[Editor toolbar]]
+title: Height of text editor
+ja-title: テキストエディタの高さ
+
+{{ $:/core/ui/EditorToolbar/editor-height}}ボタンを使用すると、テキスト入力フィールドの高さを調整できます。

package/editions/ja-JP/tiddlers/howtos/How to add a banner for GitHub contributions.tid

@@ -0,0 +1,22 @@
+title: How to add a banner for GitHub contributions
+ja-title: GitHub投稿のバナーを追加する方法
+modified: 20241023113051454 
+original-modified: 20141123094403948
+created: 20141123094403948
+tags: Learning
+
+https://tiddlywiki.com でTiddlerを編集すると、GitHubでTiddlerのソースを編集するように促す小さなリボンが表示されます。
+
+Node.jsを使用している場合は、次のようにして、この機能を独自のTiddlyWikiベースのサイトに複製できます:
+
+# [[Wikiフォルダー|TiddlyWikiFolders]]の<$link to="tiddlywiki.info Files">`tiddlywiki.info`</$link>ファイルに次の設定が含まれていることを確認してください: 
+#> <pre><code>	"config": {
+		"retain-original-tiddler-path": true
+	}</code></pre>
+# Wikiに[[$:/ContributionBanner]]Tiddlerをコピーします
+# 次のように編集します:
+## https://github.com/TiddlyWiki/TiddlyWiki5/edit/master/editions/tw5.com/tiddlers/ から、自分のGitHubリポジトリを指すように、GitHubリンクURLを修正します
+## "Can you help us improve this documentation?"で始まるテキストの文言が訪問者にとって適切であることを確認してください
+## [[Improving TiddlyWiki Documentation]]へのリンクを調整して、投稿の手順の説明が記載された独自のTiddlerを指すようにします。
+
+

package/editions/ja-JP/tiddlers/howtos/How to change the sort order of sub-branches in a TOC macro.tid

@@ -0,0 +1,27 @@
+created: 20161209172820513
+modified: 20241020110058381
+original-modified: 20190220000000000
+tags: Learning
+title: How to change the sort order of sub-branches in a TOC macro
+ja-title: TOCマクロでのサブブランチのソート順を変更する方法
+type: text/vnd.tiddlywiki
+
+次のような[[目次|Table-of-Contents Macros]]マクロを使用していると想定します: 
+
+```
+<<toc-selective-expandable  "TableOfContents" "sort[title]">>
+```
+
+多くの場合、並び順は問題ありませんが、`Journal`タグ付けされたアイテムを`created`フィールドの順に並べ替えたいとします。`Journal`タグ付けされたサブ項目だけに別の並べ替え順を適用するにはどうすればよいでしょうか?
+
+秘訣は、別の並べ替え基準を指すフィールドを、親のタグTiddler(つまり、`Journal`)に追加することです。そのフィールドを`fuzzy`と呼び、値`created`を入力します(`created `はTiddlerの作成日を持つフィールドの名前です)
+
+次に、[[目次|Table-of-Contents Macros]]を次のように変更します: 
+
+```
+<<toc-selective-expandable  "TableOfContents" "sort{!!fuzzy}">>
+```
+
+これで、`created `の日付順に並べ替えられる`Journal`Tiddlerの子を除き、目次はどこでもタイトル順に並べ替えられるようになります
+
+このトリックの欠点は、1つの特別なフィールドのみに逆順ソートを適用できないことです。並べ替え順序を逆順にすると、どこも逆になります

package/editions/ja-JP/tiddlers/howtos/How to create a custom story tiddler template.tid

@@ -0,0 +1,42 @@
+created: 20211204120244761
+modified: 20241024105517309
+original-modified: 20211206165108185
+tags: Learning Cascades [[Story Tiddler Template]] [[Story Tiddler Template Cascade]] [[Customise TiddlyWiki]]
+title: How to create a custom story tiddler template
+ja-title: カスタムストーリーTiddlerテンプレートを作成する方法
+type: text/vnd.tiddlywiki
+
+ここでは、[[ストーリーTiddlerテンプレートカスケード|Story Tiddler Template Cascade]]にルールを追加して、<<tag "$:/tags/TiddlerList">>タグを付けたTiddlerをリストフィールドに名前が付けられたTiddlerのサムネイルを組み込んだカスタム外観で表示する方法を示します。
+
+デモを表示するには、[[カスタムストーリーTiddlerテンプレートを含むデモTiddlerリスト|Demo Tiddler List with Custom Story Tiddler Template]]を開きます。
+
+最初に、ストーリーTiddlerテンプレートカスケードに新しいステップを追加します。新しいフィルターステップは次のとおりです: 
+
+```
+[tag[$:/tags/TiddlerList]then[$:/_tw5.com/CustomStoryTiddlerTemplateDemo/Template]]
+```
+
+次のように読むことができます:
+
+```
+Tiddlerが$:/tags/TiddlerListタグを持つなら、$:/_tw5.com/CustomStoryTiddlerTemplateDemo/Templateを返します
+```
+
+> テンプレート$:/_tw5.com/CustomStoryTiddlerTemplateDemo/Templateも、 [[$:/_tw5.com/CustomStoryTiddlerTemplateDemo/Styles]]で定義したスタイルに依存します。
+
+ストーリーTiddlerテンプレートカスケードはタグ<<tag "$:/tags/StoryTiddlerTemplateFilter">>によって定義されます。そのため、そのタグを使用してTiddlerを作成する必要があります。
+
+また、カスケード内の正しいポイントに挿入されていることを確認する必要があります:
+
+* 新しいルールは、タグ$:/tags/TiddlerListが付いたドラフトTiddlerが編集できるようにするために、"draft"ルールの後に置く必要があります。
+* 新しいルールは"default"ルールの前になければなりません。そうでないと実行されません。
+
+コントロールパネルの"カスケード"タブには、`list-before`フィールドを使用してdefaultのステップの直前に新しいステップを挿入できることが示されています。
+
+構成Tiddlerの完全なフィールドのリストは次のとおりです:
+
+<<.tiddler-fields "$:/_tw5.com/CustomStoryTiddlerTemplateDemo/Filter">>
+
+最後に、デモTiddlerを作成する必要があります:
+
+<<.tiddler-fields "Demo Tiddler List with Custom Story Tiddler Template">>

package/editions/ja-JP/tiddlers/howtos/How to create a custom tiddler colour rule.tid

@@ -0,0 +1,38 @@
+created: 20211206114114698
+modified: 20241020110542022
+original-modified: 20211206165150302
+tags: Learning Cascades [[Customise TiddlyWiki]]
+title: How to create a custom tiddler colour rule
+ja-title: カスタムのTiddlerカラールールを作成する方法
+type: text/vnd.tiddlywiki
+
+ここでは、[[Tiddlerカラーカスケード|Tiddler Colour Cascade]]に、<<tag "TableOfContents">>タグを持つTiddlerに明るい青色の着色を、<<tag "Working with TiddlyWiki">>タグを持つTiddlerに濃い紫色の着色を、付与するルールの追加方法を示します。
+
+<<.tip "[[カスタムのTiddlerアイコンルールを作成する方法|How to create a custom tiddler icon rule]]では、同じTiddlerにカスタムアイコンを与える方法について説明します。">>
+
+まず、Tiddlerカラーカスケードに新しいステップを追加します。新しいフィルターステップは次のとおりです。:
+
+```
+[tag[TableOfContents]then[#1e90ff]]
+[tag[Working with TiddlyWiki]then[darkorchid]]
+```
+
+これは次のように読み取れます。:
+
+```
+もしTiddlerが"TableOfContents"タグを持つなら、カラー#1e90ffを返します
+もしTiddlerが"Working with TiddlyWiki"タグを持つなら、カラーdarkorchidを返します
+```
+
+Tiddlerカラーカスケードは<<tag "$:/tags/TiddlerColourFilter">>タグによって定義されます。したがって、そのタグを使用して設定Tiddlerを作成する必要があります。
+
+また、カスケード内の正しい位置に挿入されていることを確認する必要があります。:
+
+* 新しいルールは、明示的な''color''フィールドを持つTiddlerがそのフィールドの値を確実に尊重するように、"colour-field"ルールの後に置く必要があります。
+* 新しいルールは"default"カラーの前になければなりません。そうしないと、デフォルトのカラーが指定されていると、着色されることはありません。
+
+コントロールパネルの"カスケード"タブには、`list-before`フィールドを使用してデフォルトステップの直前に新しいステップを挿入することでこれを実現できることが示されています。
+
+設定Tiddlerの完全なフィールドリストは次のとおりです。:
+
+<<.tiddler-fields "$:/_tw5.com/CustomTiddlerColourCascadeDemo">>

package/editions/ja-JP/tiddlers/howtos/How to create a custom tiddler icon rule.tid

@@ -0,0 +1,38 @@
+created: 20211204161649863
+modified: 20241020111248598
+original-modified: 20211206165129215
+tags: Learning Cascades [[Tiddler Icon Cascade]] [[Customise TiddlyWiki]]
+title: How to create a custom tiddler icon rule
+ja-title: カスタムのTiddlerアイコンルールを作成する方法
+type: text/vnd.tiddlywiki
+
+ここでは、[[Tiddlerアイコンカスケード|Tiddler Icon Cascade]]に、<<tag "TableOfContents">>タグを持つTiddlerに"地球"アイコン<<.icon $:/core/images/globe>>を、<<tag "Working with TiddlyWiki">>タグを持つTiddlerに"ヘルプ"アイコン<<.icon $:/core/images/help>>を、付与するルールの追加方法を示します。
+
+<<.tip "[[カスタムのTiddlerカラールールを作成する方法|How to create a custom tiddler colour rule]]では、同じTiddlerにカスタムカラーを与える方法について説明します。">>
+
+まず、Tiddlerアイコンカスケードに新しいステップを追加します。新しいフィルターステップは次のとおりです。:
+
+```
+[tag[TableOfContents]then[$:/core/images/globe]]
+[tag[Working with TiddlyWiki]then[$:/core/images/help]] 
+```
+
+これは次のように読み取れます。:
+
+```
+もしTiddlerが"TableOfContents"タグを持つなら、$:/core/images/globeを返します
+もしTiddlerが"Working with TiddlyWiki"タグを持つなら、$:/core/images/helpを返します
+```
+
+Tiddlerアイコンカスケードは<<tag "$:/tags/TiddlerIconFilter">>タグによって定義されます。したがって、そのタグを使用して設定Tiddlerを作成する必要があります。
+
+また、カスケード内の正しい位置に挿入されていることを確認する必要があります。:
+
+* 新しいルールは、明示的な''icon''フィールドを持つTiddlerがそのフィールドの値を確実に尊重するように、"icon-field"ルールの後に置く必要があります。
+* 新しいルールは"default"アイコンの前になければなりません。そうしないと、デフォルトのアイコンが指定されていると、表示されることはありません。
+
+コントロールパネルの"カスケード"タブには、`list-before`フィールドを使用してデフォルトステップの直前に新しいステップを挿入することでこれを実現できることが示されています。
+
+設定Tiddlerの完全なフィールドリストは次のとおりです。:
+
+<<.tiddler-fields "$:/_tw5.com/CustomTiddlerIconCascadeDemo">>

package/editions/ja-JP/tiddlers/howtos/How to create keyboard shortcuts.tid

@@ -0,0 +1,107 @@
+tags: [[Customise TiddlyWiki]] Learning
+title: How to create keyboard shortcuts
+ja-title: キーボードショートカットを作成する方法
+type: text/vnd.tiddlywiki
+
+<br>
+<<.tip """[[TiddlyWiki]]は2種類のキーボードショートカットを区別します。<$macrocall $name=".tag" _="input"/>フィールド内や<$macrocall $name=".wlink" to="KeyboardWidget"/>ウィジェットによって処理される<$macrocall $name=".tag" _="textareas"/>でのみ機能するものと、またはグローバルに機能する、つまり、アクセスするのにページにフォーカスがあるだけでよいというキーボードショートカットです。後者は、Wikiが読み込まれたときに機能し始めるメカニズムによって処理されます""">>
+
+!! 設定メカニズムは両方のショートカットタイプで同じです
+
+<$vars tv-show-missing-links="no">
+
+<<.def プレフィックス>> `$:/config/ShortcutInfo/`と`my-shortcut`のような''一意のサフィックス''が追加されたTiddlerは、新しいショートカットを$:/ControlPanelの[[キーボードショートカットタブ|$:/core/ui/ControlPanel/KeyboardShortcuts]]に表示します。オプションの説明をテキストフィールドに追加できます
+
+[[キーボードショートカットタブ|$:/core/ui/ControlPanel/KeyboardShortcuts]]では、ショートカットをトリガーする''キーの組み合わせ''を設定できます:
+
+> 新しいショートカットに定義された''一意のサフィックス''を探し、''キーの組み合わせ''を検出し、入力フィールドに検出された組み合わせを表示するポップアップを開くボタン<$button class="tc-btn-invisible"><<.icon $:/core/images/edit-button>><$action-sendmessage $message="tm-notify" $param="$:/core/images/edit-button"/></$button>をクリックします
+
+>''ショートカットの追加''は、ショートカットにキーの組み合わせを割り当てます
+
+!!! 選択したプラットフォームに応じて、構成メカニズムは特定の命名法を持つTiddlerを作成します
+
+> $:/config/shortcuts/ + すべてのプラットフォーム(オペレーティングシステム)で機能するショートカットの''ショートカットサフィックス'' 
+
+> $:/config/shortcuts-(mac/not-mac/windows/not-windows/linux/not-linux)/ + 選択したプラットフォームでのみ機能するショートカットや除外されたプラットフォームでは機能しないショートカットの''ショートカットサフィックス''
+
+!!! 例
+
+* $:/config/shortcuts/`my-shortcut`
+* $:/config/shortcuts-mac/`my-shortcut`
+* $:/config/shortcuts-windows/`my-shortcut`
+* $:/config/shortcuts-linux/`my-shortcut`
+* $:/config/shortcuts-not-mac/`my-shortcut`
+* $:/config/shortcuts-not-windows/`my-shortcut`
+* $:/config/shortcuts-not-linux/`my-shortcut`
+
+<<.tip """上記の''ShortcutInfo''Tiddlerが最初に作成され、ショートカットが~ControlPanelで構成されている場合には、これらのプラットフォーム固有のTiddlerを手動で作成する必要がないことに注意してください""">>
+
+<br>
+
+!! この時点でショートカットが定義され、その''アクション''を設定できます
+
+!! [[キーボードウィジェット|KeyboardWidget]]の使用
+
+> <<.wlink "KeyboardWidget">>ウィジェットは、そのスコープ内の<<.tag input>>や<<.tag textarea>>フィールド内で押されたキーの組み合わせを検出します。<<.wlink "KeyboardWidget">>ウィジェットは、<<.tag input>>や<<.tag textarea>>フィールドを"包含"する必要があり、その<<.attr key>>属性は、[[キー記述子|Key Descriptor]]構文を使用して構成Tiddlerを指定するか、キーを明示的に含みます
+
+```
+<$keyboard key="((my-shortcut))" actions='<$action-setfield $tiddler="my-tiddler" $field="my-field" $value="my-value"/>'>
+
+<$edit-text tag="input" tiddler="my-tiddler"/>
+
+</$keyboard>
+```
+
+```
+<$keyboard key="alt-shift-M" actions='<$action-setfield $tiddler="my-tiddler" $field="my-field" $value="my-value"/>'>
+
+<$edit-text tag="input" tiddler="my-tiddler"/>
+
+</$keyboard>
+```
+
+> アクションが定義されている場合、<<.wlink KeyboardWidget>>ウィジェットは、その<<.attr key>>属性で定義されたキーの組み合わせがそのスコープ内の
+<<.tag input>>や<<.tag textarea>>フィールドで押されたことを検出すると、その<<.attr actions>>属性で定義されたアクションを呼び出します
+
+<br>
+
+!! グローバルなキーボードショートカットの使用
+
+> 新しいグローバルキーボードショートカットの作成の詳細については、[[キーボードショートカットTiddler]]を参照してください。
+
+> ''グローバル''キーボードショートカットのアクションは、<<tag $:/tags/KeyboardShortcut>>タグが付けられたTiddlerの''テキスト''フィールドに保存されます
+
+> ''キーフィールド''は、[[キーボードショートカット記述子|Keyboard Shortcut Descriptor]]と呼ばれる`((my-shortcut))`構文を通じて、アクションTiddlerと対応するショートカットを結びつけます
+
+:<h3> 構文: `((` + `選択したサフィックス` + `))` </h3>
+
+> Tiddlerが<<tag $:/tags/KeyboardShortcut>>タグを持っている場合、''key''フィールドに[[キーボードショートカット記述子|Keyboard Shortcut Descriptor]]を値として設定し、テキストフィールドにアクションを設定すると、メカニズムが設定されたキーの組み合わせを検出するとアクションがトリガーされます
+
+<br>
+<$macrocall $name=".tip" _="""グローバルキーボードショートカットの''外部で''定義された''マクロ''(`$:/tags/Global`タグの付いたTiddler経由)は、アクセス可能にするために''インポートする''必要があります。
+[[インポートプラグマ|Pragma]]は、そのために使用できます"""/>
+
+<pre>
+\import [subfilter{$:/core/config/GlobalImportFilter}]
+</pre>
+
+マクロ定義を含むTiddlerがわかっていて、例えばタイトルが`my-macro-tiddler`なら、
+
+<pre>
+\import [[my-macro-tiddler]]
+</pre>
+
+<br>
+<$macrocall $name=".tip" _="""一部のアクションは<<.wlink NavigatorWidget>>ウィジェット内にラップする必要があります。これは、グローバルなキーボードショートカット内で使用される場合に、次のウィジェットとメッセージのリストが機能するために必要です"""/>
+
+!!! ウィジェット
+
+<<.wlink ActionNavigateWidget>> (ActionNavigateWidget)
+
+!!! メッセージ
+
+<$list filter="[tag[navigator-message]]">
+<$link/><br>
+</$list>
+
+</$vars>