為什麼要學這個？

可以知道某個字體檔定義了那些文字，進行知道缺字是否有缺字，及之後要先補那些字進去。

下面提供2個範例:

• 範例1: 取得 fontforge 專案下的文字清單.
• 範例2: 取得某一個目錄下, 以 unicode 為命名的文字清單.

前置作業

使用方式有2種:

• 用法1: fontforge + python. (比較簡單)
• 用法2, 需要先安裝FontForge，把要處理的字體先存成.sfdir 的資料夾格式, 執行時單純地執行 python。

FontForge執行檔下載：
https://fontforge.org/en-US/

Max腳本檔案下載：
https://github.com/max32002/MaxFontScripts/blob/master/get_ttf_chars.py

使用方法

同一個 python script, 有二種使用方法, 建議使用第一種, 在 fontforge 模式下.

有 fontforget 指令模式: (建議使用, 較有效率)

fontforge get_ttf_chars.py font_forge.sfdir --output charset.txt

無 fontforget 指令模式:

get_ttf_chars.py font_forge.sfdir --output charset.txt

參數說明：

• <輸入目錄> 參數，Font Forge 的 .sfdir 資料夾路徑。.sfdir 可以省略, 程式會自動增加, 輪入必需是一個已存在的 font forget project 目錄.
• --output 參數，用於輸出的文字檔.
• --mode 參數，預設值是 “fontforge”, 針對 fontforge 的專案檔做處理, 使用參數 –mode=unicode_image 可以取得使用 unicode 編碼的數字的圖片.

操作範例1：取得字型檔案(.ttf)的文字清單. (建議使用)

fontforget get_ttf_chars.py source.sfdir

操作範例2：取得 fontforge 專案(.sfdir)下的文字清單.

get_ttf_chars.py source.sfdir

使用範例：由於沒有指定輸出的文字檔, 預設會產生 source.txt 文字檔，裡面記錄 source.sfdir 有定義的文字。

操作範例3：取得某一個目錄下, 以 unicode 為命名的文字清單.

get_ttf_chars.py sp --mode=unicode_image

執行結果:

input: sp
output: charset_sp.txt
charset length: 73

結果說明: 輸入資料夾名稱: sp, 輸出檔名 charset_sp.txt, 內容長度: 73個字.

指定 –mode, 不是很直覺, 請改用下面的 script:

• 取得字體的包含文字
  https://codereview.max-everyday.com/get-font-chars/

字型與圖像字符集提取工具使用教學

這個小工具可以幫你從字型檔案（.otf、.ttf、.woff、.woff2、.sfdir）或是圖像資料夾中，提取出裡面包含的字符集，並輸出成一個文字檔。對於想要了解字型包含哪些字，或是從圖像建立字符集的人來說，非常方便！

使用前準備

1. 安裝 Python：如果你的電腦還沒有安裝 Python，請先到 Python 官網 下載並安裝。
2. 安裝 fontforge（如果需要處理字型檔案）：如果你需要處理字型檔案，你需要安裝 fontforge 這個工具。安裝方式會根據你的作業系統有所不同，請參考 fontforge 官網 的說明。
3. 安裝 LibGlyph（如果需要處理 .sfdir 檔案）：如果你需要處理 .sfdir 檔案，你需要安裝 LibGlyph 這個函式庫。你可以使用 pip 來安裝： pip install LibGlyph
4. 準備字型檔案或圖像資料夾：把你想要處理的字型檔案或圖像資料夾放在一個方便存取的位置。

使用方式

1. 下載腳本：把上面的 Python 腳本複製下來，儲存成一個 .py 檔案，例如 get_ttf_chars.py。
2. 開啟終端機或命令提示字元：在你的作業系統中開啟終端機（macOS/Linux）或命令提示字元（Windows）。
3. 執行腳本：使用以下指令來執行腳本，並替換成你自己的檔案路徑和選項：
   python get_ttf_chars.py <輸入檔案或資料夾路徑> --output [輸出文字檔路徑] --mode [模式]
   • <輸入檔案或資料夾路徑>：指定輸入的字型檔案或圖像資料夾路徑。
   • --output：指定輸出的文字檔路徑，預設是 output.txt。
   • --mode：指定模式，有兩種模式可以選擇：
     • fontforge：處理字型檔案（.otf、.ttf、.woff、.woff2、.sfdir）。
     • unicode_image：處理圖像資料夾，圖像檔名必須是 Unicode 編碼的數字。
4. 範例：
   • 處理字型檔案：
     python get_ttf_chars.py myfont.ttf --output mycharset.txt --mode fontforge
   • 處理圖像資料夾：
     python get_ttf_chars.py images --output image_charset.txt --mode unicode_image
5. 查看輸出結果：執行完成後，會在指定的路徑產生一個文字檔，裡面包含了提取出來的字符集。

注意事項

