模板描述檔分享區

[510208]

🙌 模板描述檔分享區

歡迎來到 模板描述檔分享區！

這裡是專為微型國家政府人員打造的交流平台，分享與討論如何使用本工具來批次產生各類官方證件。無論你是來自虛擬國、微型政體，或是正在建立自己的自治系統，本工具都能協助你高效管理身分文件。

📄 何謂模板描述檔？

模板描述檔是用來定義證件生成規則的設定文件，讓本工具能根據 CSV 資料自動產出格式一致、內容正確的證件。它就像是一份「設計圖」，告訴系統每一欄資料該如何呈現在證件上。

-- 🔍 主要功能 --

• 指定每個欄位的用途（例如：姓名、國籍、有效期限）
• 設定證件版型與排版位置
• 定義文字樣式、圖片路徑、條碼或 QR Code 等元素
• 支援多語系與條件式顯示（例如根據國籍顯示不同圖章）

-- 🧩 應用場景 --

1. **身分證：**顯示姓名、出生年月、國籍、照片等
2. **護照：**包含簽發日期、有效期限、簽名欄位
3. **簽證：**根據入境目的與停留時間自動調整內容

📁 檔案格式： 通常使用 .yaml 格式撰寫，易於閱讀與維護。

📂 你可以在這裡：

• 分享你設計的模板描述檔（.yaml）
• 討論欄位命名、格式規範與排版技巧
• 提出改進建議或功能需求
• 展示你生成的證件成果，激發創意！

📗 你可以怎麼做：

• 設計一個 YAML 格式的模板描述檔，並附上簡單的說明，讓大家可以基於這份檔案改造自己的版本！
• 將模板描述檔的 YAML 內容使用程式碼區塊包覆，並確保標註上 Markdown 程式碼區塊與 yaml 語法標籤，或是附加一份檔案上來。

Warning

千萬不要將國家任何版本的證件分享到網站上，你應該確保分享出來的文件是即使被偽造也沒問題的，例如設計好供各國用的通用證件範本、微國共同邊界區簽證等。

Warning

請確保文件可以正常使用，並使用正確的 YAML 格式。你應該已經測試過才上傳到這個網站上，謝謝你！

如果你是第一次使用這個工具，也歡迎發問或索取範例模板。這是一個由社群共同建構的空間，讓我們一起讓微國治理更有系統、更有趣！

[510208]

🛬 微國共同邊界區簽證

❓ 使用說明

微國共同邊界區是由微國家聯盟設立的共同邊界區，像申根公約一樣。持有共同邊界區任一國核發、在效期內的此簽證，就能憑此簽證前往任何加入微國共同邊界區的國家，不須重複申請簽證！

請各國將自己國家的空白簽證檔案匯入軟體的 templates 資料夾中，並將以下模板檔案的內容改為正確的格式。匯入軟體的 CSV 檔案也如下瑣事。

🧩 模版描述檔（microunion-visa.yml）

id: microunion-visa
country: "和平共和國"
version: "1.0"

background:
  image: "空白簽證圖檔路徑（在 `templates` 資料夾下，路徑不需要附上 templates 目錄）.png"
  color: "#FFFFFF"

fields:
  - key: name
    type: text
    position: [325.281, 196.452]
    font_size: 20
    font_color: "#000000"
    font_family: "NotoSansTC-Bold.ttf"
    data_path: name

  - key: sex
    type: text
    position: [639.639, 196.452]
    font_size: 20
    font_color: "#000000"
    font_family: "CartographMonoCF-Regular.ttf"
    data_path: sex

  - key: nationality
    type: text
    position: [325.281, 260.579]
    font_size: 20
    font_color: "#000000"
    font_family: "OCR-B.ttf"
    data_path: nationality

  - key: birth_date
    type: text
    position: [639.639, 260.579]
    font_size: 20
    font_color: "#000000"
    font_family: "OCR-B.ttf"
    data_path: birth_date

  - key: issue_date
    type: text
    position: [325.281, 351.164]
    font_size: 20
    font_color: "#000000"
    font_family: "OCR-B.ttf"
    data_path: issue_date

  - key: expiry_date
    type: text
    position: [639.639, 319.773]
    font_size: 20
    font_color: "#000000"
    font_family: "OCR-B.ttf"
    data_path: expiry_date

  - key: purpose
    type: text
    position: [639.639, 384.797]
    font_size: 20
    font_color: "#000000"
    font_family: "OCR-B.ttf"
    data_path: purpose

  - key: passport_number
    type: text
    position: [639.640, 437.265]
    font_size: 20
    font_color: "#000000"
    font_family: "OCR-B.ttf"
    data_path: id_number

photo:
  enabled: true
  folder: "./photos"
  position: [30, 181]
  size: [248, 335]
  border_radius: 0

output:
  dpi: 300
  save_to: "./id-sp"
  output_file_format: "{name}_back.png"
  other_file: []

📸 所需文件

需要創建的資料（ data/data.csv ）

name,sex,nationality,birth_date,issue_date,expiry_date,purpose,id_number
"Ming Wang",M,TWN,1990-01-01,2025-08-01,2026-08-01,Tourist,AB1234567
"Beautiful Lee",F,CHN,1985-05-12,2025-07-15,2026-07-15,Tourist,CD9876543
"John Doe",M,USA,1992-11-23,2025-06-20,2026-06-20,Tourist,EF7654321
"Ken Sato",M,JPN,1988-03-30,2025-08-05,2026-08-05,Diplomat,GH2468135

照片（放在 photo 資料夾下）

空白簽證範本（放在 templates 資料夾下）

Important

你的國家必須是微國家聯盟共同邊界區的成員國，才有權力使用此模版。
因偽造簽證造成的問題不歸本軟體管轄！

字體檔案

在預設情況下，你會需要以下三個字體（放入 fonts 資料夾中）：

microunion-visa_Fonts.zip