Add MX05, MX06 as supported, minor fix;

better Chinese conversion infrastructure
NaitLee · Feb 12, 2023 · 423a9ca · 423a9ca
1 parent 5b28396
commit 423a9ca
Show file tree

Hide file tree

Showing 32 changed files with 951 additions and 33 deletions.
diff --git a/0-prepare.sh b/0-prepare.sh
@@ -1,8 +1,8 @@
 #!/bin/sh
-cd www/lang/
-echo "opencc zh-CN to zh-TW..."
-./0-opencc.sh
-cd ..
+cd zh-conv
+echo "Convert Chinese Language with OpenCC"
+./0-convert.sh
+cd ../www
 echo "tsc bundle scripts..."
 ./0-transpile.sh
 cd ..
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-English | [Deutsch](./readme.i18n/README.de_DE.md) | [简体中文](./readme.i18n/README.zh_CN.md)
+English | [Deutsch](./readme.i18n/README.de_DE.md) | [中文（简体字）](./readme.i18n/README.zh_CN.md) | [中文（正體字）](./readme.i18n/README.zh_TW.md) | [中文（香港字）](./readme.i18n/README.zh_HK.md)
 
 # Cat-Printer
 

diff --git a/TODO b/TODO
@@ -16,13 +16,14 @@ Note: not ordered. do whatever I/you want
 + Service for other init systems (a systemd unit file is there)
 + ...
 
-? Optimize PF2 text printing? It seems a bit slow (in algorithm).
-? Use Go as part of backend? It can boost things up, and build some (essential) image manipulation in, quicker. And strip some way-too-big Python libs away (for smaller Windows/Android dist).
+? Optimize PF2 text printing? It seems a bit slow (in bit processing).
+? Use something else as server part of backend? This can boost things up, and build some (essential) image manipulation in, quicker. And strip some way-too-big Python libs away (for smaller Windows/Android dist).
 ? Built-in PostScript (Even if very basic)
-? Data compression for GB03. Optional
+? Data compression for GB03 alike. Optional
 ? Plugin, for including community features (that involves usefulness but also bloatness)
   It's usually messy. Try forking in your own way, at the moment.
 ? Process picture with WebAssembly? (Web frontend only)
+  Tried, Not as efficient as pure JavaScript
 ? Put Android APP on F-Droid? But it needs automatic build system...
   Android guys can help this!
 ? ... Or put to APKPure? But make frontend well before doing all of these
diff --git a/printer_lib/models.py b/printer_lib/models.py
@@ -1,8 +1,14 @@
-'Printer model specifications. License CC0-1.0-only'
+'''
+Printer model specifications.
+
+No rights reserved.
+License CC0-1.0-only: https://directory.fsf.org/wiki/License:CC0
+'''
 
 class Model():
     ''' A printer model
-        Note: these currently make no obvious sense
+        `paper_width`: pixels per line for the model/paper
+        `is_new`: some models can use compressed data. the algorithm isn't implemented in Cat-Printer yet, but should be no harm.
     '''
     paper_width: int
     is_new_kind: bool