• 圖像資料夾中的圖像檔名必須是 Unicode 編碼的數字，例如 65.png 代表字元 ‘A’。
• 如果處理字型檔案時遇到問題，請確認 fontforge 是否正確安裝。

進階應用

字型A (例如: zen maru) 使用的異體字清單如下:

不串丹什來例便僚兀兩凉列利刺力勉勒勤卑句吏呂喇墨壘尿年弄律懶拓易暈暴更林櫓沈洛洞淋濫烈珞理略異碑磊行裏見豈賂賈路車輻郞里量閭阮隆隷駱魯鷺

字型B (例如: noto sans) 也使用了相同形狀但編碼不同的異體字:

兀勉勤卑墨碑隆豈更車賈串句喇懶洛珞駱濫來櫓路魯鷺弄磊賂壘勒丹異便不沈略兩量呂閭力年列烈例僚尿暈阮律利吏易理裏里林淋什刺拓洞暴輻行見

要如何在2個字型, 分別完成對映? 解法是在呼叫 get_ttf_chars.py 增加參數 –altuni 與 –find_alt_text=text

範例:

fontforge get_ttf_chars.py notosans.ttf --output alt_root.txt --altuni --find_alt_text=不串丹什來例便僚兀兩凉列利刺力勉勒勤卑句吏呂喇墨壘尿年弄律懶拓易暈暴更林櫓沈洛洞淋濫烈珞理略異碑磊行裏見豈賂賈路車輻郞里量閭阮隆隷駱魯鷺

這樣就可以取得 notosans 的真正 glyph 本體.

同時附上 mapping 表:

redirect_dict = {19981: 63847, 20018: 63749, 20025: 63838, 20160: 63997, 20358: 63789, 20363: 63925, 20415: 63845, 20698: 63931, 20800: 20800, 20841: 63864, 21015: 63900, 21033: 63965, 21050: 63999, 21147: 63882, 21193: 21193, 21202: 63826, 21220: 21220, 21329: 21329, 21477: 63750, 21519: 63966, 21570: 63872, 21895: 63755, 22696: 22696, 22744: 63818, 23615: 63933, 24180: 63886, 24324: 63811, 24459: 63960, 25078: 63757, 25299: 64002, 26131: 63968, 26248: 63941, 26292: 64006, 26356: 63745, 26519: 63988, 27347: 63793, 27784: 63858, 27931: 63765, 27934: 64005, 28107: 63989, 28651: 63778, 28872: 63903, 29662: 63767, 29702: 63972, 30053: 63862, 30064: 63842, 30865: 30865, 30922: 63815, 34892: 64008, 35023: 63975, 35211: 64010, 35912: 63744, 36034: 63816, 36040: 63747, 36335: 63799, 36554: 63746, 36667: 64007, 37324: 63977, 37327: 63870, 38317: 63878, 38446: 63942, 38534: 38534, 39409: 63770, 39791: 63801, 40442: 63802}

把 mapping 表放在 export_ttf_to_svg.py 內, 就可以讓 zen maru 所匯出的 .svg 可以讓 notosan 直接做匯入.

接續應用

有了清單之後, 就是需要去清單做交集或刪除的過濾.

• 從文字檔移除特定文字集合
  https://codereview.max-everyday.com/remove-selected-char/

相關文章：

• 從字體專案裡取得特定文字glyph
  https://codereview.max-everyday.com/get-selected-glyph-from-font/
• 從文字檔移除特定文字集合
  https://codereview.max-everyday.com/remove-selected-char/

為什麼要學這個？

如果遇到某一個資料夾裡的檔案數量太多，造成處理的效能不佳，幫資料夾的檔案數量瘦身，以增加處理的效率。

這個使用批次檔（或shell script）腳本程式來處理，一定比使用人工去選取和搬移快很多。

類似的應用像是自動幫特定的資料夾自動更新部份內容後，再幫資料夾上傳內容到github 上。 很多人工手動的操作，應該都可以換成使用自動化的腳本來完成，減少人工重覆去操作的這個行為。當然，要處理的事情的數量少，而重覆機率低，使用純手工去做，可能會方便點。

類似且重覆性質的工作，交給程式來做，人類比較不會覺得無聊。

前置作業

範例程式碼下載：
https://github.com/max32002/MaxFontScripts/blob/master/batch_make_dirs.py

使用方法

Step 1：先使用 grep 或 ls 指令，取得要處理的目錄清單。

Step 2：組合要進去每一個目錄後，要執行的指令有那些。

Step 3：執行 python script 並轉向輸出到 run.sh (或Windows 平台的批次檔)

Step 4：執行產生出來的 run.sh。

因應瘦身，所以原本直接產生到該目錄下的匯出程式也要跟著調整，針對第1個字元，多往下產生到子資料夾：
https://github.com/max32002/MaxFontScripts/blob/master/bmp.py

