LAAM Illustrator Scripts
全部教學 English
中文說明

Price Tag Generator.

用一個或多個已命名 Illustrator Template 配合 UTF-8 CSV，大量生成 Price Tag。Script 會處理文字、價錢、多個 Logo、QR Code、Optional 圖片、出血排版同 Print Sheets。

適用於 v1.11 Adobe Illustrator JSX

安裝及啟動。

  1. 完整解壓 Generator Folder；Launcher 同 Core 必須放喺同一個 Folder。
  2. 用 Illustrator 開啟 Template AI。
  3. 選擇 File → Scripts → Other Script…。
  4. 執行 Price_Tag_Generator_Launcher_v1.11.jsx。
每次都應該執行 Launcher，唔好直接執行 .jsxinc Core。Launcher 會確保 UI 同 Illustrator Document 操作喺正確 Engine 執行。
圖片位置assets/images/ptg-ui-overview.webp
建議：包括 Generate、Layout、Print 三個分頁嘅完整 UI。

截圖位置 — 準備好圖片後將 figure 入面嘅 span 換成 img。

設定 Illustrator Template 名稱。

將完整 Price Tag Artwork Group 埋，選取成個 Group，再按 Prepare Selection。Script 會根據 Active Artboard 尺寸命名 Artboard 同 Group，例如 PT_TEMPLATE_90x54。

必須物件

名稱用途
PT_TITLE產品主標題 TextFrame。
PT_SUBTITLE副標題 TextFrame。
PT_INFO一個多行產品資料 TextFrame。
PT_PRICE_LABEL「零售價／HK$」Label Group。
PT_PRICE_VALUE價錢數字 TextFrame。

常用 Optional 物件

名稱用途
PT_LOGO + PT_LOGO_GUIDE第一個 Logo Placeholder 同 Key Object；亦支援 PT_LOGO_1。
PT_LOGO_2 + PT_LOGO_2_GUIDE第二個 Logo；可以繼續加 3、4 等編號。
PT_QR_CODE + PT_QR_CODE_GUIDEOptional QR Code 同 Contain 範圍。
PT_BACKGROUND + PT_BACKGROUND_GUIDEOptional 背景同 Cover 範圍。
PT_PRODUCT_IMAGE + PT_PRODUCT_GUIDEOptional 產品圖同 Fit 範圍。
PT_PRICE_ANCHOROptional 價錢組合右下角 Anchor。
PT_PRICE_SAFE長價錢縮細時使用嘅安全範圍。
圖片位置assets/images/template-object-names.webp
建議：Illustrator Layers Panel 顯示全部 PT_ 物件。

截圖位置 — Template Group 同 Layers Panel。

將每個 Logo 放到自己嘅 GUIDE 外圍。

每個編號 Logo 都可以喺 CSV 使用獨立 Alignment。GUIDE 永遠係 Key Object，但 v1.10 改用外置 3 × 3 排位：將 Logo 最接近 GUIDE 嗰一邊接到指定 Anchor。只有 center 會中心疊中心。

top_left
top_center
top_right
middle_left
center
middle_right
bottom_left
bottom_center
bottom_right
CSV 值Anchor 接法
top_leftLogo 右下 → GUIDE 左上。
top_centerLogo 下中 → GUIDE 上中。
top_rightLogo 左下 → GUIDE 右上。
middle_leftLogo 右中 → GUIDE 左中。
centerLogo 中心 → GUIDE 中心。
middle_rightLogo 左中 → GUIDE 右中。
bottom_leftLogo 右上 → GUIDE 左下。
bottom_centerLogo 上中 → GUIDE 下中。
bottom_rightLogo 左上 → GUIDE 右下。

Settings 嘅 X/Y Offset 會喺 Anchor 接好之後再套用。X 正數向右；Y 正數向下。

圖片位置assets/images/logo-guide-alignment.webp
建議：紅色 GUIDE 同兩個唔同位置嘅真實 Logo。

截圖位置 — 一個實際 Logo 對齊例子。

建立 Flexible UTF-8 CSV。

儲存成 CSV UTF-8 (Comma delimited)。每一行會生成一個 Price Tag。路徑可以相對於 CSV Folder，亦可以相對於 UI 選擇嘅 Assets Folder。

欄位用途
template_id例如 90x54；留空使用 UI Default Template。
output_nameArtboard 名稱；留空會用 SKU。
title、subtitle主要文字。
info_1、info_2 … info_n動態偵測並合併到多行 PT_INFO。
price價錢數值；Layout 可以啟用 1,000 格式。
logo_1_file、logo_1_align第一個 Logo 路徑同外置 GUIDE 位置。
logo_2_file、logo_2_align第二個 Logo；有需要可以按編號繼續加。
qr_code_fileOptional QR Code 路徑。
background_fileOptional 背景路徑。
product_image_fileOptional 產品圖路徑。
Info 欄位冇固定 5 行上限，需要時直接加入 info_6、info_7 或更大編號。Script 會按數字次序排列、略過空白 Cell，而且 info_10 會正確排喺 info_9 後面。最後可見行數仍然受 PT_INFO／PT_INFO_GUIDE 高度同 Auto-fit 最細字級限制。
template_id,output_name,title,subtitle,info_1,info_2,info_6,price,logo_1_file,logo_1_align,logo_2_file,logo_2_align,qr_code_file
90x54,HC5,"HC 5 Portable USB DAC","Flagship portable DAC","1. Dual-DAC architecture","2. OLED display","6. Extra information",3680,logos/brand.ai,top_right,logos/partner.svg,bottom_left,qr/hc5.png
圖片位置assets/images/csv-example.webp
建議：Excel 顯示 CSV，畫面包括 logo_1／logo_2 欄位。

