holaswift-presentaciones

Presentaciones hola Swift 簡報製作技能

根據 hola Swift（西班牙語 Swift 社群）的品牌風格，產生 16:9 的 .pptx 簡報。腳本已知道如何為每種投影片類型套用品牌標誌。你的工作是撰寫腳本：決定有哪些投影片、每張的類型以及內容。腳本會處理大小、位置、顏色、背景、管狀標誌與 logo。

運作方式

1. 了解任務。 這是什麼類型的內容（每月講座、現場活動、贊助、社群）、誰要進行簡報、以及簡報時長。如果使用者提供了素材（筆記、文件、演講稿腳本），則以此為基礎，將每張投影片濃縮為一個想法。如果缺少關鍵資訊（如講座主題、日期），請提問。如果是細節資訊，請用 [方括號] 標示，並在最後說明。
2. 撰寫腳本，格式為 JSON 檔案，請遵循 references/guion.md。在開始撰寫前請先閱讀該檔案：裡面說明了投影片類型、欄位以及何時使用哪一種。
3. 產生簡報檔案：

   pip install python-pptx pillow numpy   # 如果尚未安裝
   python3 <技能路徑>/scripts/hacer_presentacion.py guion.json "hola Swift - <名稱>.pptx"
   

   腳本中的 imagen 與 foto 路徑會相對於 JSON 檔案的位置進行尋找。如果腳本提示任何問題（例如不存在的投影片類型），請修正後重新產生。將腳本與 .pptx 檔案一併儲存，並一起交付：後續若要修改，只需編輯腳本並重新產生，無需逐張手動調整。
4. 盡可能審查。 在 Mac 上使用 Keynote，如果使用者不介意暫時開啟應用程式，你可以將投影片匯出為圖片進行查看（請使用絕對路徑，目標資料夾必須存在）：

   osascript -e 'tell application "Keynote"' -e 'open POSIX file "/絕對路徑/簡報.pptx"' -e 'delay 8' -e 'export front document to POSIX file "/絕對路徑/目標資料夾-png" as slide images with properties {image format:PNG}' -e 'close front document saving no' -e 'end tell'
   

   使用 LibreOffice：soffice --headless --convert-to pdf 簡報.pptx。如果兩者皆無，請重新閱讀腳本，檢查是否有文字內容超過該投影片類型允許的長度（限制請參考參考資料），並在交付時告知。
5. 交付 .pptx 檔案（以及腳本）給使用者以便下載，並用幾行文字說明有哪些投影片以及缺少的資料（以 [方括號] 標示）。

使用情境

• 每月講座： 封面、hola（主題以顏色呈現）、內容、pregunta（問題討論）以及 cierre（結尾）。如果由外部講者進行簡報，請參考下一點。
• 講者範本： assets/plantillas/plantilla-ponentes.pptx 是一份 hola Swift 簡報，其中包含 [方括號] 預留位置以及說明每張投影片的備註。如果講者索取範本，請直接交付；如果提供了講者姓名、主題與日期，請複製 assets/plantillas/plantilla-ponentes.json，填寫已知資訊，並產生客製化版本。提醒講者字型 Inter 位於 assets/fonts/。
• 活動或直播畫面： 開始前使用 espera（等待）畫面（「我們將在 19:05 開始」）、休息期間與結束時使用；agenda（議程）顯示節目表（每個區塊一份，並以 actual 標示目前進行中的講座）；logos 用於感謝贊助商。這些通常放在一個獨立的簡報中，僅包含畫面。
• 講座回顧： 5-7 張投影片，包含重點摘要（封面、3-4 個概念以 frase、texto 或 codigo 呈現，以及 cierre 提供觀看錄影的連結）。為了在 LinkedIn 上以輪播形式分享，或是在 Discord 上分享，可從 Keynote 或 PowerPoint（或使用 LibreOffice）匯出為 PDF。
• 贊助與年度報告： cifras（數據）僅使用真實數據，tarjetas（卡片）呈現提供的項目，logos 感謝現有支持者，cierre（結尾）包含 contacto（聯絡資訊）。如果是包含表格與價格的長文件，建議使用文件而非簡報。

設計風格與原因

品牌形象是一個手寫的招呼語：3D 管狀的「hola」是主角，其他一切保持簡潔。簡報遵循 Apple 發表會邀請函的語言：一張投影片一個概念、標題大而醒目、文字極簡。如果一張投影片需要大量文字，請將其拆分為兩張。

• 「¡hola + X」（類型為 hola）是品牌的標誌性動作：「¡hola SwiftUI」「¡hola Discord」「¡hola 2027」。用它來開始一場講座或一個章節，不要每張投影片都用。
• 三種主題： claro（淺色，紙張質感，預設）、oscuro（深色，用於重點語句與休息時刻）以及 color（全版背景色，文字與管狀標誌為白色）。有目的地交替使用：基礎使用淺色，深色用於重點語句，彩色用於開場與問題討論。整份簡報都用彩色會讓人疲勞。
• 根據內容決定顏色： 講座使用 azul（藍色）、實體聚會使用 naranja（橘色）、人物與大使使用 verde（綠色）、贊助使用 violeta（紫色）、社群與公告使用 rosa（粉紅色）。在腳本中設定 "contenido"，腳本會自動選擇顏色。
• 無裝飾： 不使用自創圖示、表情符號、陰影、自訂漸層、頁尾網站或「Swift en español」等標籤。腳本不會加入這些元素；請勿自行以文字方式加入。

寫作風格

• 使用 「vosotros」（你們） 親切、中性的西班牙語。 "Ya no estáis solos"（你們不再孤單）是社群的名言。
• 誠實： 好的、壞的、以及即將到來的。不宣揚輕易成功或勵志語錄。
• 句子簡短。 先放事物名稱：「Charla mensual · 14 de enero」（每月講座 · 1 月 14 日），而非「Te invitamos a nuestra próxima charla」（我們邀請您參加下次講座）。
• 句子風格： 僅首字母大寫（「Próximas charlas」，而非「Próximas Charlas」）。除非是縮寫，否則不應使用全大寫。
• 總是使用 ¡ 與 ¿。 品牌名稱為 hola Swift：兩個字，「hola」小寫，「Swift」大寫。切勿寫成「holaSwift」。
• 不要捏造數據、數字或引用：如果沒有相關資訊，請使用 [方括號] 標示。

開啟簡報的電腦字型

.pptx 檔案使用 Inter Display（標題）、Inter（內文）以及 Menlo（程式碼）。如果開啟簡報的電腦沒有安裝 Inter，Keynote 與 PowerPoint 會使用替代字型。字型檔案位於 assets/fonts/（使用開放式 OFL 授權）：如有需要，請在第一次使用時提醒使用者安裝。

資源

• scripts/hacer_presentacion.py：產生器。使用時無需閱讀其內容。
• references/guion.md：腳本格式、投影片類型以及完整範例。在撰寫腳本前請務必閱讀。
• assets/tubo/、assets/logo/：3D 管狀「hola」（彩色與白色）以及 logo；腳本會自動使用。
• assets/fonts/：Inter 與 Inter Display 字型。
• assets/plantillas/：講者範本（.pptx 及其 .json 腳本）。