From dba404606458657cbd1400bbb5c9e7e1930f6d9b Mon Sep 17 00:00:00 2001 From: DominikDoom <34448969+DominikDoom@users.noreply.github.com> Date: Mon, 7 Nov 2022 10:01:29 +0100 Subject: [PATCH] Update README_ZH.md I updated it using machine translation, so if you are a native Chinese speaker and notice any mistakes, please tell me. --- README_ZH.md | 110 ++++++++++++++++++++++++++++++--------------------- 1 file changed, 65 insertions(+), 45 deletions(-) diff --git a/README_ZH.md b/README_ZH.md index 6554a46..1283def 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -14,6 +14,42 @@ * 浏览器可能因为缓存无法更新脚本、设置、embedding/wildcard列表，尝试使用`CRTL+F5`清空浏览器缓存并重新加载 - 当`replaceUnderscores`选项开启时, 脚本只会替换Tag的一部分如果Tag包含多个单词,比如将`atago (azur lane)`修改`atago`为`taihou`并使用自动补全时.会得到 `taihou (azur lane), lane)`的结果, 因为脚本没有把后面的部分认为成同一个Tag。 +## 演示与截图 +演示视频(使用了键盘导航): + +https://user-images.githubusercontent.com/34448969/200128020-10d9a8b2-cea6-4e3f-bcd2-8c40c8c73233.mp4 + +Wildcard支持演示: + +https://user-images.githubusercontent.com/34448969/200128031-22dd7c33-71d1-464f-ae36-5f6c8fd49df0.mp4 + +深浅色主题支持,包括Tag的颜色: + +![results_dark](https://user-images.githubusercontent.com/34448969/200128214-3b6f21b4-9dda-4acf-820e-5df0285c30d6.png) +![results_light](https://user-images.githubusercontent.com/34448969/200128217-bfac8b60-6673-447b-90fd-dc6326f1618c.png) + +## 安装 +### 作为一种扩展（推荐） +要么把它克隆到你的扩展文件夹里 +```bash +git clone "https://github.com/DominikDoom/a1111-sd-webui-tagcomplete.git" extensions/tag-autocomplete +``` +(第二个参数指定文件夹的名称，你可以选择任何你喜欢的东西）。 + +或者手动创建一个文件夹，将 `javascript`、`scripts`和`tags`文件夹放在其中。 + +### 在根目录下（旧方法) +只需要将`javascript`，`scripts`和`tags`文件夹复制到你的Web UI安装根目录下.下次启动Web UI时它将自动启动。 + +--- +在这两种配置中，标签文件夹包含`config.json`和脚本用于自动完成的标签数据。 +默认情况下，Tag数据包括`Danbooru.csv`和`e621.csv`。 + +在扫描过`/embeddings`和wildcards后，会将列表存放在`tags/temp`文件夹下。删除该文件夹不会有任何影响，下次启动时它会重新创建。 + +### 注意: +本脚本的允许需要**全部的三个文件夹**。 + ## [Wildcard](https://github.com/jtkelm2/stable-diffusion-webui-1/blob/master/scripts/wildcards.py) & Embedding 支持 自动补全同样适用于 [Wildcard](https://github.com/jtkelm2/stable-diffusion-webui-1/blob/master/scripts/wildcards.py)中所述的通配符文件(后面有演示视频)。这将使你能够插入Wildcard脚本需要的通配符，更进一步的，你还可以插入通配符文件内的某个具体Tag。 @@ -23,29 +59,6 @@ 现在这项功能默认是启用的，并会自动扫描`/embeddings`和`/scripts/wildcards`文件夹，不再需要使用`tags/wildcardNames.txt`文件了，早期版本的用户可以将它删除。 -## 演示与截图 -演示视频(使用了键盘导航): - -https://user-images.githubusercontent.com/34448969/195344430-2b5f9945-b98b-4943-9fbc-82cf633321b1.mp4 - -Wildcard支持演示: - -https://user-images.githubusercontent.com/34448969/195632461-49d226ae-d393-453d-8f04-1e44b073234c.mp4 - -深浅色主题支持,包括Tag的颜色: - -![tagtypes](https://user-images.githubusercontent.com/34448969/195177127-f63949f8-271d-4767-bccd-f1b5e818a7f8.png) -![tagtypes_light](https://user-images.githubusercontent.com/34448969/195180061-ceebcc25-9e4c-424f-b0c9-ba8e8f4f17f4.png) - -## 安装 -只需要将`javascript`，`scripts`和`tags`文件夹复制到你的Web UI安装根目录下.下次启动Web UI时它将自动启动。 - -`tags`文件夹下包含`config.json`（用于设置）和Tag数据（.csv格式）。默认情况下，Tag数据包括`Danbooru.csv`和`e621.csv`。 - -在扫描过`/embeddings`和`/scripts/wildcards`后，会将列表存放在`tags/temp`文件夹下。删除该文件夹不会有任何影响，下次启动时它会重新创建。 -### 注意: -本脚本的允许需要**全部的三个文件夹**。 - ## 配置文件 配置文件（config.json）的默认值如下： ```json @@ -106,41 +119,48 @@ https://user-images.githubusercontent.com/34448969/195632461-49d226ae-d393-453d- | extras | 附加标签文件/翻译的选项。更多信息在下面的部分。| | colors | 包含标签类型的可自定义颜色，您可以在此处为自定义标签文件添加新颜色（与文件名相同，不带 .csv）。第一个值是暗模式，第二个值是亮模式。颜色名称和十六进制代码都应该有效。| -## 翻译&新增Tag -通过最近的更新，现在可以为标签添加翻译。这些将根据 `config.json` 中的设置可搜索/显示： -- `searchByTranslation` - 是同时搜索翻译词还是仅搜索英文标签。 -- `onlyShowTranslation` - 如果有英文标签，则用其翻译替换它。仅用于显示，最后插入的文本仍然是英文标签。 +### 别名，翻译&新增Tag +#### 别名 +像Booru网站一样，标签可以有一个或多个别名，完成后重定向到实际值。这些将根据`config.json`中的设置进行搜索/显示。 +- `searchByAlias` - 是否也要搜索别名，或只搜索实际的标签。 +- `onlyShowAlias` - 只显示别名，不显示 `别名->实际`。仅用于显示，最后的文本仍然是实际的标签。 + +#### 翻译 +可以在翻译部分添加一个额外的文件，它将被用来翻译标签和别名，同时也可以通过翻译进行搜索。 +这个文件需要是CSV格式的`<英语标签/别名>,<翻译>`，但为了向后兼容使用三栏格式的旧的额外文件，你可以打开`oldFormat`来代替它。 完整和部分中文标签集的示例： -![translation](https://user-images.githubusercontent.com/34448969/196175839-8aaacb26-5c90-48e3-be65-647a0b444ead.png) -![translation_mixed](https://user-images.githubusercontent.com/34448969/196176233-76d4cb5f-16cf-4800-a69b-adb64a79ca8b.png) +![IME-input](https://user-images.githubusercontent.com/34448969/200126551-2264e9cc-abb2-4450-9afa-43f362a77ab0.png) +![english-input](https://user-images.githubusercontent.com/34448969/200126513-bf6b3940-6e22-41b0-a369-f2b4640f87d6.png) -可以通过多种方式添加翻译，这就是额外文件发挥作用的地方。 -1. 直接在主标签文件中。只需添加第三个值，用逗号分隔，包含该行中标签的翻译。 -2. 作为仅包含已翻译标签行的额外文件（因此仍包括英文标签名称和标签类型）。将根据名称和类型与主文件中的英文标签匹配，因此对于大型翻译文件可能会很慢。 -3. 作为 `onlyTranslationExtraFile` 为 true 的额外文件。使用此配置，额外文件必须包含*仅*翻译本身。这意味着它完全基于索引，将翻译分配给主要标签非常快，但也需要匹配行（包括空行）。如果主文件中的顺序或数量发生变化，则翻译可能不再匹配。 +**重要的是** +从最近的更新来看，用旧的Extra文件方式添加的翻译只能作为一个别名使用，如果输入该翻译的英文标签，将不再可见。 + +可以通过多种方式添加别名，这就是额外文件发挥作用的地方。 +1. 作为仅包含已翻译标签行的额外文件（因此仍包括英文标签名称和标签类型）。将根据名称和类型与主文件中的英文标签匹配，因此对于大型翻译文件可能会很慢。 +2. 作为 `onlyAliasExtraFile` 为 true 的额外文件。使用此配置，额外文件必须包含*仅*翻译本身。这意味着它完全基于索引，将翻译分配给主要标签非常快，但也需要匹配行（包括空行）。如果主文件中的顺序或数量发生变化，则翻译可能不再匹配。 因此，对于每种方法，您的 CSV 值将如下所示： -| | 1 | 2 | 3 | -|------------|---------------------|--------------------|---------------| -| Main file | `tag,0,translation` | `tag,0` | `tag,0` | -| Extra file | - | `tag,0,translation`| `translation` | +| | 1 | 2 | +|------------|--------------------------|--------------------------| +| Main file | `tag,type,count,(alias)` | `tag,type,count,(alias)` | +| Extra file | `tag,type,(count),alias` | `alias` | -方法 1 和 2 也可以混合使用，在这种情况下，如果它们翻译相同的标签，额外文件中的翻译将优先于主文件中的翻译。 -如果 `onlyTranslationExtraFile` 为 false，额外文件也可用于添加未包含在主集中的新/自定义标签。 +额外文件中的计数是可选的，因为自定义标签集并不总是有帖子计数。 如果额外的标签与任何现有标签都不匹配，它将作为新标签添加到列表中。 ### CSV tag data 本脚本的Tag文件格式如下，你可以安装这个格式制作自己的Tag文件: ```csv -1girl,0 -solo,0 -highres,5 -long_hair,0 +1girl,0,4114588,"1girls,sole_female" +solo,0,3426446,"female_solo,solo_female" +highres,5,3008413,"high_res,high_resolution,hires" +long_hair,0,2898315,longhair +commentary_request,5,2610959, ``` -值得注意的是，它不希望第一行中有列名。 -第一个值需要是标签名称，而第二个值指定标签类型。 +值得注意的是，不希望在第一行有列名，而且count和aliases在技术上都是可选的。 +尽管count总是包含在默认数据中。多个别名也需要用逗号分隔，但要用字符串引号包裹，以免破坏CSV解析。 编号系统遵循 Danbooru 的 [tag API docs](https://danbooru.donmai.us/wiki_pages/api%3Atags): | Value | Description | |-------|-------------|