Add chinese help texts for "save" and "render" commands (#2975)

2024-11-23 10:07:19 +00:00 · 2017-09-16 22:30:37 +08:00 · 2017-09-16 22:30:37 +08:00 · 46453d23cb
commit 46453d23cb
parent c069d48a2a
12 changed files with 133 additions and 5 deletions
--- a/languages/zh-Hans/Help/render.tid
+++ b/languages/zh-Hans/Help/render.tid
@ -0,0 +1,33 @@
+title: $:/language/Help/render
+description: 呈现个别条目到文件
+
+呈现个别条目，并将结果保存到指定的文件。
+
+可选择性地指定范本条目名称，在此情况下，"currentTiddler" 变量设为呈现中的条目名称，用以呈现范本条目。
+
+也可以选择性地指定附加变量的名称和值。
+
+```
+--render <tiddler-filter> [<filename-filter>] [<render-type>] [<template>] [<name>] [<value>]
+```
+
+* ''tiddler-filter'': 标识要呈现的条目的筛选器
+* ''filename-filter'': 可选的筛选器，转换条目名称至路径名。如果省略，默认为 `[is[tiddler]addsuffix[.html]]`，其使用未改变的条目名称为文件名
+* ''template'': 可选的范本，用于呈现每个条目
+* ''render-type'': 可选的呈现类型：`text/html` (默认值) 会传回完整的 HTML 文本，而 `text/plain` 只会传回文本内容 (即其忽略 HTML 标记与其他不可印出的数据)
+* ''name'': 可选的变量名称
+* ''value'': 可选的变量值
+
+缺省情况下，文件名被解析为相对于发行版文件夹的 `output` 子文件夹。`--output` 命令可用于将输出指到一个不同的文件夹。
+
+附注：
+
+* 输出目录不清除任何现有的文件
+* 文件名的路径中，任何不存在的文件夹，将自动创建。
+* 当正呈现的条目名称中带有空格，请注意同时使用命令行接口所要求的引号，与 TiddlyWiki 的双重方括号；`--render "[[Motovun Jack.jpg]]"`
+* 所选的项目被设置为当前正在呈现的条目名称，以此评估文件名筛选器，允条目名称用作基础计算的文件名。例如，`[encodeuricomponent[]addprefix[static/]]` 为每个条目名称套用 URI 编码，然后增加首码 `static/`
+* `--render` 命令是已弃用的 `--rendertiddler` 和 `--rendertiddlers` 的一个更灵活的替代命令。
+
+例子：
+
+* `--render "[!is[system]]" "[encodeuricomponent[]addprefix[tiddlers/]addsuffix[.html]]"` -- 呈现所有非系统条目为 "tiddlers" 子文件夹中的文件，文件名为 URL 编码的条目名称和扩展名 HTML
--- a/languages/zh-Hans/Help/rendertiddler.tid
+++ b/languages/zh-Hans/Help/rendertiddler.tid
@ -1,5 +1,7 @@
 title: $:/language/Help/rendertiddler
-description: 呈现个别条目为指定的内容类型 
+description: 呈现个别条目为指定的内容类型
+
+(请注意：`--rendertiddler` 命令已被弃用，而支持新的、更灵活的 `--render` 命令)

 呈现个别条目为指定的[[内容类型|ContentType]]，默认为 `text/html` 且保存为指定的文件名。

--- a/languages/zh-Hans/Help/rendertiddlers.tid
+++ b/languages/zh-Hans/Help/rendertiddlers.tid
@ -1,6 +1,8 @@
 title: $:/language/Help/rendertiddlers
 description: 呈现符合筛选条件的条目为指定的内容类型

+(请注意：`--rendertiddlers` 命令已被弃用，而支持新的、更灵活的 `--render` 命令)
+
 呈现符合筛选条的条目为指定的[[内容类型|ContentType]] (默认为 `text/html`) 与扩展名 (默认为 `.html`).

 ```
--- a/languages/zh-Hans/Help/save.tid
+++ b/languages/zh-Hans/Help/save.tid
@ -0,0 +1,23 @@
+title: $:/language/Help/save
+description: 将个别原始条目保存到文件
+
+以其原始文本或二进位格式，保存到指定的文件。
+
+```
+--save <tiddler-filter> <filename-filter>
+```
+
+* ''tiddler-filter'': 标识要保存的条目的筛选器
+* ''filename-filter'': 可选的筛选器，转换条目名称至路径名。如果省略，默认为 `[is[tiddler]]`，其使用未改变的条目名称为文件名
+
+附注：
+
+* 输出文件夹不清除任何现有的文件
+* 文件名的路径中，任何不存在的文件夹，将自动创建。
+* 当正保存的条目的名称中带有空格，请注意同时使用命令行接口所要求的引号，与 TiddlyWiki 的双重方括号；`--save  "[[Motovun Jack.jpg]]"`
+* 所选的项目被设置为当前正在保存的条目名称，以此评估文件名筛选器，允条目名称用作基础计算的文件名。例如，`[encodeuricomponent[]addprefix[static/]]` 为每个条目名称套用 URI 编码，然后增加首码 `static/`
+* `--save` 命令是已被弃用的 `--savetiddler` 和 `--savetiddlers` 的一个更灵活的替代命令。
+
+例子：
+
+* `--save "[!is[system]is[image]]" "[encodeuricomponent[]addprefix[tiddlers/]]"` -- 保存所有非系统的图像条目为 "tiddlers" 子文件夹中的文件，文件名为 URL 编码的条目名称
--- a/languages/zh-Hans/Help/savetiddler.tid
+++ b/languages/zh-Hans/Help/savetiddler.tid
@ -1,6 +1,8 @@
 title: $:/language/Help/savetiddler
 description: 将条目的原始内容保存到一个文件

+(请注意：`--savetiddler` 命令已被弃用，而支持新的、更灵活的 `--save` 命令)
+
 保存个别条目的原始文本或二进制格式到指定的文件名。

 ```
--- a/languages/zh-Hans/Help/savetiddlers.tid
+++ b/languages/zh-Hans/Help/savetiddlers.tid
@ -1,6 +1,8 @@
 title: $:/language/Help/savetiddlers
 description: 将一群条目的原始内容保存到一个文件夹

+(请注意：`--savetiddlers` 命令已被弃用，而支持新的、更灵活的 `--save` 命令)
+
 保存一群条目的原始文字或二进制格式到指定的文件夹。

 ```
--- a/languages/zh-Hant/Help/render.tid
+++ b/languages/zh-Hant/Help/render.tid
@ -0,0 +1,33 @@
+title: $:/language/Help/render
+description: 呈現個別條目到檔案
+
+呈現個別條目，並將結果儲存到指定的檔案。
+
+可選擇性地指定範本條目名稱，在此情況下，"currentTiddler" 變數設為呈現中的條目名稱，用以呈現範本條目。
+
+也可以選擇性地指定附加變數的名稱和值。
+
+```
+--render <tiddler-filter> [<filename-filter>] [<render-type>] [<template>] [<name>] [<value>]
+```
+
+* ''tiddler-filter'': 標識要呈現的條目的篩選器
+* ''filename-filter'': 可選的篩選器，轉換條目名稱至路徑名。如果省略，預設為 `[is[tiddler]addsuffix[.html]]`，其使用未改變的條目名稱為檔名
+* ''template'': 可選的範本，用於呈現每個條目
+* ''render-type'': 可選的呈現類型：`text/html` (預設值) 會傳回完整的 HTML 文字，而 `text/plain` 只會傳回文字內容 (即其忽略 HTML 標記與其他不可印出的資料)
+* ''name'': 可選的變數名稱
+* ''value'': 可選的變數值
+
+預設情況下，檔名被解析為相對於發行版資料夾的 `output` 子資料夾。`--output` 命令可用於將輸出指到一個不同的資料夾。
+
+附註：
+
+* 輸出資料夾不清除任何現有的檔案
+* 檔名的路徑中，任何不存在的資料夾，將自動建立。
+* 當正呈現的條目名稱中帶有空格，請注意同時使用命令列介面所要求的引號，與 TiddlyWiki 的雙重方括號；`--render "[[Motovun Jack.jpg]]"`
+* 所選的項目被設定為當前正在呈現的條目名稱，以此評估檔名篩選器，允條目名稱用作基礎計算的檔名。例如，`[encodeuricomponent[]addprefix[static/]]` 為每個條目名稱套用 URI 編碼，然後增加首碼 `static/`
+* `--render` 命令是已棄用的 `--rendertiddler` 和 `--rendertiddlers` 的一個更靈活的替代命令。
+
+範例：
+
+* `--render "[!is[system]]" "[encodeuricomponent[]addprefix[tiddlers/]addsuffix[.html]]"` -- 呈現所有非系統條目為 "tiddlers" 子資料夾中的檔案，檔名為 URL 編碼的條目名稱和副檔名 HTML
--- a/languages/zh-Hant/Help/rendertiddler.tid
+++ b/languages/zh-Hant/Help/rendertiddler.tid
@ -1,6 +1,8 @@
 title: $:/language/Help/rendertiddler
 description: 呈現個別條目為指定的內容類型 

+(請注意：`--rendertiddler` 命令已被棄用，而支援新的、更靈活得 `--render` 命令)
+
 呈現個別條目為指定的[[內容類型|ContentType]]，預設為 `text/html` 且儲存為指定的檔名。

 還能可選地指定一個範本條目的名稱，在這種情況下，"currentTiddler" 變數設為正在呈現的條目 (第一個參數值) 與範本條目合併呈現。
@ -11,7 +13,7 @@ description: 呈現個別條目為指定的內容類型
 --rendertiddler <title> <filename> [<type>] [<template>] [<name>] [<value>]
 ```

-預設情況下，檔名被解析為相對於版本資料夾的 `output` 子資料夾。 `--output` 命令可以用於將輸出指定到一個不同的資料夾。
+預設情況下，檔名被解析為相對於發行版資料夾的 `output` 子資料夾。 `--output` 命令可以用於將輸出指定到一個不同的資料夾。

 自動建立在檔案名稱的路徑中任何缺少的資料夾。

--- a/languages/zh-Hant/Help/rendertiddlers.tid
+++ b/languages/zh-Hant/Help/rendertiddlers.tid
@ -1,6 +1,8 @@
 title: $:/language/Help/rendertiddlers
 description: 呈現符合篩選條件的條目為指定的內容類型

+(請注意：`--rendertiddlers` 命令已被棄用，而支援新的、更靈活得 `--render` 命令)
+
 呈現符合篩選條的條目為指定的[[內容類型|ContentType]] (預設為 `text/html`) 與副檔名 (預設為 `.html`).

 ```
@ -13,6 +15,6 @@ description: 呈現符合篩選條件的條目為指定的內容類型
 --rendertiddlers [!is[system]] $:/core/templates/static.tiddler.html ./static text/plain
 ```

-預設情況下，路徑名被解析為相對於版本資料夾的 `output` 子資料夾。 `--output` 命令可以用於將輸出指定到一個不同的資料夾。
+預設情況下，路徑名被解析為相對於發行版資料夾的 `output` 子資料夾。 `--output` 命令可以用於將輸出指定到一個不同的資料夾。

 在目標資料夾中的任何檔案都會被刪除，除非指定 ''noclean'' 旗標。若缺少目標資料夾，則以遞迴方式建立。
--- a/languages/zh-Hant/Help/save.tid
+++ b/languages/zh-Hant/Help/save.tid
@ -0,0 +1,23 @@
+title: $:/language/Help/save
+description: 將個別原始條目儲存到檔案
+
+以其原始文字或二進位格式，儲存到指定的檔案。
+
+```
+--save <tiddler-filter> <filename-filter>
+```
+
+* ''tiddler-filter'': 標識要儲存的條目的篩選器
+* ''filename-filter'': 可選的篩選器，轉換條目名稱至路徑名。如果省略，預設為 `[is[tiddler]]`，其使用未改變的條目名稱為檔名
+
+附註：
+
+* 輸出資料夾不清除任何現有的檔案
+* 檔名的路徑中，任何不存在的目錄，將自動建立。
+* 當正儲存的條目的名稱中帶有空格，請注意同時使用命令列介面所要求的引號，與 TiddlyWiki 的雙重方括號；`--save  "[[Motovun Jack.jpg]]"`
+* 所選的項目被設定為當前正在儲存的條目名稱，以此評估檔案名篩選器，允條目名稱用作基礎計算的檔名。例如，`[encodeuricomponent[]addprefix[static/]]` 為每個條目名稱套用 URI 編碼，然後增加首碼 `static/`
+* `--save` 命令是已被棄用的 `--savetiddler` 和 `--savetiddlers` 的一個更靈活的替代命令。
+
+範例：
+
+* `--save "[!is[system]is[image]]" "[encodeuricomponent[]addprefix[tiddlers/]]"` -- 儲存所有非系統的圖像條目為 "tiddlers" 子資料夾中的檔案，檔名為 URL 編碼的條目名稱
--- a/languages/zh-Hant/Help/savetiddler.tid
+++ b/languages/zh-Hant/Help/savetiddler.tid
@ -1,12 +1,14 @@
 title: $:/language/Help/savetiddler
 description: 將條目的原始內容儲存到一個檔案

+(請注意：`--savetiddler` 命令已被棄用，而支援新的、更靈活得 `--save` 命令)
+
 儲存個別條目的原始文字或二進位格式到指定的檔名。

 ```
 --savetiddler <title> <filename>
 ```

-預設情況下，檔名被解析為相對於版本資料夾的 `output` 子資料夾。 `--output` 命令可以用於將輸出指定到一個不同的資料夾。
+預設情況下，檔名被解析為相對於發行版資料夾的 `output` 子資料夾。 `--output` 命令可以用於將輸出指定到一個不同的資料夾。

 自動建立在檔案名稱的路徑中任何缺少的資料夾。
--- a/languages/zh-Hant/Help/savetiddlers.tid
+++ b/languages/zh-Hant/Help/savetiddlers.tid
@ -1,13 +1,15 @@
 title: $:/language/Help/savetiddlers
 description: 將一群條目的原始內容儲存到一個資料夾

+(請注意：`--savetiddlers` 命令已被棄用，而支援新的、更靈活得 `--save` 命令)
+
 儲存一群條目的原始文字或二進位格式到指定的資料夾。

 ```
 --savetiddlers <filter> <pathname> [noclean]
 ```

-預設情況下，路徑名被解析為相對於版本資料夾的 `output` 子資料夾。 `--output` 命令可以用於將輸出指定到一個不同的資料夾。
+預設情況下，路徑名被解析為相對於發行版資料夾的 `output` 子資料夾。 `--output` 命令可以用於將輸出指定到一個不同的資料夾。

 儲存指定的檔案之前，會先清除輸出目錄的現有檔案。可藉由指定 ''noclean'' 旗標，停用該刪除動作。