因應瘦身，所以原本要讀取的程式，也要跟著調整多往下一個子資料夾來取得檔案。

Code Review 影片

搬移檔案到子資料夾：解決檔案的數量太多問題

為什麼要學這個？

如果透過指令或程式來做會更有效率的話，當然要使用指令來做。這篇文章主要在講文字檔裡的字串處理。

如果有想透過程式來合併文字檔的內容，可以試看看文章裡附的小程式。

前置作業

程式碼下載：
https://github.com/max32002/MaxFontScripts/blob/master/update_block_from_file.py

使用方法

update_block_from_file.py --first FIRST --second SECOND --begin BEGIN --resume RESUME

參數說明：

• –first 第一個檔案路徑，內容會被修改。
• –second 第二個檔案路徑，內容會被複製。
• –begin 第一個檔案跳脫不處理，第二個檔案開始複製的字串。
• –resume 第二個檔案跳脫不處理，並且第一個檔案接續輸出的字串。

改良前的前身：
https://github.com/max32002/MaxFontScripts/blob/master/update_lang_props.py

前身的前世：
https://github.com/max32002/MaxFontScripts/blob/master/copy_kerning_props.py

使用範例2號

遇到的問題是，想要同步 github 的多個 project 裡的 README.md 檔案裡的「相關網址」的區塊。

使用步驟：

Step 1：先修改出一個標準版，要讓其他專案做「共用」，修改後放到一個指定路徑。例如：~/Documents/sh/fix_font_readme_urls/README.md

Step 2：使用 find . 指令，列出有 README.md 的專案，或使用 ls 手動整理目錄的清單。

Step 3：使用 Step 2 的 List ，產生一個 python 檔案。例如：batch_sync_git_readme.py，檔案下載：
https://github.com/max32002/MaxFontScripts/blob/master/batch_sync_git_readme.py

這個程式的主程式，是去使用上面寫的 python, 主程式如下：

