Refactor generate-template --output to use full path instead of file name only

- Change --output to accept full output path instead of extracting file name under config/<root_config_name>/
- Update CLI argument description and doc strings in src/cli.rs
- Remove '#' comment prefix from YAML template section/field/leaf keys
- Update unit tests for new output resolution and remove '#' prefix assertions
- Add test for resolve_config_template_output with provided path
- Sync all 11 locale manual/cli.md files and README.zh.md documentation

Author: developerworks

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rust-config-tree"
-version = "0.2.0"
+version = "0.2.1"
 edition = "2024"
 rust-version = "1.85"
 description = "Recursive include tree utilities for layered configuration files."

README.zh.md

@@ -348,13 +348,13 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 }
 ```
 
-`generate-template --output <file-name>`
-会在 `config/<root_config_name>/` 下写入模板，并使用指定的文件名。如果传入的是路径，只取它的文件名。未提供
-output file name(输出文件名) 时，写入
-`config/<root_config_name>/<root_config_name>.example.yaml`。添加
-`--schema <path>` 后，TOML、YAML、JSON 和 JSON5 模板会绑定生成的
-JSON Schema 集合。这也会把 root schema(根结构定义) 和
-section schema(配置段结构定义) 写入指定的 schema path(结构定义路径)。
+`generate-template --output <path>`
+会把模板写入指定的 output path(输出路径). 未提供
+`--output` 时, 写入
+`config/<root_config_name>/<root_config_name>.example.yaml`. 添加
+`--schema <path>` 后, TOML, YAML, JSON 和 JSON5 模板会绑定生成的
+JSON Schema(JSON 结构定义) 集合. 这也会把 root schema(根结构定义) 和
+section schema(配置段结构定义) 写入指定的 schema path(结构定义路径).
 
 `generate-schema --output <path>` 会写入 root(根配置) 的 Draft 7
 JSON Schema(JSON 结构定义) 和 section schema(配置段结构定义)。未提供

manual/de/cli.md

@@ -92,9 +92,8 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 demo generate-template
 ```
 
-Der Befehl schreibt Vorlagen unter `config/<root_config_name>/`. Wenn `--output`
-einen Pfad erhaelt, wird nur der Dateiname verwendet. Wenn kein
-Ausgabe-Dateiname angegeben wird, schreibt der Befehl
+Der Befehl schreibt Vorlagen in den von `--output` angegebenen Ausgabepfad.
+Wenn kein `--output` angegeben wird, schreibt der Befehl
 `config/<root_config_name>/<root_config_name>.example.yaml`. Fuege
 `--schema schemas/myapp.schema.json` hinzu, um erzeugte TOML-, YAML-, JSON- und
 JSON5-Vorlagen an erzeugte JSON-Schemas zu binden. Aufgeteilte YAML-Vorlagen

manual/en/cli.md

@@ -96,9 +96,8 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 demo generate-template
 ```
 
-The command writes templates under `config/<root_config_name>/`. If `--output`
-receives a path, only the file name is used. If no output file name is provided,
-the command writes
+The command writes templates to the output path specified by `--output`. If no
+`--output` is provided, the command writes
 `config/<root_config_name>/<root_config_name>.example.yaml`. Add
 `--schema schemas/myapp.schema.json` to bind generated TOML, YAML, JSON, and JSON5 templates
 to generated JSON Schemas. Split YAML templates bind the matching section

manual/es/cli.md

@@ -94,9 +94,8 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 demo generate-template
 ```
 
-El comando escribe plantillas bajo `config/<root_config_name>/`. Si `--output`
-recibe una ruta, solo se usa el nombre de archivo. Si no se proporciona un
-nombre de archivo de salida, el comando escribe
+El comando escribe plantillas en la ruta de salida indicada por `--output`. Si
+no se proporciona `--output`, el comando escribe
 `config/<root_config_name>/<root_config_name>.example.yaml`. Añade
 `--schema schemas/myapp.schema.json` para enlazar plantillas TOML, YAML, JSON y
 JSON5 generadas a JSON Schemas generados. Las plantillas YAML divididas enlazan

manual/fi/cli.md

