Releases: Release 3.4.0

BLKSerene · BLKSerene · commit aa720637617a · 2023-09-30T19:20:53.000+08:00
diff --git a/README.md b/README.md
@@ -69,27 +69,38 @@ Wordless is an integrated corpus tool with multilingual support for the study of
 
 ## Download
 
-The latest version (**3.3.0**) of Wordless supports **Windows 7/8/8.1/10/11**, **macOS 10.11 or later**, and **Ubuntu 18.04 or later**, all **64-bit only**. Both Intel-based and Apple Silicon-based Macs are supported.
+The latest version (**3.4.0**) of Wordless supports **Windows 7/8/8.1/10/11**, **macOS 10.11 or later**, and **Ubuntu 18.04 or later**, all **64-bit only**. Both Intel-based and Apple Silicon-based Macs are supported.
 
 For a detailed changelog, please see [CHANGELOG.md](/CHANGELOG.md).
 
 Release|Remarks
 -------|-------
-[Latest Release for Windows](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_windows.zip)|1. Extract all files<br>2. Double-click **Wordless/Wordless.exe** to run
-[Latest Release for macOS](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_macos.zip)|1. Extract all files<br>2. Double-click **Wordless.app** to run
-[Latest Release for Linux](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_linux.tar.gz)|1. Extract all files<br>2. Double-click **Wordless/Wordless** to run<br>3. [Optional] Double-click **Wordless/Wordless - Create Shortucut** to create a shortcut in **Show Applications**
+[Latest Release for Windows](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_windows.zip)|1. Extract all files<br>2. Double-click **Wordless/Wordless.exe** to run
+[Latest Release for macOS](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_macos.zip)|1. Extract all files<br>2. Double-click **Wordless.app** to run
+[Latest Release for Linux](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_linux.tar.gz)|1. Extract all files<br>2. Double-click **Wordless/Wordless** to run<br>3. [Optional] Double-click **Wordless/Wordless - Create Shortucut** to create a shortcut in **Show Applications**
 [Past Releases](https://github.com/BLKSerene/Wordless/releases)|Not recommended
-[Baidu Netdisk](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2FWordless%203.3.0)|For Chinese users with unstable connections to Github (**PASSWORD: wdls**)
-
-**Note 1:** It is recommended that the path to Wordless **not contain any non-ASCII chatacters, such as Chinese characters and letters with diacritics**.<br>
-
-**Note 2:** If your Mac says that **“Wordless” is damaged and can’t be opened**, please open **Terminal** (Launchpad → Other) and run:<br>
-
-    xattr -rc /Applications/Wordless.app
-
-remember to replace **/Applications/Wordless.app** with the actual path of Wordless on your computer (you could drag **Wordless.app** to the **Terminal**). Then, **run Wordless again** (the warning prompted in Terminal could be ignored if the program could be successfully opened).<br>
-
-**Note 3:** If the Linux version won't open after double-clicking, please try **executing the program with the sudo command in terminal**. If the program is still not running, please **contact the author for support**.
+[Baidu Netdisk](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2FWordless%203.4.0)|For Chinese users with unstable connections to Github (**PASSWORD: wdls**)
+
+> [!IMPORTANT]
+> **Note 1:** It is recommended that the path to Wordless **not contain any non-ASCII chatacters, such as Chinese characters and letters with diacritics**.
+> 
+> **Note 2:** If your Mac says that **“Wordless” is damaged and can’t be opened**, please open **Terminal** (Launchpad → Other) and run:
+> 
+> <code>xattr -rc /Applications/Wordless.app</code><br>
+> 
+> remember to replace **/Applications/Wordless.app** with the actual path of Wordless on your computer (you could drag **Wordless.app** to the **Terminal**). Then, **run Wordless again** (the warning prompted in Terminal could be ignored if the program could be successfully opened).
+> 
+> **Note 3:** While opening corpora in languages other than English in *Wordless*, extra model files might need to be downloaded from the internet. If you encounter a **Network Error** dialog while downloading the model, chances are that it's a literal network error, so you just need to check your internet connections following the instructions in the error message and try downloading the model once more.
+> 
+> Users in China, where connections to Github and Hugging Face Hub are unstable, are recommended to use a proxy and set properly the settings in **Menu - Preferences - Settings - General - Proxy Settings**. Alternatively, Chinese users can choose to manually download model files from [Baidu Netdisk](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2Fmodels&parentPath=%2F). The steps of installing models are as follows:
+> 
+> 1. Check the error message displayed in the **Network Error** dialog. If **stanza** is found in the error message, you need a *Stanza* model, otherwise you need a *spaCy* model.
+> 2. Download model files for the language of your corpus from the above link and **extract all files**.
+> 3. For Windows and Linux users, put *spaCy* models under **Wordless/libs** and *Stanza* models under **Wordless/libs/stanza_resources**. For macOS users, right click on **Wordless.app**, select **Show Package Contents**, then put *spaCy* models under **Contents/Frameworks** and *Stanza* models under **Contents/Frameworks/stanza_resources**.
+> 4. If your corpora are in different languages or both *spaCy* and *Stanza* models are required, repeat step 1 ~ 3 until the **Network Error** dialog disappears.
+> 5. Try opening corpora in *Wordless* again, the model downloading process should be skipped now.
+> 
+> If the problem persists or the model you need is missing from the above link, please contact the author for further support.
 
 ## Need Help?
 
@@ -110,11 +121,11 @@ If you are going to publish a work that uses Wordless, please cite as follows.
 
 APA (7th edition):
 
-<pre><code>Ye, L. (2023). <i>Wordless</i> (Version 3.3.0) [Computer software]. Github. https://github.com/BLKSerene/Wordless</code></pre>
+<pre><code>Ye, L. (2023). <i>Wordless</i> (Version 3.4.0) [Computer software]. Github. https://github.com/BLKSerene/Wordless</code></pre>
 
 MLA (8th edition):
 
-<pre><code>Ye Lei. <i>Wordless</i>, version 3.3.0, 2023. <i>Github</i>, https://github.com/BLKSerene/Wordless.</code></pre>
+<pre><code>Ye Lei. <i>Wordless</i>, version 3.4.0, 2023. <i>Github</i>, https://github.com/BLKSerene/Wordless.</code></pre>
 
 ## License
 
diff --git a/README_zho_cn.md b/README_zho_cn.md
@@ -69,27 +69,38 @@ Wordless 是一款拥有多语种支持的语料库集成工具，其可用于
 
 ## 下载
 
-Wordless 最新版（**3.3.0**）支持 **Windows 7/8/8.1/10/11**、**macOS 10.11 或更高版本**及 **Ubuntu 18.04 或更高版本**，**均仅支持**64位操作系统**。英特尔和 Apple 芯片的苹果电脑均有支持。
+Wordless 最新版（**3.4.0**）支持 **Windows 7/8/8.1/10/11**、**macOS 10.11 或更高版本**及 **Ubuntu 18.04 或更高版本**，**均仅支持**64位操作系统**。英特尔和 Apple 芯片的苹果电脑均有支持。
 
 如需完整的更新日志，请参阅 [CHANGELOG.md](/CHANGELOG.md)（待翻译）。
 
 版本|备注
 ----|---
-[Windows 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_windows.zip)|1. 解压缩所有文件<br>2. 双击运行 **Wordless/Wordless.exe**
-[macOS 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_macos.zip)|1. 解压缩所有文件<br>2. 双击运行 **Wordless.app**
-[Linux 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_linux.tar.gz)|1. 解压缩所有文件<br>2. 双击运行 **Wordless/Wordless**<br>3. [可选] 双击 **Wordless/Wordless - Create Shortucut** 在**显示应用程序**中创建一个快捷方式
+[Windows 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_windows.zip)|1. 解压缩所有文件<br>2. 双击运行 **Wordless/Wordless.exe**
+[macOS 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_macos.zip)|1. 解压缩所有文件<br>2. 双击运行 **Wordless.app**
+[Linux 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_linux.tar.gz)|1. 解压缩所有文件<br>2. 双击运行 **Wordless/Wordless**<br>3. [可选] 双击 **Wordless/Wordless - Create Shortucut** 在**显示应用程序**中创建一个快捷方式
 [历史版本](https://github.com/BLKSerene/Wordless/releases)|不推荐
-[百度网盘](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2FWordless%203.3.0)|中国用户若 Github 连接不稳定可尝试该下载链接（**提取码：wdls**）
-
-**备注 1**：Wordless 的路径中**不建议包含任何非 ASCII 字符，如汉字和带变音记号的字母等**。
-
-**备注 2**：苹果电脑用户如遇提示 **“Wordless”已损坏，无法打开**，请打开**终端**（启动台 → 其他）后运行：
-
-    xattr -rc /Applications/Wordless.app
-
-请注意将 **/Applications/Wordless.app** 替换为 Wordless 在电脑上的实际存放路径（可直接拖拽 **Wordless.app** 文件至**终端**中）。然后，**再次运行 Wordless**（若程序可成功运行，终端中提示的警告可忽略）。
-
-**备注 3**：如果 Linux 版本双击后无法运行，请尝试**在终端中使用 sudo 命令执行程序**。如果程序仍然无法运行，请**联系作者寻求帮助**。
+[百度网盘](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2FWordless%203.4.0)|中国用户若 Github 连接不稳定可尝试该下载链接（**提取码：wdls**）
+
+> [!IMPORTANT]
+> **备注 1**：Wordless 的路径中**不建议包含任何非 ASCII 字符，如汉字和带变音记号的字母等**。
+> 
+> **备注 2**：苹果电脑用户如遇提示 **“Wordless”已损坏，无法打开**，请打开**终端**（启动台 → 其他）后运行：
+> 
+> <code>xattr -rc /Applications/Wordless.app</code><br>
+> 
+> 请注意将 **/Applications/Wordless.app** 替换为 Wordless 在电脑上的实际存放路径（可直接拖拽 **Wordless.app** 文件至**终端**中）。然后，**再次运行 Wordless**（若程序可成功运行，终端中提示的警告可忽略）。
+> 
+> **备注 3:** 在 *Wordless* 中打开除英语外语种的语料库时，可能需要从网上下载额外的模型文件。如果出现**网络错误**对话框，那么大概率是字面意义上的网络错误，所以只需要按照错误信息中的指示检查网络连接，然后再次尝试下载模型即可。
+> 
+> 中国国内和 Github 以及 Hugging Face Hub 的连接不稳定，因此建议用户使用代理并在**菜单 - 偏好 - 设置 - 全局 - 代理设置**中进行设置。或者也可以手动从[百度网盘](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2Fmodels&parentPath=%2F)下载模型文件。模型的安装步骤如下：
+> 
+> 1. 查看**网络错误**对话框中的错误信息。如果错误信息中能找到 **stanza** 的字样，那么你需要的是 *Stanza* 模型，否则你需要的是 *spaCy* 模型。
+> 2. 从上方链接中下载你的语料库语种所对应的模型文件然后**将所有文件解压出来**。
+> 3. Windows 以及 Linux 用户需将 *spaCy* 模型置于 **Wordless/libs** 目录下，将 *Stanza* 模型置于 **Wordless/libs/stanza_resources** 目录下。 苹果系统用户需右键单击 **Wordless.app** 图标，选择 **显示套件内容（Show Package Contents）**，然后将 *spaCy* 模型置于 **Contents/Frameworks** 目录下，将 *Stanza* 模型置于 **Contents/Frameworks/stanza_resources**目录下。
+> 4. 如果你的语料库有多个语种或者 *spaCy* 和 *Stanza* 模型都需要，那么重复步骤 1 ~ 3 直至**网络错误**的对话框不再出现为止。
+> 5. 再次尝试在 *Wordless* 中打开你的语料库，此时应该会跳过模型下载过程。
+> 
+> 如果问题仍然存在或者上述链接中没有你需要的模型，请联系作者以寻求更多帮助。
 
 ## 需要帮助？
 
@@ -110,11 +121,11 @@ Bug 提交|[Github Issues](https://github.com/BLKSerene/Wordless/issues)
 
 APA（第7版）：
 
-<pre><code>Ye, L. (2023). <i>Wordless</i> (Version 3.3.0) [Computer software]. Github. https://github.com/BLKSerene/Wordless</code></pre>
+<pre><code>Ye, L. (2023). <i>Wordless</i> (Version 3.4.0) [Computer software]. Github. https://github.com/BLKSerene/Wordless</code></pre>
 
 MLA（第8版）：
 
-<pre><code>Ye Lei. <i>Wordless</i>, version 3.3.0, 2023. <i>Github</i>, https://github.com/BLKSerene/Wordless.</code></pre>
+<pre><code>Ye Lei. <i>Wordless</i>, version 3.4.0, 2023. <i>Github</i>, https://github.com/BLKSerene/Wordless.</code></pre>
 
 ## 许可
 
diff --git a/README_zho_tw.md b/README_zho_tw.md
@@ -69,27 +69,37 @@ Wordless 是一款擁有多語種支援的語料庫整合工具，其可用於
 
 ## 下載
 
-Wordless 最新版（**3.3.0**）支援 **Windows 7/8/8.1/10/11**、**macOS 10.11 或更高版本**及 **Ubuntu 18.04 或更高版本**，均僅支援**64位作業系統**。英特爾和 Apple 晶片的蘋果電腦均有支援。
+Wordless 最新版（**3.4.0**）支援 **Windows 7/8/8.1/10/11**、**macOS 10.11 或更高版本**及 **Ubuntu 18.04 或更高版本**，均僅支援**64位作業系統**。英特爾和 Apple 晶片的蘋果電腦均有支援。
 
 如需完整的更新日誌，請參閱 [CHANGELOG.md](/CHANGELOG.md)（待翻譯）。
 
 版本|備註
 ----|---
-[Windows 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_windows.zip)|1. 解壓縮所有檔案<br>2. 雙擊執行 **Wordless/Wordless.exe**
-[macOS 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_macos.zip)|1. 解壓縮所有檔案<br>2. 雙擊執行 **Wordless.app**
-[Linux 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.3.0/wordless_3.3.0_linux.tar.gz)|1. 解壓縮所有檔案<br>2. 雙擊執行**Wordless/Wordless**<br>3. [可選] 雙擊 **Wordless/Wordless - Create Shortucut** 在**顯示應用程式**中建立一個快捷方式
+[Windows 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_windows.zip)|1. 解壓縮所有檔案<br>2. 雙擊執行 **Wordless/Wordless.exe**
+[macOS 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_macos.zip)|1. 解壓縮所有檔案<br>2. 雙擊執行 **Wordless.app**
+[Linux 最新版](https://github.com/BLKSerene/Wordless/releases/download/3.4.0/wordless_3.4.0_linux.tar.gz)|1. 解壓縮所有檔案<br>2. 雙擊執行**Wordless/Wordless**<br>3. [可選] 雙擊 **Wordless/Wordless - Create Shortucut** 在**顯示應用程式**中建立一個快捷方式
 [歷史版本](https://github.com/BLKSerene/Wordless/releases)|不推薦
-[百度網盤](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2FWordless%203.3.0)|中國使用者若 Github 連線不穩定可嘗試該下載連結（**提取碼：wdls**）
-
-**備註 1**：Wordless 的路徑中**不建議包含任何非 ASCII 字元，如漢字和帶變音記號的字母等**。
-
-**備註 2**：macOS 系統使用者如遇提示 **“Wordless”已損壞，無法開啟**，請開啟**終端**（啟動臺 → 其他）後執行：
-
-    xattr -rc /Applications/Wordless.app
-
-請注意將 **/Applications/Wordless.app** 替換為 Wordless 在電腦上的實際存放路徑（可直接拖拽 **Wordless.app** 檔案至**終端**中）。然後，**再次執行 Wordless**（若程式可成功執行，終端中提示的警告可忽略）。
-
-**備註 3**：如果 Linux 版本雙擊後無法執行，請嘗試**在終端中使用 sudo 命令執行程式**。如果程式仍然無法執行，請**聯絡作者尋求幫助**。
+[百度網盤](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2FWordless%203.4.0)|中國大陸使用者若 Github 連線不穩定可嘗試該下載連結（**提取碼：wdls**）
+
+> [!IMPORTANT]
+> **備註 1**：Wordless 的路徑中**不建議包含任何非 ASCII 字元，如漢字和帶變音記號的字母等**。
+> 
+> **備註 2**：macOS 系統使用者如遇提示 **“Wordless”已損壞，無法開啟**，請開啟**終端**（啟動臺 → 其他）後執行：
+> 
+> <code>xattr -rc /Applications/Wordless.app</code><br>
+> 請注意將 **/Applications/Wordless.app** 替換為 Wordless 在電腦上的實際存放路徑（可直接拖拽 **Wordless.app** 檔案至**終端**中）。然後，**再次執行 Wordless**（若程式可成功執行，終端中提示的警告可忽略）。
+> 
+> **備註 3:** 在 *Wordless* 中開啟除英語外語種的語料庫時，可能需要從網上下載額外的模型檔案。如果出現**網路錯誤**對話方塊，那麼大機率是字面意義上的網路錯誤，所以只需要按照錯誤資訊中的指示檢查網路連線，然後再次嘗試下載模型即可。
+> 
+> 中國大陸和 Github 以及 Hugging Face Hub 的連線不穩定，因此建議使用者建議使用代理並在**選單 - 偏好 - 設定 - 全域性 - 代理設定**中進行設定。或者也可以手動從[百度網盤](https://pan.baidu.com/s/1--ZzABrDQBZlZagWlVQMbg?pwd=wdls#list/path=%2FWordless%2Fmodels&parentPath=%2F)下載模型檔案。模型的安裝步驟如下：
+> 
+> 1. 檢視**網路錯誤**對話方塊中的錯誤資訊。如果錯誤資訊中能找到 **stanza** 的字樣，那麼你需要的是 *Stanza* 模型，否則你需要的是 *spaCy* 模型。
+> 2. 從上方連結中下載你的語料庫語種所對應的模型檔案然後**將所有檔案解壓出來**。
+> 3. Windows 以及 Linux 使用者需將 *spaCy* 模型置於 **Wordless/libs** 目錄下，將 *Stanza* 模型置於 **Wordless/libs/stanza_resources** 目錄下。 蘋果系統使用者需右鍵單擊 **Wordless.app** 圖示，選擇 **顯示套件內容（Show Package Contents）**，然後將 *spaCy* 模型置於 **Contents/Frameworks** 目錄下，將 *Stanza* 模型置於 **Contents/Frameworks/stanza_resources**目錄下。
+> 4. 如果你的語料庫有多個語種或者 *spaCy* 和 *Stanza* 模型都需要，那麼重複步驟 1 ~ 3 直至**網路錯誤**的對話方塊不再出現為止。
+> 5. 再次嘗試在 *Wordless* 中開啟你的語料庫，此時應該會跳過模型下載過程。
+> 
+> 如果問題仍然存在或者上述連結中沒有你需要的模型，請聯絡作者以尋求更多幫助。
 
 ## 需要幫助？
 
@@ -110,11 +120,11 @@ Bug 提交|[Github Issues](https://github.com/BLKSerene/Wordless/issues)
 
 APA（第7版）：
 
-<pre><code>Ye, L. (2023). <i>Wordless</i> (Version 3.3.0) [Computer software]. Github. https://github.com/BLKSerene/Wordless</code></pre>
+<pre><code>Ye, L. (2023). <i>Wordless</i> (Version 3.4.0) [Computer software]. Github. https://github.com/BLKSerene/Wordless</code></pre>
 
 MLA（第8版）：
 
-<pre><code>Ye Lei. <i>Wordless</i>, version 3.3.0, 2023. <i>Github</i>, https://github.com/BLKSerene/Wordless.</code></pre>
+<pre><code>Ye Lei. <i>Wordless</i>, version 3.4.0, 2023. <i>Github</i>, https://github.com/BLKSerene/Wordless.</code></pre>
 
 ## 許可
 
diff --git a/VERSION b/VERSION
@@ -16,4 +16,4 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # ----------------------------------------------------------------------
 
-3.3.0
+3.4.0
