mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2025-04-09 04:06:39 +00:00
[ja_JP] Japanese translation update - 'Platforms' section of tiddlywiki.com (#8940)
* [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\definitions\TiddlyDesktop.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\platforms\Platforms.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\TiddlyWiki on Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Building TiddlyWikiClassic.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Installing TiddlyWiki Prerelease on Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\commands\NamedCommandParameters.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Upgrading TiddlyWiki on Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\howtos\Using a custom path prefix with the client-server edition.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Customising Tiddler File Naming.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Environment Variables on Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\howtos\Generating Static Sites with TiddlyWiki.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\howtos\How to build a TiddlyWiki5 from individual tiddlers.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Installing custom plugins on Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Installing official plugins on Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\saving\Example config-tiddlyweb-host for IIS.txt' * [ja-JP] Japanese translation of 'editions\ja-JP\tiddlers\saving\Example package.json for IIS.txt' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\saving\Example tiddlywiki.info for IIS.txt' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\saving\Example web.config for IIS.txt' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\fileformats\MultiTiddlerFiles.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\fileformats\MultiTiddlerFileSyntax.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Scripts for TiddlyWiki on Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\fileformats\TiddlerFiles.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\tiddlywiki.files_Files.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\tiddlywiki.info_Files.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\concepts\TiddlyWikiFolders.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Uninstalling a plugin with Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\howtos\Using TiddlyWiki for GitHub project documentation.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Using TiddlyWiki on Node.js.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\nodejs\Working with the TiddlyWiki5 repository.tid' * [ja-JP] Japanese translation of 'editions\tw5.com\tiddlers\plugins\Plugin Ordering.tid'
This commit is contained in:
IchijikuIchigo
GitHub
parent
4f0bdac77b
commit
0b758190d1
24
editions/ja-JP/tiddlers/commands/NamedCommandParameters.tid
Normal file
24
editions/ja-JP/tiddlers/commands/NamedCommandParameters.tid
Normal file
@ -0,0 +1,24 @@
|
||||
created: 20180626122427188
|
||||
modified: 20241228111603066
|
||||
original-modified: 20211117234223960
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: NamedCommandParameters
|
||||
ja-title: 名前付きコマンドパラメータ
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
<<.from-version "5.1.18">> ほとんどのTiddlyWiki[[コマンド|Commands]]は、パラメータに位置に基づくシステムを使用しており、各パラメータはコマンドで定義された正確な順序でリストされる必要があります。より複雑なコマンドの中には、名前付きコマンドパラメータの代替スキームを提供するものもあります。たとえば、ここでは"port"と"host"という2つのパラメータを提供します:
|
||||
|
||||
```
|
||||
--listen port=8090 host=0.0.0.0
|
||||
```
|
||||
|
||||
パラメータの順序は重要ではないことに注意してください。
|
||||
|
||||
パラメータ内で特殊文字を使用するには引用符が必要です。Unix、Linux、Macではシングルクォートが使用され、Windowsではダブルクォートが使用されます:
|
||||
|
||||
```
|
||||
--listen port=8090 username=joe 'password=s3cret(!'
|
||||
--listen port=8090 username=joe "password=s3cret(!"
|
||||
```
|
||||
|
||||
引用符は値の部分だけでなく、名前=値のペア全体を括ることに注意してください。
|
||||
42
editions/ja-JP/tiddlers/concepts/TiddlyWikiFolders.tid
Normal file
42
editions/ja-JP/tiddlers/concepts/TiddlyWikiFolders.tid
Normal file
@ -0,0 +1,42 @@
|
||||
created: 20130825214200000
|
||||
modified: 20250203103623306
|
||||
original-modified: 20161015134454785
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: TiddlyWikiFolders
|
||||
ja-title: TiddlyWikiフォルダ
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
[[Node.js上のTiddlyWiki|TiddlyWiki on Node.js]]は、従来の単一ファイルWikiと同様に、フォルダーに保存される個々のTiddlerファイルのWikiもサポートします。
|
||||
|
||||
! Wikiフォルダ構造
|
||||
|
||||
Wikiフォルダーには、次のファイルとフォルダーを含めることができます:
|
||||
|
||||
* ''tiddlywiki.info'' - Wikiのメタデータを含むJSONファイル -- [[tiddlywiki.infoファイル|tiddlywiki.info Files]]を参照
|
||||
* ''\tiddlers'' - Wikiを構成するTiddlerファイルを含むフォルダ
|
||||
* ''\plugins'' - Wikiに含める[[プラグインフォルダ|PluginFolders]]を含むフォルダ
|
||||
* ''\languages'' - Wikiに含める言語プラグインの[[プラグインフォルダ|PluginFolders]]を含むフォルダ
|
||||
* ''\themes'' - Wikiに含めるテーマプラグインの[[プラグインフォルダ|PluginFolders]]を含むフォルダ
|
||||
|
||||
''tiddlywiki.info''ファイルのみが必須で、その他はすべてオプションです。上記にリストされていないファイルとフォルダーは無視されます。
|
||||
|
||||
!! プラグイン処理
|
||||
|
||||
ブラウザで使用できるようにするには、プラグインをWikiに含める必要があります。サーバー上で生成されるWikiの場合、[[TiddlyWikiフォルダ|TiddlyWikiFolders]]には、このWikiに含めるプラグインの識別を[[tiddlywiki.infoファイル|tiddlywiki.info Files]]に含めることができます:
|
||||
|
||||
```
|
||||
{
|
||||
"plugins": [
|
||||
"tiddlywiki/slider",
|
||||
"tiddlytools/chooser"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
プラグイン名は、TiddlyWiki5のルート`plugins`フォルダーにリストされているプラグインフォルダーを参照します。プラグインは、Wikiの`plugins`サブフォルダーにコピーして手動で含めることもできます。
|
||||
|
||||
!! `tiddlers`フォルダの処理
|
||||
|
||||
`tiddlers`フォルダー内のすべての[[Tiddlerファイル|TiddlerFiles]]は、起動時にWikiに読み込まれます。サブフォルダーは[[Tiddlerファイル|TiddlerFiles]]の再帰スキャンの対象となります。新しく作成されたTiddlerは、[[特に設定されて|Customising Tiddler File Naming]]いない限り、`tiddlers`フォルダーの直下の[[Tiddlerファイル|TiddlerFiles]]に保存されます。
|
||||
|
||||
`tiddlers`フォルダー内のサブフォルダーのデフォルトの処理は、`tiddlywiki.files`と呼ばれるJSONファイルを提供することで上書きできます -- [[tiddlywiki.filesファイル|tiddlywiki.files Files]]を参照。
|
||||
21
editions/ja-JP/tiddlers/definitions/TiddlyDesktop.tid
Normal file
21
editions/ja-JP/tiddlers/definitions/TiddlyDesktop.tid
Normal file
@ -0,0 +1,21 @@
|
||||
created: 20140126125259638
|
||||
modified: 20241227104451970
|
||||
original-modified: 20171118195316103
|
||||
tags: Definitions Platforms
|
||||
title: TiddlyDesktop
|
||||
ja-title: TiddlyDesktop
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
TiddlyDesktopは、TiddlyWikiファイル(TiddlyWikiClassicとTiddlyWikiバージョン5の両方)を操作するためのアプリです。Windowsや、Mac OS X、Linuxにインストールできます。TiddlyWikiバージョン5と古いTiddlyWikiClassicと互換性があります
|
||||
|
||||
{{Saving on TiddlyDesktop}}
|
||||
|
||||
{{Introducing TiddlyDesktop Video}}
|
||||
|
||||
! ソース
|
||||
|
||||
TiddlyDesktopは、[[オープンソース|OpenSource]]プロジェクト[[NW.js]]をベースにしています。ソースはGitHubにあります:
|
||||
|
||||
https://github.com/TiddlyWiki/TiddlyDesktop/
|
||||
|
||||
[[TiddlyDesktopのリリース|TiddlyDesktop Releases]]と[[TiddlyDesktopのカスタマイズ方法|How to Customize TiddlyDesktop]]を参照してください
|
||||
@ -0,0 +1,31 @@
|
||||
created: 20150621181334837
|
||||
modified: 20250124111732489
|
||||
original-modified: 20150621181400844
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: MultiTiddlerFileSyntax
|
||||
ja-title: マルチTiddlerファイル構文
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
!!! [[マルチTiddlerファイル|MultiTiddlerFiles]]
|
||||
|
||||
<$railroad text="""
|
||||
{<"ヘッダー行">} "空行" {(<"Tiddler記述行"> | <"コメント行">)}
|
||||
"""/>
|
||||
|
||||
!!! ヘッダー行
|
||||
|
||||
<$railroad text="""
|
||||
<"識別子"> ":" {"ホワイトスペース"} <"値"> "改行"
|
||||
"""/>
|
||||
|
||||
!!! Tiddler記述行
|
||||
|
||||
<$railroad text="""
|
||||
<"ファイルパス"> ":" {"ホワイトスペース"} <"Tiddlerタイトル"> "改行"
|
||||
"""/>
|
||||
|
||||
!!! コメント行
|
||||
|
||||
<$railroad text="""
|
||||
"#" {("テキスト" | "ホワイトスペース")} "改行"
|
||||
"""/>
|
||||
38
editions/ja-JP/tiddlers/fileformats/MultiTiddlerFiles.tid
Normal file
38
editions/ja-JP/tiddlers/fileformats/MultiTiddlerFiles.tid
Normal file
@ -0,0 +1,38 @@
|
||||
created: 20140209143652456
|
||||
modified: 20250123115055695
|
||||
original-modified: 20150621182140407
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: MultiTiddlerFiles
|
||||
ja-title: マルチTiddlerファイル
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
MultiTiddlerFilesを使用すると、複数のTiddlerを1つのテキストファイルに簡潔に表現できます。
|
||||
|
||||
この形式の目標は次のとおりです:
|
||||
|
||||
* 入力しやすく、読みやすい
|
||||
* 単一行の文字列に最適化
|
||||
* Tiddlerのグループ内で共通のフィールドやタグを共有できるようにする
|
||||
* 外部ツールで簡単に処理できるようにする
|
||||
|
||||
MultiTiddlerFilesの拡張子は`multids`です。ファイルは、共有フィールドのブロックとそれに続く空白行で構成されます。ファイルの残りの部分は、コメントとTiddlerのシーケンスです。Tiddlerはタイトルで指定され、その後にコロン、少なくとも1つのスペース文字が続き、行の残りの部分はTiddlerのテキストフィールドになります。
|
||||
|
||||
例:
|
||||
|
||||
```
|
||||
title: $:/language/ControlPanel/
|
||||
tags: strings
|
||||
modifier: JoeBloggs
|
||||
|
||||
Basics/Caption: Basics
|
||||
# This is a comment
|
||||
Basics/Version: ~TiddlyWiki Version
|
||||
```
|
||||
|
||||
この例では、[[$:/language/ControlPanel/Basics/Caption]]と[[$:/language/ControlPanel/Basics/Version]]の2つのTiddlerを定義します。
|
||||
|
||||
ヘッダーで`title`フィールドが指定されている場合、タイトルで定義された個々のTiddlerのプレフィックスとして扱われます。
|
||||
|
||||
!! 構文の仕様
|
||||
|
||||
{{MultiTiddlerFileSyntax}}
|
||||
112
editions/ja-JP/tiddlers/fileformats/TiddlerFiles.tid
Normal file
112
editions/ja-JP/tiddlers/fileformats/TiddlerFiles.tid
Normal file
@ -0,0 +1,112 @@
|
||||
created: 20130825150000000
|
||||
modified: 20250125105846987
|
||||
original-modified: 20210714130751701
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: TiddlerFiles
|
||||
ja-title: Tiddlerファイル
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Tiddlerは、さまざまな形式でテキストファイルに保存できます。単一のTiddlerを含むファイルには、名前:値のペアのシーケンスとしてフォーマットされた`.meta`補助ファイルを持つこともできます。
|
||||
|
||||
```
|
||||
title: TheTitle
|
||||
modifier: someone
|
||||
```
|
||||
|
||||
!! ~TiddlyWebスタイルの.tidファイル
|
||||
|
||||
これらのファイルは、名前:値のペア、空白行、そしてTiddlerのテキストを含む一連の行で構成されます。例:
|
||||
|
||||
```
|
||||
title: MyTiddler
|
||||
modifier: Jeremy
|
||||
|
||||
This is the text of my tiddler.
|
||||
```
|
||||
|
||||
多くのテキストエディターでは、ファイルに終了改行が含まれている必要があることに注意してください。Tiddlerのテキストに終了改行を含めたくない場合は、次の代替構文を使用できます:
|
||||
|
||||
```
|
||||
title: MyTiddler
|
||||
modifier: Jeremy
|
||||
text: This is the text of my tiddler.
|
||||
```
|
||||
|
||||
//`application/x-tiddler` ContentTypeはこれらのファイルの内部で使用されます//
|
||||
|
||||
!! TiddlyWiki `<DIV>` .tiddlerファイル
|
||||
|
||||
TiddlyWiki 5では、`*.tiddler`ファイルは次のようになります。
|
||||
|
||||
```
|
||||
<div title="AnotherExampleStyleSheet" modifier="blaine" created="201102111106" modified="201102111310" tags="examples" creator="psd">
|
||||
<pre>Note that there is an embedded <pre> tag, and line feeds are not escaped.
|
||||
|
||||
And, weirdly, there is no HTML encoding of the body.</pre>
|
||||
</div>
|
||||
```
|
||||
|
||||
これらの`*.tiddler`ファイルは、HTML エンコードされたTiddlyWiki HTMLファイル内のTiddlerとまったく同じではありません。
|
||||
|
||||
Older `*.tiddler` files more closely matched the store format used by TiddlyWiki at the time:
|
||||
古い`*.tiddler`ファイルは、当時TiddlyWikiで使用されていたストア形式に似ています:
|
||||
|
||||
```
|
||||
<div tiddler="AnotherExampleStyleSheet" modifier="JeremyRuston" modified="200508181432" created="200508181432" tags="examples">This is an old-school .tiddler file, without an embedded <pre> tag.\nNote how the body is "HTML encoded" and new lines are escaped to \\n</div>
|
||||
```
|
||||
|
||||
//`application/x-tiddler-html-div` ContentTypeはこれらのファイルの内部で使用されます//
|
||||
|
||||
!! ~TiddlyWebスタイルのJSONファイル
|
||||
|
||||
これらのファイルは、`name:value`プロパティのハッシュマップの単純な配列です。すべてのフィールド値は文字列として指定する必要があります。
|
||||
|
||||
例:
|
||||
|
||||
```
|
||||
[
|
||||
{
|
||||
"title": "First Tiddler",
|
||||
"text": "Text of first tiddler",
|
||||
"tags": "one two [[t h r e e]]"
|
||||
},{
|
||||
"title": "Second Tiddler",
|
||||
"text": "Text of second tiddler",
|
||||
"modified": "20150216171751154"
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
`application/json` ContentTypeはこれらのファイルに対して内部で使用されます。
|
||||
|
||||
Tiddler構造に準拠していないJSONファイルは、代わりにJSONデータを含む単一のTiddlerとしてインポートされることに注意してください。
|
||||
|
||||
!! TiddlyWiki HTMLファイル用の新しいJSONベースの形式
|
||||
|
||||
TiddlyWiki HTMLファイルの新しい形式では、スクリプトタグ内にJSON形式のTiddlerが埋め込まれます:
|
||||
|
||||
```json
|
||||
<script class="tiddlywiki-tiddler-store" type="application/json">[
|
||||
{"title": "A","text": "One"},
|
||||
{"title": "B","text": "Two"}
|
||||
]</script>
|
||||
```
|
||||
|
||||
!! TiddlyWiki HTMLファイル用の古いDIVベースの形式
|
||||
|
||||
TiddlyWikiクラシックおよびバージョンv5.2.0より前のTiddlyWiki 5では、Tiddlerは`<DIV>`形式でエンコードされて保存されていました。
|
||||
|
||||
TiddlyWikiが暗号化されていないDIVベースのHTMLファイルをインポートするには、上で説明したようにTiddler DIVを含んだ`<div id="storeArea">`が必要です。例:
|
||||
|
||||
```
|
||||
<div id="storeArea">
|
||||
<div created="20130302085406905" modified="20130302084548184" tags="Examples" title="A tiddler title">
|
||||
<pre>HTML encoded text of tiddler
|
||||
</pre>
|
||||
</div>
|
||||
<div created="20140315085406905" modified="20140321084548184" tags="One Two [[Three with Space]]" title="Another title" customfield="field value">
|
||||
<pre>Text of this tiddler
|
||||
</pre>
|
||||
</div>
|
||||
</div>
|
||||
```
|
||||
@ -0,0 +1,37 @@
|
||||
created: 20130828190200000
|
||||
modified: 20250120105549696
|
||||
original-modified: 20241008031135403
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Generating Static Sites with TiddlyWiki
|
||||
ja-title: TiddlyWikiで静的サイトを生成する
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
TiddlyWiki5は、JavaScriptを必要としないTiddlyWikiの静的HTML表現を生成できます。このプロセスでは、ローカルシステムのNode.jsにTiddlyWikiがインストールされている必要があります。詳細については、[[Node.jsにTiddlyWikiをインストールする|Installing TiddlyWiki on Node.js]]を参照してください。
|
||||
|
||||
静的HTMLの生成方法には多くの柔軟性があります。次のシナリオはすべて https://tiddlywiki.com で説明されています。
|
||||
|
||||
! WikiスナップショットとTiddlerスナップショット
|
||||
|
||||
https://tiddlywiki.com/static.html で、メインのTiddlyWikiサイトの静的な表現を見ることができます。このファイルは、現在のDefaultTiddlersの静的スナップショットです。このファイルにリンクされているすべてのTiddlerは、個々のTiddlerの静的スナップショットを指す`/static/HelloThere.html`形式のURLによって参照されます。TiddlerのHTMLファイルは、`static.css`スタイルシートファイルを参照します。
|
||||
|
||||
次のコマンドは、TiddlyWiki5サイトの静的バージョンのサンプルを生成するために使用されます:
|
||||
|
||||
```sh
|
||||
tiddlywiki wikipath --render '[!is[system]]' '[encodeuricomponent[]addprefix[static/]addsuffix[.html]]' text/plain $:/core/templates/static.tiddler.html
|
||||
tiddlywiki wikipath --render $:/core/templates/static.template.html static.html text/plain
|
||||
tiddlywiki wikipath --render $:/core/templates/static.template.css static/static.css text/plain
|
||||
```
|
||||
|
||||
最初のRenderCommandは、フィルタ`[!is[system]]`を使用してすべての個別の非システムTiddlerのHTML表現を生成し、次のフィルタ`[encodeuricomponent[]addprefix[static/]addsufixx[.html]]`は各タイトルにURIエンコーディングを適用し、プレフィックス`static/`を追加して、最後にサフィックス`.html`を追加します。2番目のRenderCommandは、DefaultTiddlersの静的バージョンを`static.html`に保存し、最後のRenderCommandはスタイルシートを保存します。(すべてのファイルは、Wikiフォルダの`output`フォルダに配置されます)。
|
||||
|
||||
! 内部リンク付きWikiスナップショット
|
||||
|
||||
Tiddlerの静的表現を含み、標準のHTMLアンカーリンクを使用してそれらの間を移動する単一のHTMLファイルを作成することも可能です。
|
||||
|
||||
例: https://tiddlywiki.com/alltiddlers.html
|
||||
|
||||
この例は次のコマンドによって構築できます:
|
||||
|
||||
```
|
||||
--render $:/core/templates/alltiddlers.template.html alltiddlers.html text/plain
|
||||
```
|
||||
@ -0,0 +1,19 @@
|
||||
created: 20131124220600000
|
||||
modified: 20250121112457196
|
||||
original-modified: 20241025051111864
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: How to build a TiddlyWiki5 from individual tiddlers
|
||||
ja-title: 個々のTiddlerからTiddlyWiki5を構築する方法
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
まず、[[Node.jsにTiddlyWikiをインストール|Installing TiddlyWiki on Node.js]]の説明に従ってTiddlyWikiをインストールします。
|
||||
|
||||
# 空の[[TiddlyWikiFolder|TiddlyWikiFolders]]を作成します
|
||||
## 適当な場所に新しいフォルダを作成します (例: `~/MyWiki`)
|
||||
## 次のテキストを含む`tiddlywiki.info`というファイルを作成します:
|
||||
##* `{"themes": ["tiddlywiki/vanilla","tiddlywiki/snowwhite"]}`
|
||||
## `tiddlers`というサブフォルダを作成します
|
||||
##* あるいは、TiddlyWiki5リポジトリから、`editions/empty`フォルダをコピーします
|
||||
# `~/MyWiki/tiddlers`ディレクトリ内に個々のTiddlerFilesを作成します
|
||||
# TiddlyWiki5ルートディレクトリから次のコマンドを実行して、TiddlerからTiddlyWiki5ファイルを構築します:
|
||||
## `tiddlywiki ~/MyWiki --render $:/core/save/all index.html text/plain`
|
||||
@ -0,0 +1,31 @@
|
||||
created: 20130825150100000
|
||||
modified: 20250204104525288
|
||||
original-modified: 20140912141559011
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Using TiddlyWiki for GitHub project documentation
|
||||
ja-title: GitHubプロジェクトのドキュメントにTiddlyWikiを使用する
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
TiddlyWiki5は、GitHubプロジェクトのドキュメントを作成するために使用できます。ソースコード管理下にある個別のTiddlerファイルを含む[[TiddlyWikiフォルダ|TiddlyWikiFolders]]として単一のドキュメントセットを維持し、それを使用してプロジェクトフォルダーに含める`readme.md`ファイルや[[GitHub Pages|http://pages.github.com/]]に保存するHTMLファイルを作成できます。両方の機能は、TiddlyWiki5自身によって実証されています。
|
||||
|
||||
! `readme.md`ファイルの生成
|
||||
|
||||
フォルダーの内容を表示する際、GitHubは`readme.md`ファイルを探して表示します。この方法では完全なHTMLファイルではなく、静的なMarkDownファイルのみが表示されることに注意してください(これはセキュリティ対策です)。幸いなことに、MarkDownはHTMLの安全なサブセットを許可しているため、GitHubに適した`readme.md`ファイルを生成するには、TiddlyWiki5がHTMLドキュメントの`<body>`要素の内容を生成し、適切なファイル名を付けるだけで済みます。
|
||||
|
||||
これは次のコマンドで実行できます:
|
||||
|
||||
```
|
||||
--rendertiddler ReadMe ./readme.md text/html
|
||||
```
|
||||
|
||||
ReadMe Tiddlerを`text/html`形式でファイル`./readme.md`に保存します。
|
||||
|
||||
デフォルトでは、Tiddlerのリンクは、Tiddlerのタイトルで構成される相対URIへのリンクとしてレンダリングされます。この動作は、ReadMe Tiddlerの先頭で行われているように、マクロ`tv-wikilink-template`を定義することで上書きできます
|
||||
|
||||
```
|
||||
\define tv-wikilink-template() https://tiddlywiki.com/static/$uri_doubleencoded$.html
|
||||
```
|
||||
|
||||
詳細については、LinkWidgetを参照してください。
|
||||
|
||||
この例では、Tiddlerのリンクはtw5.comの静的レンダリングへのリンクとしてレンダリングされます。
|
||||
@ -0,0 +1,16 @@
|
||||
created: 20140613133627669
|
||||
modified: 20241230102718926
|
||||
original-modified: 20140912141613393
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Using a custom path prefix with the client-server edition
|
||||
ja-title: クライアント-サーバーエディションでカスタムのパスプレフィックスを使用する
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
デフォルトでは、[[Node.js上のTiddlyWiki|TiddlyWiki on Node.js]]を実行すると、サーバーはプロトコル、ホスト、ポートから形成されたURI - 例えば、`http://127.0.0.1:8080/`でWikiを公開します。
|
||||
|
||||
`http://127.0.0.1:8080/path/to/my/wiki/`のようなカスタムパスでWikiを実行するには、2つの手順があります:
|
||||
|
||||
# ServerCommandの''pathprefix''属性として`/path/to/my/wiki`を渡してサーバーを設定します
|
||||
# `$protocol$//$host$/path/to/my/wiki/`を含む、`$:/config/tiddlyweb/host`というTiddlerを作成してクライアントを設定します
|
||||
|
||||
|
||||
@ -0,0 +1,27 @@
|
||||
created: 20131129094452285
|
||||
modified: 20241227110457591
|
||||
original-modified: 20140912141658212
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Building TiddlyWikiClassic
|
||||
ja-title: TiddlyWikiClassicの構築
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
TiddlyWiki5を使用すれば、TiddlyWikiClassicの古いバージョン2.xxをその構成コンポーネントから構築できます。これには次の機能が含まれます:
|
||||
|
||||
* `tiddlywiki/classictools`プラグインには、TiddlyWiki 2.xxの`.recipe`ファイルからTiddlerをロードできるようにするデシリアライザモジュールが含まれています
|
||||
* ViewWidgetのための`stripcomments`フォーマットは、`//#`で始まる1行のJavaScriptコメントを削除します
|
||||
* FieldsWidgetの`stripTitlePrefix='yes'`属性は、`title`属性から中括弧で囲まれたプレフィックスを削除します
|
||||
** 例えば、`{tiddler}HelloThere`は、`HelloThere`に変換されます
|
||||
|
||||
! 使用法
|
||||
|
||||
TiddlyWikiClassicは、[[Node.js上のTiddlyWiki|TiddlyWiki on Node.js]]を実行することによってコマンドラインから構築されます。一般的な使用法は次のようになります:
|
||||
|
||||
```
|
||||
node ../../tiddlywiki.js \
|
||||
--verbose \
|
||||
--load <path_to_recipe_file> \
|
||||
--rendertiddler $:/core/templates/tiddlywiki2.template.html <path_to_write_index_file> text/plain \
|
||||
|| exit 1
|
||||
```
|
||||
|
||||
@ -0,0 +1,58 @@
|
||||
created: 20160424181300000
|
||||
modified: 20241230104855826
|
||||
original-modified: 20210803204659026
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Customising Tiddler File Naming
|
||||
ja-title: Tiddlerファイル名のカスタマイズ
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
デフォルトでは、[[Wikiフォルダー|TiddlyWikiFolders]]を使用する[[Node.js上のTiddlyWiki|TiddlyWiki on Node.js]]インスタンスは、サニタイズされ、曖昧さが解消されたタイトルをファイル名として使用して、新しいTiddlerファイルを作成します。すべてのファイルパス操作は、`default-tiddler-location`からの相対で、デフォルトではWikiフォルダーの`tiddlers/`ディレクトリです。`config`オブジェクトの`default-tiddler-location`プロパティを使用して、Wikiのtiddlywiki.infoファイル内のパスをマッピングすることで、これを上書きできます。
|
||||
|
||||
デフォルトのファイル拡張子`.tid`は、`type`フィールドが欠落しているTiddlerや、"text/vnd.tiddlywiki"タイプが"text/vnd.tiddlywiki"のTiddlerに使用されます。他のタイプのTiddlerは、(ブートスタートアップ時に定義される)MIMEタイプに従って保存されます。
|
||||
|
||||
オプションのTiddler[[$:/config/FileSystemPaths]]と[[$:/config/FileSystemExtensions]]を作成することにより、論理パス(ディレクトリとファイル名)とファイル拡張子を個別にカスタマイズできます。
|
||||
|
||||
! ファイルシステムパス
|
||||
|
||||
論理パスは、1つ以上の[[フィルター式|Filter Syntax]](各フィルター式は1行に1つずつ)を含む[[$:/config/FileSystemPaths]] Tiddlerを作成することでカスタマイズできます。Tiddlerがディスクに保存されるたびに、各フィルターが順番にテストされ、出力を生成する最初のフィルターの最初の出力が、Tiddlerファイルに使用される論理パスとして取得されます。論理パスが変更された場合は、新しいファイルが作成され、古いファイルは削除されます。
|
||||
|
||||
Tiddlerは、[[Wikiフォルダ|TiddlyWikiFolders]]、`default-tiddler-location`設定で定義されたパス、または $:/config/OriginalTiddlerPaths Tiddlerに保存された特定のパス([[tiddlywiki.filesファイル|tiddlywiki.files Files]]を参照)にのみ書き込むことができます。Tiddlerをディスクに保存するときに、論理パスがWikiフォルダのパスで始まらない(最も一般的なエラー)と、ファイルパスがJavascriptの`encodeURIComponent()`メソッドによってエンコードされ、Wikiフォルダの`default-tiddler-location`にTiddlerがファイルとして保存されます。
|
||||
|
||||
論理パスにはディスク上のファイルの拡張子は含まれません(下記参照)。また、ディレクトリ区切り文字として`/`や`\`を使用できます(物理パスを生成するときに、~TiddlyWikiが動作しているプラットフォームの正しい区切り文字に置き換えられます)。フィルターがどれも一致しない場合、論理パスは、結果のパスがすべてのサポートされているプラットフォームで有効であることを保証するため、すべての`/\<>~:"|?*^`文字が`_`に置き換えられたタイトルになります。論理パスも200文字に制限されています。この名前のファイルがすでに存在する場合、スペースと数字が最終的なファイルパスに追加され、未使用のパスが見つかるまで数字が増加していきます。
|
||||
|
||||
!! 例
|
||||
|
||||
```
|
||||
[is[system]!has[draft.of]removeprefix[$:/]addprefix[_system/]]
|
||||
[is[draft]search-replace:g:regexp[/|\\],[_]addprefix[drafts/]]
|
||||
[tag[task]addprefix[mytasks/]]
|
||||
[!tag[externalnote]addprefix[wiki/]]
|
||||
```
|
||||
|
||||
<<.note "すべてのパスはWikiの`default-tiddler-location`からの相対パスです。">>
|
||||
|
||||
これにより、他のTiddlerの下書きではない、新しく作成されたシステムTiddlerが`./_system/`(`$:/`プレフィックスの削除後)に保存されます。次に、すべての下書きのタイトルのパス区切り文字が"_"に置き換えられ、`./drafts/`に保存されます。そして、[[task]]タグが付けられたTiddlerがサブディレクトリ`./mytasks/`に保存されます。最後に、"externalnote"タグが付けられていないすべてのTiddlerが最終的に`[!tag[externalnote]addprefix[wiki/]]`に一致し、これらが`./wiki/`に保存されます。この例では、"externalnote"タグが付けられたTiddlerが[[tiddlywiki.filesファイル|tiddlywiki.files Files]]を使用してインポートされています。"isEditableFile"フラグがtrueに設定されているファイルにより、サーバーは$:/config/OriginalTiddlerPaths Tiddlerに元のファイルパスを記憶します。
|
||||
|
||||
Tiddlerが $:/config/FileSystemPaths フィルターのマッチを生成するたびに、Tiddlerのタイトル内の`/`や`\`がパス区切り文字にマップされます。上記のフィルターを使用すると、非システム、非ドラフトのTillder(タグなし)`some/thing/entirely/new`が`./wiki/some/thing/entirely/new.tid`に保存されます(つまり、`entirely/`というディレクトリ内の`new.tid`ファイル)。したがって、プラットフォームに応じて、 $:/config/FileSystemPaths 自体は`./_system/config/FileSystemPaths.tid`や`.\_system\config\FileSystemPaths.tid`に保存されます。
|
||||
|
||||
! ファイルシステム拡張子
|
||||
|
||||
通常、ディスク上のTiddlerのファイルシステム拡張子は、改行を含むフィールド値や空白で始まるか終わる(テキストフィールド以外の)フィールド値の存在によって決定されます。この場合、単一ファイル".json" Tiddlerファイル形式が使用されます。
|
||||
|
||||
Tiddlerにこのようなフィールド値がない場合、`type`フィールドが参照され、一致するファイルタイプが検索されます。タイプ値のないTiddlerの場合は`.tid`が使用されます。ブートエンジンは、[[$:/boot/boot.js]] Tiddlerで、Tiddlerタイプとファイルタイプの関係のセットを定義します。これらの関係を定義するコードのセクションを見つけるには、`// Add file extension information`を検索してください。
|
||||
|
||||
個々のTiddlerのファイル拡張子は、1つ以上の[[フィルタ式|Filter Syntax]](各行に1つずつ)を含むTiddler[[$:/config/FileSystemExtensions]]を作成することでカスタマイズできます。Tiddlerがディスクに保存されるたびに、これらのフィルタに対してテストされ、出力を生成する最初のフィルタの最初の出力が、Tiddlerファイルに使用されるファイル拡張子として使用されます。拡張子は常に先頭にドットを付ける必要があります(例を参照)。一致するフィルタがない場合は、デフォルトの拡張子が使用されます。拡張子が変更された場合は、新しいファイルが作成され、古いファイルは削除されます。
|
||||
|
||||
<<.note """".tid"の結果は、Tiddlerを単一ファイルのテキストTiddlerとしてディスクに書き込むことを強制します。".json"の結果は、Tiddlerをjson形式(配列内の単一のTiddler フィールドオブジェクト)の単一ファイルTiddlerとしてディスクに書き込むことを強制します。"application/json"タイプのTiddlerとしては書き込まれません。認識されるその他のすべてのファイルタイプは、定義された拡張子を使用して保存され、"text"フィールド以外のすべてのフィールドを説明する同じ名前の *.meta ファイルが付随します。""">>
|
||||
|
||||
!! 例
|
||||
|
||||
```
|
||||
[tag[.txt]then[.txt]]
|
||||
[tag[.json]then[.json]]
|
||||
[tag[.tid]then[.tid]]
|
||||
```
|
||||
|
||||
これにより、タグ".txt"を持つすべてのTiddlerが、ファイルシステムのパスフィルターによって決定されたファイルパスに保存されますが、テキストフィールドは *.txt ファイルとして保存され、その他のすべてのフィールドは *.txt.meta ファイルとして保存されます。
|
||||
|
||||
次に、".json"タグを持つすべてのTiddlerが *.json ファイルとして保存されます。最後に、タグ".tid"を持つすべてのTiddlerが単一のファイルとして保存されます。Tiddlerがどのフィルターにも一致しない場合は、Tiddlerの`type`フィールドによって決定されるデフォルトの拡張子が使用されます。
|
||||
@ -0,0 +1,27 @@
|
||||
created: 20140617211749290
|
||||
modified: 20250120104354585
|
||||
original-modified: 20220613114121229
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Environment Variables on Node.js
|
||||
ja-title: Node.jsの環境変数
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
[[Node.js上のTiddlyWiki|TiddlyWiki on Node.js]]は、プラグインとエディションを検索するためのパスの区切りリストを指定するために、次のOS環境変数をサポートしています:
|
||||
|
||||
* `TIDDLYWIKI_PLUGIN_PATH` - 通常のプラグインの検索パス
|
||||
* `TIDDLYWIKI_THEME_PATH` - テーマの検索パス
|
||||
* `TIDDLYWIKI_LANGUAGE_PATH` - 言語の検索パス
|
||||
* `TIDDLYWIKI_EDITION_PATH` - エディションの検索パス (InitCommandによって使用される)
|
||||
|
||||
|
||||
<$macrocall $name=".note" _="""''1.'' 区切り文字はオペレーティングシステムによって異なる場合があります。Windowsではセミコロン`;`が使用されますが、Linux ではコロン`:`が使用されます。<br><br>''2.'' Linuxシステムでは、変数を定義するだけでなく//''export''//する必要もあります。
|
||||
"""/>
|
||||
|
||||
追加のパスはそれぞれ、~TiddlyWiki5 GitHubリポジトリの同等のディレクトリのように、構造化されたフォルダを指す必要があります: プラグイン、テーマ、言語のディレクトリには`publisher/pluginname/<files>`が含まれ、エディションのディレクトリには`editionname/<files>`が含まれます
|
||||
|
||||
例:
|
||||
|
||||
```
|
||||
export TIDDLYWIKI_PLUGIN_PATH=~/MyPluginStore
|
||||
tiddlywiki mywiki --build index
|
||||
```
|
||||
@ -0,0 +1,16 @@
|
||||
created: 20150926162849519
|
||||
modified: 20241228110350676
|
||||
original-modified: 20191022095509822
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Installing TiddlyWiki Prerelease on Node.js
|
||||
ja-title: Node.jsにTiddlyWikiプレリリースをインストールする
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
# https://github.com/TiddlyWiki/TiddlyWiki5 からTiddlyWiki5 GitHubリポジトリのローカルコピーをクローンします
|
||||
# コマンドラインターミナルを開き、現在の作業ディレクトリをTiddlyWiki5リポジトリのルートに変更します
|
||||
# `npm link` (Windows) または `sudo npm link` (Mac/Linux) と入力して、[[npm]]にこのリポジトリのコピーをグローバルにインストールされたものとして使用するように指示します
|
||||
# ルート内で、次のようにして~TiddlyWikiを起動できます: <br/>``tiddlywiki editions/tw5.com-server --listen``
|
||||
|
||||
この手順を実行すると、通常の方法`npm install -g tiddlywiki`でインストールした場合と同じように、[[npm]]経由でTiddlyWiki5を操作できるようになります。
|
||||
|
||||
最新のコードを確実に取得するために、クローンを定期的に更新してください。
|
||||
@ -0,0 +1,23 @@
|
||||
created: 20191022095653896
|
||||
modified: 20250122105447127
|
||||
original-modified: 20220617130125173
|
||||
tags: [[TiddlyWiki on Node.js]] PluginsCS
|
||||
title: Installing custom plugins on Node.js
|
||||
ja-title: Node.jsにカスタムプラグインをインストールする
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
\rules except wikilink
|
||||
|
||||
! 紹介
|
||||
|
||||
Node.jsクライアントサーバー構成でTiddlyWikiを使用する場合、公式プラグインとカスタムプラグインをインストールするにはいくつかの方法があります。
|
||||
|
||||
注記
|
||||
<$macrocall $name=".note" _="""ライブラリから単一ファイルWikiにプラグインをインストールする手順については、[[プラグイン|Plugins]]で詳細を確認してください。
|
||||
"""/>
|
||||
|
||||
|
||||
!! プラグインのロード順序
|
||||
|
||||
{{Plugin Ordering}}
|
||||
|
||||
@ -0,0 +1,41 @@
|
||||
created: 20220611123344385
|
||||
modified: 20250123113223702
|
||||
original-modified: 20220617132351460
|
||||
tags: [[TiddlyWiki on Node.js]] PluginsCS
|
||||
title: Installing official plugins on Node.js
|
||||
ja-title: Node.jsに公式プラグインをインストールする
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
クライアント-サーバーNode.js構成でTiddlyWikiを使用する場合は、次の手順に従ってください:
|
||||
|
||||
# <<controlPanel-plugin-link>>の''プラグイン''タブを使用してインストールするプラグインを特定します。(ただし、ここからプラグインをインストール''しないで''ください)
|
||||
#* プラグインは、その種類(言語、テーマ、プラグイン)と発行元、タイトルによって識別されます。たとえば、`$:/plugins/tiddlywiki/internals`プラグインは''tiddlywiki/internals''として参照されます
|
||||
|
||||
# サーバーが実行中の場合は終了します
|
||||
|
||||
# `tiddlywiki.info`ファイル(JSON形式)を編集し、`plugins`、`themes`、`languages`セクションを見つけます(下記参照)
|
||||
|
||||
# 追加したいプラグインに対応するエントリを追加します
|
||||
#* 項目を区切る''カンマ''を残すように注意してください
|
||||
#* リストの最後の項目をコンマで終わらせ''ないで''ください
|
||||
|
||||
# サーバーを再起動します
|
||||
|
||||
```
|
||||
{
|
||||
"plugins": [
|
||||
"tiddlywiki/codemirror"
|
||||
],
|
||||
"themes": [
|
||||
"tiddlywiki/vanilla",
|
||||
"tiddlywiki/snowwhite"
|
||||
],
|
||||
"languages": [
|
||||
"es-ES",
|
||||
"fr-FR",
|
||||
"en-EN"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
<$macrocall $name=".note" _="プラグインの操作の概要については、[[プラグイン|Plugins]]を参照してください。<br>また、[[Node.jsにカスタムプラグインをインストールする|Installing custom plugins on Node.js]]も参照してください。"/>
|
||||
@ -0,0 +1,52 @@
|
||||
created: 20131219100637788
|
||||
modified: 20250124112753177
|
||||
original-modified: 20141015165343893
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Scripts for TiddlyWiki on Node.js
|
||||
ja-title: Node.js上のTiddlyWiki用スクリプト
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
! スクリプトファイル
|
||||
|
||||
TiddlyWiki5リポジトリの`bin`フォルダーには、共通のタスクを自動化したり、独自のスクリプトの便利な開始点として使用したりできるスクリプトがいくつか含まれています。https://tiddlywiki.com/ の構築とリリースに使用されるスクリプトの詳細については、[[Scripts for building tiddlywiki.com]]を参照してください。
|
||||
|
||||
すべてのスクリプトは、リポジトリのルートフォルダーから実行されることを想定しています。
|
||||
|
||||
!! `serve`: tw5.comを提供する
|
||||
|
||||
```
|
||||
./bin/serve.sh -h
|
||||
./bin/serve.sh [edition dir] [username] [password] [host] [port]
|
||||
```
|
||||
|
||||
または:
|
||||
|
||||
```
|
||||
./bin/serve.cmd -h
|
||||
./bin/serve.cmd [edition dir] [username] [password] [host] [port]
|
||||
```
|
||||
|
||||
このスクリプトは、TiddlyWiki5をHTTPサーバーとして実行し、`tw5.com-server`エディションのコンテンツをデフォルトにします。デフォルトでは、Node.jsは8080ポート でサービスを提供します。オプションの`username`パラメータが指定されている場合は、編集の署名に使用されます。`password`が指定されている場合は、HTTP基本認証が使用されます。`-h`パラメータを指定してスクリプトを実行すると、オンラインヘルプが表示されます。
|
||||
|
||||
この構成を試すには、スクリプトを実行してからブラウザで`http://127.0.0.1:8080`にアクセスしてください。
|
||||
|
||||
ブラウザで行われた変更は、HTTP経由でサーバーに伝えられます(これらのリクエストを確認するには、ブラウザ開発者コンソールを使用します)。その後、サーバーは変更をファイルシステムに同期します(各変更をスクリーンに記録します)。
|
||||
|
||||
!! `test`: テストをビルドして実行する
|
||||
|
||||
This script runs the `test` edition of TiddlyWiki on the server to perform the server-side tests and to build `test.html` for running the tests in the browser.
|
||||
このスクリプトは、サーバー側のテストを実行し、ブラウザでテストを実行するために、`test.html`をビルドし、サーバー上でTiddlyWikiの`test`のエディションを実行します。
|
||||
|
||||
!! `lazy`: tw5.comを遅延読み込み画像で提供する
|
||||
|
||||
```
|
||||
./bin/lazy.sh <username> [<password>]
|
||||
```
|
||||
|
||||
または:
|
||||
|
||||
```
|
||||
./bin/lazy.cmd <username> [<password>]
|
||||
```
|
||||
|
||||
このスクリプトは、画像に[[遅延読み込み|LazyLoading]]を適用して`tw5.com-server`エディションコンテンツを提供します。
|
||||
24
editions/ja-JP/tiddlers/nodejs/TiddlyWiki on Node.js.tid
Normal file
24
editions/ja-JP/tiddlers/nodejs/TiddlyWiki on Node.js.tid
Normal file
@ -0,0 +1,24 @@
|
||||
created: 20131129094353704
|
||||
modified: 20241227105025118
|
||||
original-modified: 20220617114433107
|
||||
tags: Platforms
|
||||
title: TiddlyWiki on Node.js
|
||||
ja-title: Node.js上のTiddlyWiki
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
\rules except wikilink
|
||||
|
||||
[[Node.js]]でTiddlyWikiを実行すると、単一ファイルバージョンに比べていくつかの重要な利点が得られます:
|
||||
|
||||
* 個々のTiddlerは別々のファイルに保存され、必要に応じて整理できます。
|
||||
|
||||
* 共有コンテンツと独自コンテンツのさまざまな組み合わせをブレンドした複数のWikiを構築する機能
|
||||
|
||||
* スマートフォンやタブレットを含むあらゆる最新ブラウザでコンテンツを編集できます
|
||||
|
||||
<<.warning """Node.js上のTiddlyWikiは現在、実行中にファイルシステム経由でTiddlerファイルを直接変更することをサポートしていないことに注意してください。変更を有効にするには、サーバーを再起動する必要があります。実行中の Wikiを編集するには、HTTPやJavaScript APIを使用することをお勧めします。""">>
|
||||
|
||||
|
||||
詳細については、以下を参照してください:
|
||||
|
||||
<<list-links "[tag[TiddlyWiki on Node.js]]">>
|
||||
@ -0,0 +1,33 @@
|
||||
created: 20220611125113040
|
||||
modified: 20250204103637098
|
||||
original-modified: 20220617133704286
|
||||
tags: [[TiddlyWiki on Node.js]] PluginsCS
|
||||
title: Uninstalling a plugin with Node.js
|
||||
ja-title: Node.jsでプラグインをアンインストールする
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
クライアント-サーバー Node.js構成でTiddlyWikiを使用する場合は、次の手順に従ってください:
|
||||
|
||||
# サーバーが実行中の場合は終了します
|
||||
|
||||
# `tiddlywiki.info`ファイル(JSON形式)を編集し、`plugins`と`themes`セクションを見つけます(下記参照)
|
||||
|
||||
# 削除したいプラグインに対応するエントリを削除します
|
||||
#* 項目を区切る''カンマ''を残すように注意してください
|
||||
#* リストの最後の項目をコンマで終わらせ''ない''でください
|
||||
|
||||
# サーバーを再起動します
|
||||
|
||||
```
|
||||
{
|
||||
"plugins": [
|
||||
"tiddlywiki/codemirror"
|
||||
],
|
||||
"themes": [
|
||||
"tiddlywiki/vanilla",
|
||||
"tiddlywiki/snowwhite"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
<$macrocall $name=".note" _="プラグインの操作方法の概要については、[[プラグイン|Plugins]]で確認できます"/>
|
||||
@ -0,0 +1,19 @@
|
||||
created: 20131219100544073
|
||||
modified: 20241228112745930
|
||||
original-modified: 20140912141800426
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Upgrading TiddlyWiki on Node.js
|
||||
ja-title: Node.js上のTiddlyWikiのアップグレード
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
通常の方法で[[Node.js上のTiddlyWiki|TiddlyWiki on Node.js]]をインストールした場合、新しいバージョンがリリースされたときに、次のコマンドでアップグレードできます:
|
||||
|
||||
```
|
||||
npm update -g tiddlywiki
|
||||
```
|
||||
|
||||
MacやLinuxでは、次のように''sudo''を追加する必要があります:
|
||||
|
||||
```
|
||||
sudo npm update -g tiddlywiki
|
||||
```
|
||||
@ -0,0 +1,43 @@
|
||||
created: 20131219100520659
|
||||
modified: 20250206101730728
|
||||
original-modified: 20241025051303991
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Using TiddlyWiki on Node.js
|
||||
ja-title: Node.jsでTiddlyWikiを使用する
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
~TiddlyWiki5には、[[TiddlyWikiフォルダ|TiddlyWikiFolders]]、[[Tiddlerファイル|TiddlerFiles]]に基づいて広範な操作を実行するためにコマンドラインで使用するコマンドセットが含まれています。
|
||||
|
||||
たとえば、次のコマンドは、~TiddlyWiki HTMLファイルからTiddlerを読み込み、そのうちの1つを静的HTMLに保存します:
|
||||
|
||||
```
|
||||
tiddlywiki --verbose --load mywiki.html --render ReadMe ./readme.html
|
||||
```
|
||||
|
||||
コマンドラインから`tiddlywiki`を実行すると、~TiddlyWikiカーネルが起動し、コアプラグインがロードされ、空のWikiストアが確立されます。次に、コマンドライン引数を左から右に順番に処理します。引数はスペースで区切られます。
|
||||
|
||||
<<.from-version "5.1.20">> まず、プレフィックス`+`で始まるプラグイン名や、`++`で始まるプラグインフォルダーへのパスによって識別される0個以上のプラグイン参照が存在する可能性があります。これらのプラグインは、[[TiddlyWikiフォルダ|TiddlyWikiFolders]]で指定されたプラグインに加えてロードされます。
|
||||
|
||||
次の引数は、ロードする[[TiddlyWikiフォルダ|TiddlyWikiFolders]]へのオプションのパスです。存在しない場合は、現在のディレクトリが使用されます。
|
||||
|
||||
コマンドとそれぞれの引数は以下のように示されます。各コマンドはプレフィックス`--`で識別されます。
|
||||
|
||||
```
|
||||
tiddlywiki [+<pluginname> | ++<pluginpath>] [<wikipath>] [--<command> [<arg>[,<arg>]]]
|
||||
```
|
||||
|
||||
例えば:
|
||||
|
||||
```
|
||||
tiddlywiki --version
|
||||
tiddlywiki +plugins/tiddlywiki/filesystem +plugins/tiddlywiki/tiddlyweb mywiki --listen
|
||||
tiddlywiki ++./mygreatplugin mywiki --listen
|
||||
```
|
||||
|
||||
<<.from-version "5.1.18">> 多数のパラメータをサポートするListenCommandなどのコマンドでは、[[名前付きコマンドパラメータ|NamedCommandParameters]]を使用して扱いやすくすることができます。例:
|
||||
|
||||
```
|
||||
tiddlywiki wikipath --listen username=jeremy port=8090
|
||||
```
|
||||
|
||||
使用可能なコマンドの完全なリストについては、[[コマンド|Commands]]を参照してください。
|
||||
@ -0,0 +1,25 @@
|
||||
created: 20131219100444289
|
||||
modified: 20250206103847601
|
||||
original-modified: 20140920134404247
|
||||
tags: [[TiddlyWiki on Node.js]]
|
||||
title: Working with the TiddlyWiki5 repository
|
||||
ja-title: TiddlyWiki5リポジトリの操作
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
! 紹介
|
||||
|
||||
TiddlyWikiの開発に[[貢献|Contributing]]したい場合は、[[通常の方法でTiddlyWikiをインストールする|Installing TiddlyWiki on Node.js]]のではなく、GitHubリポジトリを直接動かすことができます。
|
||||
|
||||
Mario Pietschが[[短い紹介動画|Working with the TiddlyWiki5 repository video]]を作成しました。
|
||||
|
||||
! セットアップ
|
||||
|
||||
# GitHubのアカウントをお持ちでない場合は、アカウントを作成してください
|
||||
# https://github.com/TiddlyWiki/TiddlyWiki5 からTiddlyWiki5 GitHubリポジトリをフォークします
|
||||
# フォークのローカルコピーをクローンします
|
||||
# コマンドラインターミナルを開き、現在の作業ディレクトリをリポジトリのルートに変更します
|
||||
# `npm link` (Windows)か`sudo npm link` (Mac/Linux)と入力して、[[npm]]にこのリポジトリのコピーをグローバルにインストールされたものとして使用するように指示します
|
||||
|
||||
この手順を実行すると、`npm install -g tiddlywiki`による通常の方法でインストールした場合と同じように、[[npm]]経由でTiddlyWiki5を操作できるようになります。
|
||||
|
||||
[[Node.js上のTiddlyWiki用スクリプト|Scripts for TiddlyWiki on Node.js]]も参照してください。
|
||||
172
editions/ja-JP/tiddlers/nodejs/tiddlywiki.files_Files.tid
Normal file
172
editions/ja-JP/tiddlers/nodejs/tiddlywiki.files_Files.tid
Normal file
@ -0,0 +1,172 @@
|
||||
created: 20161015114118243
|
||||
modified: 20250201104758596
|
||||
original-modified: 20211114101256212
|
||||
tags: TiddlyWikiFolders [[TiddlyWiki on Node.js]]
|
||||
title: tiddlywiki.files Files
|
||||
ja-title: tiddlywiki.filesファイル
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
! 紹介
|
||||
|
||||
[[TiddlyWikiフォルダ|TiddlyWikiFolders]]内のサブフォルダーにあるJSONファイル`tiddlywiki.files`は、フォルダーを再帰的にスキャンしてTiddlerファイルを探す通常のロジックをオーバーライドします。代わりに、`tiddlywiki.files`ファイルは特定のファイルとフォルダーからTiddlerをロードするための指示を指定します。
|
||||
|
||||
ファイルの形式は、2つのオプションプロパティを持つオブジェクトです:
|
||||
|
||||
* ''tiddlers'' - ファイルから読み取ったフィールドを上書きや変更する機能を持つ外部ファイルを記述するオブジェクトの配列
|
||||
* ''directories'' - 外部ディレクトリを記述するオブジェクトの配列、それらのディレクトリ内のどのファイルを処理すべきかを決定するフィルターと、ファイルから読み取ったフィールドのいずれかを上書きや変更する機能
|
||||
|
||||
`tiddlywiki.files`の処理に大幅な機能強化が[[リリース 5.1.14|Release 5.1.14]]で導入されたことに注意してください。
|
||||
|
||||
!! フィールドのオーバーライド
|
||||
|
||||
`tiddlywiki.files`ファイルの''tiddlers''セクションと''directories''セクションの両方に、`fields`オブジェクトを使用してフィールドの値を上書きやカスタマイズする機能が含まれています。
|
||||
|
||||
各フィールドは、フィールドに直接割り当てられる''文字列''や''配列''値として指定することも、<<.from-version "5.1.14">>フィールドの値を生成する方法を説明する''オブジェクト''として指定することもできます。オブジェクトには次のプロパティが含まれます:
|
||||
|
||||
* ''source'' - (オプション) フィールドのソース値を指定する文字列。指定しない場合は、既存の値が使用されます
|
||||
** //filename// Tiddlerを含むファイルのファイル名
|
||||
** //filename-uri-decoded// [[URIデコード|https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent]]を適用した、Tiddlerを含むファイルのファイル名
|
||||
** //basename// 拡張子なしのTiddlerを含むファイルのファイル名
|
||||
** //basename-uri-decoded// [[URIデコード|https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent]]を適用した、拡張子なしのTiddlerを含むファイルのファイル名
|
||||
** //extname// Tiddlerを含むファイル名の拡張子
|
||||
** //created// Tiddlerを含むファイルの作成日時
|
||||
** //modified// Tiddlerを含むファイルの更新日時
|
||||
** <<.from-version "5.3.0">> //filepath// ディレクトリの''path''プロパティを基準とした、Tiddlerを含むファイルのパス(''directories''宣言でのみ使用可能)
|
||||
** <<.from-version "5.3.0">> //subdirectories// ディレクトリの''path''プロパティを基準とした、ファイルの相対パス内のサブディレクトリの配列(''directories''宣言でのみ使用可能)
|
||||
* ''prefix'' - (オプション) フィールドの値の先頭に追加する文字列
|
||||
* ''suffix'' - (オプション) フィールドの値の末尾に追加する文字列
|
||||
|
||||
! Tiddlersセクション
|
||||
|
||||
`tiddlers`配列内のファイルの仕様は、次のプロパティをサポートします:
|
||||
|
||||
* ''file'': (必須) Tiddlerデータを含むファイルへの絶対パスまたは相対パス (相対パスは`tiddlywiki.files`ファイルのパスを基準とします)
|
||||
* ''isTiddlerFile'': (オプション) `true`の場合、ファイルは[[tiddlerファイル|TiddlerFiles]]として扱われ、Tiddlerを抽出するためにデシリアライズされます。それ以外の場合は、ファイルの生のコンテンツが解析されずに`text`フィールドに割り当てられます
|
||||
* ''fields'': (オプション) Tiddlerファイルで提供されるフィールドを上書きやカスタマイズする値を含むオブジェクト (上記を参照)
|
||||
* ''prefix''と''suffix'': (オプション) Tiddlerの`text`フィールドにプレフィックスとサフィックスとして付加される文字列
|
||||
*> ''prefix''を指定することは、''fields''オブジェクトの`text`のフィールドを`{"prefix":"<prefixvalue>"}`に設定することと同じであることに注意してください。
|
||||
|
||||
! Directoriesセクション
|
||||
|
||||
`directories`配列内のディレクトリの仕様は次の形式を取ることができます:
|
||||
|
||||
* Tiddlerファイルを含むディレクトリへの絶対パスか相対パスを指定する、''string''リテラル(相対パスは`tiddlywiki.files`ファイルのパスを基準として解釈されます)。Tiddlerファイルはディレクトリを再帰的に検索されます
|
||||
* <<.from-version "5.1.14">> 次のプロパティを持つ''object'':
|
||||
** ''path'' - (必須) Tiddlerファイルを含むディレクトリへの絶対パスか相対パス(相対パスは`tiddlywiki.files`ファイルのパスを基準として解釈されます)。デフォルトではディレクトリは再帰的に検索されないことに注意してください。//searchSubdirectories//フラグが`true`に設定されていない限り、サブディレクトリは無視されます(以下を参照)。
|
||||
** ''filesRegExp'' - (オプション) ディレクトリ内で処理するファイルのファイル名に一致する[[正規表現|https://developer.mozilla.org/en/docs/Web/JavaScript/Guide/Regular_Expressions]]
|
||||
** ''isTiddlerFile'' - (必須) `true`の場合、ファイルは[[Tiddlerファイル|TiddlerFiles]]として扱われ、Tiddlerを抽出するためにデシリアライズされます。それ以外の場合、ファイルの生のコンテンツが解析されずに`text`フィールドに割り当てられます
|
||||
** ''isEditableFile'' - <<.from-version "5.1.23">> (オプション) `true`の場合、Tiddlerへの変更は元のファイルに保存されます。Tiddlerは、$:/config/FileSystemPathフィルターから結果が生成されない限り、元のファイルパスに保存されます。フィルターから結果が返された場合、生成された最終的なファイルパスが上書きされます。
|
||||
** ''searchSubdirectories'' - <<.from-version "5.1.23">> (オプション) `true`の場合、//path//のすべてのサブディレクトリで(オプションの)//filesRegExp//に一致するファイルが再帰的に検索されます。//filesRegExp//が指定されていない場合は、//path//のすべてのサブディレクトリ内のすべてのファイルがロードされます。//source//属性の//filename//(上記を参照)によって生成されたTiddlerタイトルにはファイル名のみが含まれ、パスのサブディレクトリは含まれません。この結果、同じTiddlerタイトルでロードされた複数のファイルが存在する場合、そのTiddlerタイトルでロードされた最後のファイルのみがメモリに格納されます。これを防ぐには、//filename//の代わりに//filepath//属性を使用できます。または、複数のディレクトリオブジェクトを含め、//source//属性とともに//prefix//または//suffix//を使用してタイトルフィールドをカスタマイズすることもできます。
|
||||
** ''fields'' - (必須) Tiddlerファイルで提供されるフィールドを上書きやカスタマイズする値を含むオブジェクト(上記を参照)
|
||||
|
||||
同じ名前にサフィックス`.meta`を加えたファイルを作成することで、特定のファイルのフィールドを上書きすることもできます。 -- TiddlerFilesを参照してください。
|
||||
|
||||
! 例
|
||||
|
||||
これらの`tiddlywiki.files`の例は、[[Wikiフォルダ|TiddlyWikiFolders]]の独自のサブディレクトリに配置する必要があります。
|
||||
|
||||
メインの[[TiddlyWiki 5 GitHub リポジトリ|https://github.com/TiddlyWiki/TiddlyWiki5]]にも`tiddlywiki.files`ファイルの例がいくつかあります。
|
||||
|
||||
!! PDFのフォルダをインポートする
|
||||
|
||||
この例では、相対パスで指定されたフォルダーから拡張子`.pdf`を持つすべてのファイルを取得します。このパスは"../../../"で始まり、この構成ファイルが格納されているフォルダーの3ディレクトリ階層上を示します。各Tiddlerは、次のフィールドを使用してLazyLoading用にセットアップされています:
|
||||
|
||||
* ''title'' - PDFファイルのURIデコードされたベースファイル名を設定。[[URIデコード|https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent]]により、"/"などの文字をURIエンコードして"%2F"としてタイトルに含めることができます
|
||||
* ''created'' - PDFファイルの作成日時を設定
|
||||
* ''modified'' - PDFファイルの変更日時を設定
|
||||
* ''type'' - `application/pdf`を設定
|
||||
* ''tags'' - `$:/tags/AttachedFile`を設定
|
||||
* ''text'' - 空の文字列を設定
|
||||
* ''_canonical_uri'' - ファイル名と文字列"pdfs/"を連結した値を設定
|
||||
|
||||
```
|
||||
{
|
||||
"directories": [
|
||||
{
|
||||
"path": "../../../input/pdfs",
|
||||
"filesRegExp": "^.*\\.pdf$",
|
||||
"isTiddlerFile": false,
|
||||
"fields": {
|
||||
"title": {"source": "basename-uri-decoded"},
|
||||
"created": {"source": "created"},
|
||||
"modified": {"source": "modified"},
|
||||
"type": "application/pdf",
|
||||
"tags": ["$:/tags/AttachedFile"],
|
||||
"text": "",
|
||||
"_canonical_uri": {"source": "filename", "prefix": "pdfs/"}
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
!! テキストファイルのフォルダをインポートする
|
||||
|
||||
この例では、相対パスで指定されたフォルダから拡張子`.txt`を持つすべてのファイルを取得します。このフォルダはWikiのベースディレクトリ内にあり、現在の構成ファイルはWikiの"tiddlers/"ディレクトリ内のディレクトリにあります。したがって、この場合、パスは"../../"で始まり、2つのディレクトリ階層上に移動し、次に "externalnotes/"ディレクトリまで下ります。各Tiddlerは次のフィールドで設定されます:
|
||||
|
||||
* ''title'' - テキストファイルのURIデコードされたベースファイル名を設定します。[[URIデコード|https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent]]により、"/"などの文字をURIエンコードして"%2F"としてタイトルに含めることができます
|
||||
* ''created'' - テキストファイルの作成日時を設定
|
||||
* ''modified'' - テキストファイルの変更日時を設定
|
||||
* ''type'' - `text/plain`を設定
|
||||
* ''tags'' - `[[note]] [[externalnote]] [[.txt]]`を設定(配列表記を使用)
|
||||
* ''text'' - 設定されないため、ファイルの内容がテキストフィールドとして読み込まれます
|
||||
|
||||
```
|
||||
{
|
||||
"directories": [
|
||||
{
|
||||
"path": "../../externalnotes",
|
||||
"filesRegExp": ".+\\.txt",
|
||||
"isTiddlerFile": false,
|
||||
"isEditableFile": true,
|
||||
"fields": {
|
||||
"title": {"source": "basename-uri-decoded"},
|
||||
"created": {"source": "created"},
|
||||
"modified": {"source": "modified"},
|
||||
"type": "text/plain",
|
||||
"tags": ["note", "externalnote", ".txt"]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
これにより、`../../externalnotes/`ディレクトリ内のすべてのテキストファイルが個別のTiddlerとしてWikiに読み込まれます。これらは、さまざまなマークアップ言語のスニペットコレクションである可能性があります。次に、これらの各Tiddlerの`type`フィールドを、言語に合わせて変更できます。たとえば、Wikitextの場合は"text/vnd.tiddlywiki"、マークダウンファイルの場合は"text/markdown"です。次に、次の行で$:/config/FileSystemPathsと$:/config/FileSystemExtentions Tiddlerを使用すると、これらのTiddlerへの変更が、開始元のディレクトリに保存され、"*.txt"ファイルとして、"*.txt.meta"ファイルとともに保存されます。これらのメタファイルは必要に応じて生成され、サーバーの再起動時に、`tiddlywiki.files`構成ファイルから生成されたフィールド(Tiddlerの`type`フィールドなど)が上書きされます。
|
||||
|
||||
[[Tiddlerファイル名のカスタマイズ|Customising Tiddler File Naming]]の例から、$:/config/FileSystemPaths Tiddler内の最後のフィルター`[!tag[externalnote]addprefix[wiki/]]`は、`externalnotes`でタグ付けされたすべてのTiddler(以前のフィルターに一致しなかったもの)を除外することがわかります。これらのTiddlerのファイルパスは、ブート起動時に生成された$:/config/OriginalTiddlerPathsから取得されます。
|
||||
|
||||
次に、$:/config/FileSystemExtensions Tiddler内のフィルター`[tag[.txt]then[.txt]]`により、これらすべてのTiddlerが*.txtおよび付随する*.txt.metaファイルとしてディスクに保存されます(通常のTiddlerタイプとファイルタイプのマッピングを上書きします)。この場合、Tiddlywiki Wikitextやマークダウンテキストのスニペットを"テキスト"(*.txtファイル)に保存できるようになります。
|
||||
|
||||
!! 画像のインポートと自動タグ付け
|
||||
|
||||
この例では、`files`ディレクトリとそのすべてのサブディレクトリ内のすべての画像ファイルを外部画像Tiddlerとしてインポートし、ファイルパスに基づいてタグ付けします。各Tiddlerには、次のフィールドが設定されます:
|
||||
|
||||
* ''title'' - テキストファイルのURIデコードされたベースファイル名を設定
|
||||
* ''created'' - テキストファイルの作成日時を設定
|
||||
* ''modified'' - テキストファイルの更新日時を設定
|
||||
* ''type'' - `image/jpeg`に設定します。現在、ファイルから画像Tiddlerの正しいContentTypeを推測する方法はありませんが、`image/jpeg`Tiddlerはpngやgif画像でも正しくレンダリングされるはずです。代わりに、jpg、png、gifファイルの個別の定義を、`image/jpeg`、`image/png`、`image/gif`タイプをそれぞれ使用して作成することもできます。
|
||||
* ''tags'' - 親ディレクトリ(この場合は`files`)を基準とした画像の相対パスに基づいて生成されます。たとえば、`files/photos`内の画像には`photos`のタグが付けられ、 `files/photos/family`内の画像には`photos`と`family`両方のタグが付けられ、ルート`files`ディレクトリ内の画像にはタグが付けられません。
|
||||
* ''text'' - 空の文字列に設定
|
||||
* ''_canonical_uri'' - Wikiルートを基準とした画像の完全な相対ファイルパスを設定
|
||||
|
||||
```
|
||||
{
|
||||
"directories": [
|
||||
{
|
||||
"path": "../../files/",
|
||||
"filesRegExp": "^.*\\.(?:jpg|jpeg|png|gif)$",
|
||||
"isTiddlerFile": false,
|
||||
"searchSubdirectories": true,
|
||||
"fields": {
|
||||
"title": {"source": "basename-uri-decoded"},
|
||||
"created": {"source": "created"},
|
||||
"modified": {"source": "modified"},
|
||||
"type": "image/jpeg",
|
||||
"tags": { "source": "subdirectories" },
|
||||
"text": "",
|
||||
"_canonical_uri": { "source": "filepath", "prefix": "files/" }
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
60
editions/ja-JP/tiddlers/nodejs/tiddlywiki.info_Files.tid
Normal file
60
editions/ja-JP/tiddlers/nodejs/tiddlywiki.info_Files.tid
Normal file
@ -0,0 +1,60 @@
|
||||
created: 20161015114042793
|
||||
modified: 20250201105445142
|
||||
original-modified: 20241030132156792
|
||||
tags: TiddlyWikiFolders [[TiddlyWiki on Node.js]]
|
||||
title: tiddlywiki.info Files
|
||||
ja-title: tiddlywiki.infoファイル
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
[[TiddlyWikiフォルダ|TiddlyWikiFolders]]はWikiフォルダーのルートにある1つの`tiddlywiki.info`ファイルで構成されます。このファイルには、次のプロパティを含むJSONオブジェクトが含まれている必要があります:
|
||||
|
||||
* ''plugins'' - Wikiに含めるプラグインの配列
|
||||
* ''themes'' - Wikiに含めるテーマの配列
|
||||
* ''languages'' - Wikiに含める言語の配列
|
||||
* ''includeWikis'' - Wikiに含める外部Wikiフォルダへの参照の配列
|
||||
* ''build'' - 名前付きビルドターゲットのハッシュマップ。それぞれはコマンドトークンの配列で定義されます(BuildCommandを参照)
|
||||
* ''config'' - 設定オプションのオプションのハッシュマップ(下記参照)
|
||||
|
||||
!!! ''includeWikis''
|
||||
|
||||
''includeWikis''配列のエントリは、Wikiへの相対パスを指定する文字列か、次のフィールドを持つオブジェクトのいずれかになります:
|
||||
|
||||
* ''path'' - Wikiフォルダへの相対パス
|
||||
* ''read-only'' - //true//に設定すると、含まれているWiki内のTiddlerが変更されるのを防ぎます。変更は、以下で説明する''default-tiddler-location''で指定されたディレクトリに書き込まれます
|
||||
|
||||
!!! ''build''
|
||||
|
||||
現在の`tiddlywiki.info`ファイルでその名前のターゲットが定義されていない場合、含まれているWikiのビルドターゲットはマージされることに注意してください。
|
||||
|
||||
!!! ''config''
|
||||
|
||||
構成オプションには以下が含まれます:
|
||||
|
||||
* ''default-tiddler-location'' - ファイルシステムアダプタが新しいTiddlerを保存するためのデフォルトの場所への文字列パス(Wikiフォルダを基準に解決)
|
||||
* ''retain-original-tiddler-path'' - trueの場合、サーバーはWiki内の各Tiddlerの元のファイルパスを含むティドラー[[$:/config/OriginalTiddlerPaths]]を生成します
|
||||
|
||||
!!! 例
|
||||
|
||||
例:
|
||||
|
||||
```
|
||||
{
|
||||
"plugins": [
|
||||
"tiddlywiki/tiddlyweb",
|
||||
"tiddlywiki/filesystem"
|
||||
],
|
||||
"includeWikis": [
|
||||
{"path": "../tw5.com", "read-only": true}
|
||||
],
|
||||
"build": {
|
||||
"index": [
|
||||
"--render","$:/core/save/all","index.html","text/plain"],
|
||||
"favicon": [
|
||||
"--save", "$:/favicon.ico", "favicon.ico",
|
||||
"--save", "$:/green_favicon.ico", "static/favicon.ico"]
|
||||
},
|
||||
"config": {
|
||||
"retain-original-tiddler-path": true
|
||||
}
|
||||
}
|
||||
```
|
||||
12
editions/ja-JP/tiddlers/platforms/Platforms.tid
Normal file
12
editions/ja-JP/tiddlers/platforms/Platforms.tid
Normal file
@ -0,0 +1,12 @@
|
||||
created: 20150412185300152
|
||||
modified: 20241227104147434
|
||||
original-modified: 20150412185427211
|
||||
tags: TableOfContents
|
||||
title: Platforms
|
||||
ja-title: プラットフォーム
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
|
||||
TiddlyWikiはいくつかのプラットフォームで使用できます:
|
||||
|
||||
<<list-links "[tag[Platforms]]">>
|
||||
49
editions/ja-JP/tiddlers/plugins/Plugin Ordering.tid
Normal file
49
editions/ja-JP/tiddlers/plugins/Plugin Ordering.tid
Normal file
@ -0,0 +1,49 @@
|
||||
created: 20220613115453346
|
||||
modified: 20250207104327815
|
||||
original-modified: 20220628160136158
|
||||
tags: PluginMechanism
|
||||
title: Plugin Ordering
|
||||
ja-title: プラグインの順序
|
||||
type: text/vnd.tiddlywiki
|
||||
|
||||
Node.jsクライアント-サーバー構成を使用すると、プラグインは次の順序でアクティブになります:
|
||||
|
||||
# OS環境変数を使用して見つかったプラグイン
|
||||
#* 参照: [[PluginFolders]]
|
||||
#* および: [[Node.jsの環境変数|Environment Variables on Node.js]]
|
||||
|
||||
# Wiki`/plugins`パスに保存されたプラグイン
|
||||
#* 参照: [[PluginFolders]]
|
||||
|
||||
# コマンドラインで指定されたプラグイン
|
||||
#* 参照: [[Node.jsでTiddlyWikiを使用する|Using TiddlyWiki on Node.js]] ... <<.from-version "5.1.20">>に関する注記
|
||||
|
||||
# ドラッグアンドドロップでWikiコンテンツとしてインポートされたプラグイン
|
||||
#* 参照: [[プラグインライブラリからプラグインをインストールする|Installing a plugin from the plugin library]]や[[プラグインを手動でインストールする|Manually installing a plugin]]
|
||||
|
||||
''重要:''
|
||||
|
||||
* ''リストの下位の要素が優先されます''
|
||||
|
||||
*ブラウザにドラッグアンドドロップして通常のTiddlerとしてプラグインを追加すると、プラグインはブラウザ内でのみアクティブになります
|
||||
** Node.js下では利用できません
|
||||
|
||||
オプション 1:
|
||||
|
||||
* Node.js構成を使用する場合、オプション1が最も一般的な方法です
|
||||
* すべてのプラグインを一度に更新できるため、メンテナンスの手間が軽減されます
|
||||
|
||||
オプション 2:
|
||||
|
||||
* 構成を固定して作業したい場合はオプション2が推奨されます
|
||||
* プラグインの更新は対応するWikiにのみ影響します
|
||||
|
||||
オプション 3:
|
||||
|
||||
* このオプションを使用すると、既存の`tiddlywiki.info`ファイルを上書きすることなくエディションを''追加して開始''できます
|
||||
* tiddlywiki.infoファイルで指定されていない場合でも、任意のエディションをクライアント-サーバーエディションとして起動できます。
|
||||
|
||||
オプション 4:
|
||||
|
||||
* 単一ファイルのWikiで使用されるのと全く同じメカニズムです
|
||||
* このメカニズムは、プラグインが`tiddlers/`ディレクトリに保存されるため、Node.js構成では''テストとデバッグ''の目的でのみ使用する必要があります
|
||||
@ -0,0 +1,2 @@
|
||||
title: $:/config/tiddlyweb/host
|
||||
text: $protocol$//$host$/MyApp/
|
||||
@ -0,0 +1,7 @@
|
||||
title: Example config-tiddlyweb-host for IIS
|
||||
ja-title: IISのconfig-tiddlyweb-hostの例
|
||||
created: 20180328145039530
|
||||
modified: 20250123113649343
|
||||
original-modified: 20180328145234871
|
||||
tags: [[Installing TiddlyWiki on Microsoft Internet Information Server]]
|
||||
type: text/plain
|
||||
@ -0,0 +1,8 @@
|
||||
{
|
||||
"name": "MyStuff",
|
||||
"description": "A description of this wiki",
|
||||
"dependencies": {
|
||||
"sax": "1.2.4",
|
||||
"tiddlywiki": "*"
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,7 @@
|
||||
created: 20180328145039530
|
||||
modified: 20250123114135455
|
||||
original-modified: 20180328145234871
|
||||
tags: [[Installing TiddlyWiki on Microsoft Internet Information Server]]
|
||||
title: Example package.json for IIS
|
||||
ja-title: IISのpackage.jsonの例
|
||||
type: text/plain
|
||||
@ -0,0 +1,11 @@
|
||||
{
|
||||
"description": "My wiki",
|
||||
"plugins": [
|
||||
"tiddlywiki/tiddlyweb",
|
||||
"tiddlywiki/filesystem"
|
||||
],
|
||||
"themes": [
|
||||
"tiddlywiki/vanilla",
|
||||
"tiddlywiki/snowwhite"
|
||||
]
|
||||
}
|
||||
@ -0,0 +1,7 @@
|
||||
created: 20180328151124878
|
||||
modified: 20250123114435480
|
||||
original-modified: 20180328151214616
|
||||
tags: [[Installing TiddlyWiki on Microsoft Internet Information Server]]
|
||||
title: Example tiddlywiki.info for IIS
|
||||
ja-title: IISのtiddlywiki.infoの例
|
||||
type: text/plain
|
||||
@ -0,0 +1,25 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<configuration>
|
||||
<system.webServer>
|
||||
<handlers>
|
||||
<add
|
||||
name="httpplatformhandler"
|
||||
path="*"
|
||||
verb="*"
|
||||
modules="httpPlatformHandler"
|
||||
resourceType="Unspecified"
|
||||
requireAccess="Script" />
|
||||
</handlers>
|
||||
<httpPlatform
|
||||
stdoutLogEnabled="true"
|
||||
stdoutLogFile=".\node.log"
|
||||
startupTimeLimit="20"
|
||||
processPath="C:\Program Files\nodejs\node.exe"
|
||||
arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki --listen port=PORT path-prefix=/MyApp">
|
||||
<environmentVariables>
|
||||
<environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" />
|
||||
<environmentVariable name="NODE_ENV" value="Production" />
|
||||
</environmentVariables>
|
||||
</httpPlatform>
|
||||
</system.webServer>
|
||||
</configuration>
|
||||
@ -0,0 +1,7 @@
|
||||
created: 20180328145259455
|
||||
modified: 20250123114732207
|
||||
original-modified: 20180701185215523
|
||||
tags: [[Installing TiddlyWiki on Microsoft Internet Information Server]]
|
||||
title: Example web.config for IIS
|
||||
ja-title: IISのweb.configの例
|
||||
type: text/plain
|
||||
Loading…
x
Reference in New Issue
Block a user