@@ -84,7 +84,7 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 demo generate-template
 ```
 
-Komento kirjoittaa mallit hakemistoon `config/<root_config_name>/`. Jos `--output` saa polun, vain tiedostonimi kaytetaan. Jos tulostetiedoston nimea ei anneta, komento kirjoittaa `config/<root_config_name>/<root_config_name>.example.yaml`. Lisaa `--schema schemas/myapp.schema.json`, jotta luodut TOML-, YAML-, JSON- ja JSON5-mallit sidotaan luotuihin JSON Schema -skeemoihin. Jaetut YAML-mallit sitovat vastaavan osioskeeman. JSON- ja JSON5-mallit saavat `$schema`-kentan, jonka VS Code tunnistaa. Komento kirjoittaa myos juuri- ja osioskeemat valittuun skeemapolkuun.
+Komento kirjoittaa mallit `--output`-arvon osoittamaan tulostepolkuun. Jos `--output`-arvoa ei anneta, komento kirjoittaa `config/<root_config_name>/<root_config_name>.example.yaml`. Lisaa `--schema schemas/myapp.schema.json`, jotta luodut TOML-, YAML-, JSON- ja JSON5-mallit sidotaan luotuihin JSON Schema -skeemoihin. Jaetut YAML-mallit sitovat vastaavan osioskeeman. JSON- ja JSON5-mallit saavat `$schema`-kentan, jonka VS Code tunnistaa. Komento kirjoittaa myos juuri- ja osioskeemat valittuun skeemapolkuun.
 
 ```bash
 demo generate-template --output app_config.example.toml --schema schemas/myapp.schema.json

manual/fr/cli.md

@@ -93,9 +93,8 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 demo generate-template
 ```
 
-La commande ecrit les modeles sous `config/<root_config_name>/`. Si `--output`
-recoit un chemin, seul le nom de fichier est utilise. Si aucun nom de fichier de
-sortie n'est fourni, la commande ecrit
+La commande ecrit les modeles dans le chemin de sortie indique par `--output`.
+Si aucun `--output` n'est fourni, la commande ecrit
 `config/<root_config_name>/<root_config_name>.example.yaml`. Ajoutez
 `--schema schemas/myapp.schema.json` pour lier les modeles TOML, YAML, JSON et
 JSON5 generes aux schemas JSON generes. Les modeles YAML separes lient le

manual/ja/cli.md

@@ -90,9 +90,8 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 demo generate-template
 ```
 
-この command は `config/<root_config_name>/` の下に template を書きます。
-`--output` に path を渡した場合は file name だけを使います。output file name
-がない場合は
+この command は `--output` が指定した output path に template を書きます。
+`--output` がない場合は
 `config/<root_config_name>/<root_config_name>.example.yaml` を書きます。
 `--schema schemas/myapp.schema.json` を追加すると、generated TOML / YAML /
 JSON / JSON5 template を generated JSON Schema に bind します。split YAML

manual/ko/cli.md

@@ -88,8 +88,7 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 demo generate-template
 ```
 
-명령은 `config/<root_config_name>/` 아래에 템플릿을 씁니다. `--output`이 경로를
-받으면 파일 이름만 사용합니다. 출력 파일 이름을 제공하지 않으면
+명령은 `--output`이 지정한 출력 경로에 템플릿을 씁니다. `--output`을 제공하지 않으면
 `config/<root_config_name>/<root_config_name>.example.yaml`을 씁니다. 생성된
 TOML, YAML, JSON 및 JSON5 템플릿을 생성된 JSON Schema에 바인딩하려면
 `--schema schemas/myapp.schema.json`를 추가하세요. 분할 YAML 템플릿은 대응하는

manual/nl/cli.md

@@ -91,9 +91,8 @@ fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
 demo generate-template
 ```
 
-De opdracht schrijft sjablonen onder `config/<root_config_name>/`. Als
-`--output` een pad ontvangt, wordt alleen de bestandsnaam gebruikt. Als geen
-uitvoerbestandsnaam is opgegeven, schrijft de opdracht
+De opdracht schrijft sjablonen naar het uitvoerpad dat door `--output` is
+opgegeven. Als geen `--output` is opgegeven, schrijft de opdracht
 `config/<root_config_name>/<root_config_name>.example.yaml`. Voeg
 `--schema schemas/myapp.schema.json` toe om gegenereerde TOML-, YAML-, JSON- en
 JSON5-sjablonen te koppelen aan gegenereerde JSON Schemas. Gesplitste