@@ -12,6 +18,8 @@ def __init__(self, width, is_new):
 
 Models = {
     'YT01': Model(384, False),
+    'MX05': Model(384, False),
+    'MX06': Model(384, False),
     'GB01': Model(384, False),
     'GB02': Model(384, False),
     'GB03': Model(384, True),

diff --git a/printer_lib/pf2.py b/printer_lib/pf2.py
@@ -1,5 +1,5 @@
 '''
-Python lib for reading PF2 font files: http://grub.gibibit.com/New_font_format
+Python snippet for reading PF2 font files: http://grub.gibibit.com/New_font_format
 
 No rights reserved.
 License CC0-1.0-only: https://directory.fsf.org/wiki/License:CC0

diff --git a/readme.i18n/README.de_DE.md → readme.i18n/README.de-DE.md b/readme.i18n/README.de_DE.md → readme.i18n/README.de-DE.md
diff --git a/readme.i18n/README.zh_CN.md → readme.i18n/README.zh-CN.md b/readme.i18n/README.zh_CN.md → readme.i18n/README.zh-CN.md
@@ -14,6 +14,8 @@
 
 ## 特性
 
+[跳到安装向导](#现在开始)
+
 *当前仍在继续开发。以后会有更多！*
 
 - 简易！
@@ -133,9 +135,8 @@ Copyright © 2021-2022 NaitLee Soft. 保留一些权利。
 您可能对翻译工作感兴趣。可于目录 `www/lang` 和 `readme.i18n/` 中查看翻译文件！
 
 注：
-1. 通常英语与简体中文同时更新。请考虑其他，如繁体中文（需注意在繁体中与简体的用字、技术术语差别）。
-2. 目前使用 [OpenCC](https://github.com/BYVoid/OpenCC) 转换简体到繁体（臺灣正體）。若有不当之处，请指出。  
-  当前仅转换程序界面语言、暂不转换文档。
+1. 通常英语与中文同时更新。请考虑其他。
+2. 目前使用 [OpenCC](https://github.com/BYVoid/OpenCC) 从传统字转换到简体、正体、香港字。若有不当之处，请指出。  
 3. 如果（真的）有能力，您也可以纠正/改善某些翻译！
 
 还想写代码？看看 [development.md](development.md)！（英文）

diff --git a/readme.i18n/README.zh-HK.md b/readme.i18n/README.zh-HK.md
@@ -0,0 +1,159 @@
+
+# Cat-Printer
+
+🐱🖨 貓咪打印機：此應用*跨平台地*對一些藍牙“喵喵機”提供支持！
+
+[![cat-printer-poster](https://repository-images.githubusercontent.com/403563361/93e32942-856c-4552-a8b0-b03c0976a3a7)](https://repository-images.githubusercontent.com/403563361/93e32942-856c-4552-a8b0-b03c0976a3a7)
+
+## 型號
+
+已知支持：`GB0X, GT01, YT01` （`X` 表示任意數字）
+
+可在 Web 界面測試未列出的型號。在 `設置 -> 測試未知設備`  
+有概率成功！
+
+## 特性
+
+[跳到安裝嚮導](#現在開始)
+
+*當前仍在繼續開發。以後會有更多！*
+
+- 簡易！
+  - 在網頁界面進行操作，
+  - 或者獲取安卓應用！
+
+- 友好！
+  - 語言支持！您可參與翻譯！
+  - 良好的用户界面，可適應桌面/移動端/明暗主題！
+  - 無障礙功能，考慮到每一個人！
+
+- 功能豐富！
+  - 網頁界面，所有人都可以用！
+    - 控制打印機配置
+    - 打印照片，或單純地進行測試
+  - 命令行，技術愛好者必備！
+    - 使用一些參數控制打印機
+    - 簡易、簡化的圖片或文字打印
+    - 讓程序的每一部分發揮作用
+  - 其他一些好東西！
+    - 服務器也具有 CUPS/IPP 能力
+
+- 跨平台！
+  - 較新的 Windows 10 及以上
+  - GNU/Linux
+  - MacOS
+  - 還有安卓！
+
+- 是[自由軟件](https://www.gnu.org/philosophy/free-sw.html)！
+  - 不像那些專有應用，此作品為在乎*開放思想與計算自由*的人而生！
+
+- 有意思！
+  - 做什麼都可以！
+
+## 現在開始
+
+### 安卓
+
+獲取並安裝最新版安卓 apk 包，完成！
+
+應用可能請求“後台位置”權限，您可以拒絕它。  
+（前台）位置權限是較新版安卓系統掃描藍牙設備所需要的。
+
+建議將掃描時間設為 1 秒。
+
+### Windows
+
+獲取名稱中有 "windows" 的版本，  
+解壓並運行 `start.bat`
+
+Windows 通常需要較長的掃描時間。默認為 4 秒，可按需調整。
+
+### GNU/Linux
+
+您可以獲取“純淨(pure)”版，解壓、在其中打開終端並輸入：  
+```bash
+python3 server.py
+```
+
+建議將掃描時間設為 2 秒。
+
+在 Arch Linux 等發行版您可能需要首先安裝 `bluez`  
+```bash
+sudo pacman -S bluez bluez-utils
+```
+
+*以後將有軟件包！*
+
+### MacOS
+
+MacOS 用户請首先安裝 [Python 3](https://www.python.org/)，  
+然後在終端使用 `pip` 安裝 `pyobjc` 和 `bleak`：
+```bash
+pip3 install pyobjc bleak
+```
+
+然後獲取並使用“單一(bare)”版：  
+```bash
+python3 server.py
+```
+
+### 值得注意
+
+對於所有支持的平台，  
+當已安裝 [Python 3](https://www.python.org/) 時，您可以直接獲取“純淨(pure)”版，  
+或在已使用 `pip` 安裝 `bleak` 時使用“單一(bare)”版。
+
+如果您喜歡命令行，安裝 [ImageMagick](https://imagemagick.org/) 和 [Ghostscript](https://ghostscript.com/) 會很有幫助。
+
+查看所有[發佈版本](https://github.com/NaitLee/Cat-Printer/releases)！
+
+## 有問題？
+
+有想法？用 Issue 或去 Discussion 討論！
+
+如果能行，Pull Request 也可以！
+
+## 許可證
+
+Copyright © 2021-2022 NaitLee Soft. 保留一些權利。
+
+```
+本程序是自由軟件：你可以再分發之和/或依照由自由軟件基金會發布的 GNU 通用公共許可證修改之，無論是版本 3 許可證，還是（按你的決定）任何以後版都可以。
+發佈該程序是希望它能有用，但是並無保障；甚至連可銷售和符合某個特定的目的都不保證。請參看 GNU 通用公共許可證，瞭解詳情。
+你應該隨程序獲得一份 GNU 通用公共許可證的複本。如果沒有，請看 <https://www.gnu.org/licenses/>。 
+```
+
+敬請查看文件 `LICENSE`，以及在 `www/jslicense.html` 中有關 JavaScript 許可的詳細內容。
+
+具體地，`printer.py`，`server.py` 和 `main.js` 以 GNU GPL 3 發佈（`GPL-3.0-or-later`）。  
+其餘所有部分，若無特殊聲明，均在公有領域（`CC0-1.0-only`）。
+
+--------
+
+## 開發
+
+您可能對翻譯工作感興趣。可於目錄 `www/lang` 和 `readme.i18n/` 中查看翻譯文件！
+
+注：
+1. 通常英語與中文同時更新。請考慮其他。
+2. 目前使用 [OpenCC](https://github.com/BYVoid/OpenCC) 從傳統字轉換到簡體、正體、香港字。若有不當之處，請指出。  
+3. 如果（真的）有能力，您也可以糾正/改善某些翻譯！
+
+還想寫代碼？看看 [development.md](development.md)！（英文）
+
+那之後，可以將您的貢獻概括添加至 `www/about.html`
+
+### 鳴謝
+
+- 當然不能沒有 Python 和 Web 技術！
+- [Bleak](https://bleak.readthedocs.io/en/latest/) 跨平台藍牙低功耗庫，牛！
+- [roddeh-i18n](https://github.com/roddeh/i18njs)，當前內置的國際化功能受此啓發
+- [PF2 font](http://grub.gibibit.com/New_font_format)，很好的簡易像素字體格式
+- ImageMagick 和 Ghostscript，有用的東西已經在系統裏，就當然不用考慮別的了
+- [python-for-android](https://python-for-android.readthedocs.io/en/latest/)，雖然有些麻煩的地方
+- [AdvancedWebView](https://github.com/delight-im/Android-AdvancedWebView) 從 Java 拯救了我的生命
+- Stack Overflow 和整個互聯網，你們讓我從零開始瞭解了安卓“活動” `Activity`
+  ……當然還有其他方面的幫助
+- 每一位貢獻於 Issue/Pull Request/Discussion 的人
+- 每一位使用此作品並關心軟件自由的人
+- ……每個人都是好樣的！