截圖位置 — 最好清楚見到編號 Logo 欄位。

每行有需要先加入圖片。

Logo、QR、產品圖同 Optional Image 支援 Illustrator 可以 Place 嘅 SVG、AI、PNG、JPG/JPEG、PDF、EPS、TIFF 同 PSD。欄位留空會保留 Template 物件；填 none 或 - 會隱藏。

Flexible Optional Columns

CSV 欄位Illustrator Object功能
asset_badge_filePT_ASSET_BADGE放入任意 Optional 圖片。
asset_badge_fitPT_ASSET_BADGE_GUIDEcontain 或 cover。
text_promoPT_TEXT_PROMO替換 Optional TextFrame。
show_asset_badgePT_ASSET_BADGEyes/true/1 顯示；no/false/0 隱藏。
badge 可以改成任何一致 Key，例如 warranty、member_icon 或 energy_label。CSV 冇嗰個 Optional 欄位時，Script 唔會改佢。

生成置中兼計埋出血嘅排版。

  • 原 Template 文件或 New Document。
  • 固定 Columns 或自動平衡 Grid。
  • 次序由左至右、上至下。
  • 完整 Grid 置中，避開慢速 Canvas 邊位。
  • Artboard 間距計埋四邊 Bleed。
  • 需要時自動再試 Large Canvas。

New Document 名稱

假設 Template 叫 HC5_Template.ai，Layout 新文件會叫 HC5_Template_Price_Tag.ai；Print Sheets 會叫 HC5_Template_Price_Tag_Print.ai。兩個都係未儲存文件，最後 Folder 仍然由你選擇。

Auto／Manual Bleed

Auto 會先嘗試 Illustrator Document Setup，再讀已儲存嘅 PDF-compatible AI。Manual 會使用輸入嘅 mm 數值。New Document 會先核實 Bleed，成功先接受正式 Output。

Same template document 唔可以改寫現有文件嘅 Document Setup。Manual Bleed 仍然會控制生成排距同 Print Sheets；如果 Output 文件本身一定要有新 Bleed，請揀 New document。
圖片位置assets/images/bleed-layout.webp
建議：多個置中 Artboard，顯示紅色 Bleed Bound 同 Gap。

截圖位置 — 顯示 Bleed 同 Gap 點樣避免重疊。

生成可以印刷嘅 Print Sheets。

喺 Print 分頁 Tick Create print sheets，再設定 A6–A1、方向、Copies/tag、Page Margin、Item Gap 同 Trim Mark。

  1. 每款 Copies 連續排列：A、A、A、B、B、B、C、C、C。
  2. 每個 Price Tag 都會 Duplicate 入獨立 Clipping Group。
  3. 有 Bleed 時，Clipping Mask 會包括 Trim 加 Bleed Artwork。
  4. 只有有 Bleed 先畫 Trim Marks，而且 Marks 對準原本 Trim Artboard。
  5. 一頁放唔落會繼續下一個同尺寸 Artboard，次序唔會改。
圖片位置assets/images/print-sheets.webp
建議：A4 Print Sheet 顯示重複 Price Tag、Clipping Mask 同 Trim Marks。

截圖位置 — 一張完整 A4 或 A3 拼版。

建議 Production Workflow。

  1. 開啟 Template，儲存成 PDF-compatible AI。
  2. 選取完整 Price Tag Group，第一次使用時按 Prepare Selection。
  3. 命名必須同 Optional Child Objects。
  4. 按 Check Template，直至顯示 Ready。
  5. 選擇 UTF-8 CSV，再喺 Assets Folder 揀任何一個檔案。
  6. 設定 Layout、Bleed 同 Print Options。
  7. 先 Preview First，檢查 Logo、文字 Fit 同價錢間距。
  8. 最後 Generate All，再儲存 Layout／Print 新文件。

有問題時點樣檢查。

訊息／結果要檢查嘅地方
“There is no document”按 Prepare、Check 或 Generate 前先開啟 Template AI。
Template 顯示缺少名稱展開已準備嘅 Group，逐個核對必須 PT_ 名稱。
Logo 太大或視覺偏移裁走透明邊，核對佢自己嘅 GUIDE，同埋選擇正確外置 logo_n_align。
Asset not found檢查拼字、Extension，同埋 Relative Path 係由 CSV 定 Assets Folder 開始。
Auto Bleed 讀到 0改完 Document Setup 後，用 PDF Compatibility 儲存 Template，再 Check Template。
Print Sheet 冇內容確認最少一個 Price Tag 成功生成，而且已 Tick Create print sheets。

開啟 Debug / Logs，報錯時保留最後一段 Error Block。

圖片位置assets/images/debug-log.webp
建議：Debug / Logs Window 標示最後一段 Error。

截圖位置 — 顯示真正有用嘅 Log 部分。