begin_string = "## 相關網頁"
resume_string = "https://max-everyday.com/about/#donate"
cmd = "~/Documents/sh/update_block_from_file.py --first \"%sREADME.md\"" % (item.replace("\"","\\""))
cmd += " --second \"%s\"" % (reuse_file.replace("\"","\\""))
cmd += " --begin \"%s\"" % (begin_string.replace("\"","\\""))
cmd += " --resume \"%s\"" % (resume_string.replace("\"","\\""))
print(cmd)

Step 4：執行 batch_sync_git_readme.py > run.sh 取得批次置換的指令在 run.sh 裡。

Step 5：先手動執行 run.sh 裡的某一行，並檢查置換結果是否如預期。如果結果是對的，就執行 run.sh 讓其他的資料夾都置換成「共用區塊」後的版本。

Step 6：執行批次git add/commit/push 指令。例如：batch_git_push.py，檔案下載：
https://github.com/max32002/MaxFontScripts/blob/master/batch_git_push.py

使用範例3號

情境：

有多個目錄 ex: /convert/, /convert_b2/ , /convert_xd/ 每個目錄下都有 TtfConfig.py, 每個 python 的檔案，在某一行以下，希望與 /convert/ 目錄下的 TtfConfig.py 相同。

使用方法：

~/Documents/sh/update_block_from_file.py --first convert_xd/TtfConfig.py --second convert/TtfConfig.py --begin " STYLE_INDEX = 5"

範例說明：

在 ” STYLE_INDEX = 5″ 這行文字以下，都會使用 second 的，會修改掉 first 指定的檔案。

Code Review 影片

程式架構優化 – 從其他檔案置換區塊內容
https://youtu.be/q2b1MYMpvUI

Max優化程式的方法是減少程式碼中寫死的常數，提升程式的彈性來增加使程式更容易重覆利用。

為什麼要學這個？

比使用人工去取出想更新的文字有效率。

與使用「人工」手動去處理相比，用程式去取出想更新的文字有效率。

程式的目的是要去取出font forge 專案檔的特定 glyph.

前置作業

使用前，需要先安裝FontForge，把要處理的字體先存成.sfdir 的資料夾格式。

重要：這個小程式目前無法直接輸入字型檔, 只能處理 .sfdir 資料夾。

FontForge執行檔下載：
https://fontforge.org/en-US/

Max腳本檔案下載：
https://github.com/max32002/MaxFontScripts/blob/master/copy_selected_out.py

使用方法

copy_selected_out.py --input INPUT --string STRING --output OUTPUT

參數說明：

• --input 要處理的字體專案目錄。
• --string 要取出的字串。
• --output 要輸出的路徑，預設是執行指令的現行目錄下。

操作範例：

copy_selected_out.py --input source.sfdir --output target.sfdir --string 每一天

使用範例：從 source.sfdir 取出 「每一天」3個字，存到轉換為 target.sfdir 目錄。

進階參數說明

• --file 目的字串的文字檔。
• --range 目的字元的範圍, 使用16進制, 例如: –range AC00,D7AF
• --range_int 目的字元的範圍, 使用10進制.

常見的 range

• 2E80 – 2EFF: CJK Radicals Supplement
• 3400 – 4DBF: 中日韓統一表意文字擴充區A,
• 4E00 – 9FFF: CJK Unified Ideographs,
• AC00 — D7AF: 諺文音節 (Hangul Syllables), Hangul音節是一個Unicode塊，其中包含用於現代韓語的預先編寫的Hangul音節塊。音節可以通過算法直接映射到韓文字母Unicode塊中的兩個或三個字符的序列： U + 1100–U + 1112之一：19個現代韓文字母領先的輔音字母； U + 1161–U + 1175之一：21種現代韓文元音字母；
• F900 – FAFF: CJK Compatibility Ideographs
• 20000 – 2A6DF: 中日韓統一表意文字擴充區B
• 30000 – 3134F: 中日韓統一表意文字擴展區G

相關文章：

• 透過指令「字體」與「FontForge專案」互轉
  https://codereview.max-everyday.com/font-to-fontforge/
• 從圖片目錄裡取得特定文字檔案
  https://codereview.max-everyday.com/copy_selected_image_out/

透過 FontForge 開啟，並另存專案為資料夾格式(.sfdir)，除了手動去操作之外，也可以使用腳本來做。如果透過指令來做會更有效率的話，當然要使用指令來做。

實作步驟

使用前，需要先安裝FontForge，透過執行FontForge的腳本(Script)可以在指令行的模式下，合併2個字體檔案。

FontForge執行檔下載：
https://fontforge.org/en-US/

Max腳本檔案，轉成FontForge (all font format to .sfdir)下載：
https://github.com/max32002/MaxFontScripts/blob/master/save_as.py

Max腳本檔案，轉成字體檔 (all font format to .ttf/.otf/.svg/.woff/.woff2)下載：
https://github.com/max32002/MaxFontScripts/blob/master/generate.py

使用範例

把 source.ttf 轉換為 target.sfdir

fontforge save_as.py -i source.ttf -o target.sfdir

把 source.ttf 轉換為 target.woff2

fontforge generate.py -i source.ttf -o target.woff2

檔案說明

• generate.py
  讀取字體並匯出為 .ttf / .woff2
• save_as.py
  讀取字體並產成為 fontforge 專案資料夾 .sfdir
  

MaxCodeReview 影片

Youtube：https://youtu.be/9-0WHjjfOgU

相關文章：

• 轉換字型為webfont
  https://stackoverflow.max-everyday.com/2020/08/convert-ttf-to-webfont/
• 如何製作「字體預覽」的網頁功能
  https://codereview.max-everyday.com/webfont-preview-textarea/

為什麼要學這個？

如果透過指令來做會更有效率的話，當然要使用指令來做。這個指令還滿常使用到的，因為字體常常在補字，一定會用到合併的功能。

GUI 的操作參考使用下面的這篇分享：合併字型較安全的方法
https://codereview.max-everyday.com/a-safer-way-to-merge-fonts/

這篇教學示範2個解法:

• 解法1: 透過 fontforge + .pe 檔.
• 解法2: python + fonttool

解法1: 透過 fontforge + .pe 檔.

使用前，需要先安裝FontForge，透過執行FontForge的腳本(Script)可以在指令行的模式下，合併2個字體檔案。

FontForge執行檔下載：
https://fontforge.org/en-US/

Max腳本檔案下載：
https://github.com/max32002/MaxFontScripts/blob/master/merge_font.pe

MaxCodeReview 影片：
https://youtu.be/SFCf50iiQbs

解法1使用範例

merge_font.pe main.ttf added.ttf outout.sfdir

說明：前二個參數，由於是使用 FontForge 去開啟，不限於 .ttf 或 .sfdir 格式，都可以被順利開啟。

第三個參數，目前的腳本固定要使用 .sfdir 格式，因為是使用 Save() 指令，如果是要產生成 .ttf 要改用 Generate().

解法2: python + fonttool

Max腳本檔案下載：
https://github.com/max32002/MaxFontScripts/blob/master/merge_font.py

使用範例:

python merge_font.py --font1 font1.ttf --font2 font2.ttf --output font3.ttf

執行畫面:

使用這個解法, 比較方便與安全, 缺點就是合併完的檔案, 在作業系統雖然可以使用, 但無法被 fontforge 開啟.

當 font1 與 font2 同時都有的字元, 會以 font2 被保留下來, 理論上應該是, 但實際上, 有時候會以 font2 為主, 有時候並不會被取代.

相關網頁

FontForge Scripting Tutorial
https://fontforge.org/docs/tutorial/scripting-tutorial.html