Cerulean:場景式簡報,每步變換
你設計,Cerulean 建構。你只需撰寫三個檔案:JSON 格式的腳本、JS 格式的場景程式碼與 CSS 格式的外觀。
scripts/build.py 會驗證它們並轉換成一個自含的 HTML 檔案,內含播放器。
每個場景是一個以 2 到 4 個步驟講述的想法。左側為步驟卡,右側為該場景的動畫插圖:主題的真實物件,自帶專屬的編排,隨著每個步驟流暢前進,並擁有自己的生命力(漂浮、流動、脈動)。也可以是一張會放大並加上標籤的截圖或照片。讓每個場景看起來與動起來各不相同,正是 Cerulean 簡報的優異之處。
每場簡報還擁有專屬的視覺識別,由你為該主題設計:它所存在的世界(其物件)、色板、字型、背景節奏以及為它完整撰寫的 CSS 外觀。一場關於安全的簡報看起來像一台終端機;一場歷史簡報則像一份古舊印刷品。兩個不同的主題不該看起來來自同一個系列;遮住標題,就應該猜得到內容主題。
流程
-
理解委託。 你需要主題、內容(筆記、要點、貼上的文字),以及任何圖片。若只有主題,則運用廣為人知的常識來發展內容。不要為了索取圖片而中斷流程:若有遺漏的圖片,先預留空間。預設:西班牙文,5 到 9 個場景。
-
閱讀指南一次。 閱讀
references/direccion.md(視覺識別)、references/formato.md(JSON 格式)與references/escenas.md(動畫套件、時間與依想法類型分類的動畫目錄)。assets/ejemplo.js有 7 個完整場景:只有在不確定如何解決某個問題時才讀取它。 -
設計視覺識別,依照
direccion.md的流程:主題的世界(它存在於何處,以及 6 到 10 個可辨識的物件)、情緒、從該場景提取的色板、該世界會使用的字型、節奏與動態,每一項都附帶why行說明。通過通用性測試:遮住標題,猜得出主題嗎? -
撰寫腳本,存放於
presentaciones/<theme>.json:文字、步驟、筆記與design區塊。若資料夾不存在則建立它。根據節奏分配「背景」與「紙張」。 -
撰寫外觀,存放於
presentaciones/<theme>.css:卡片、封面、標題、標籤、細節與輸入框,應如同在該世界中呈現的樣子(哪些可以裝飾、哪些不行,詳見direccion.md)。 -
規劃場景(在撰寫程式碼之前):每個場景說明了哪種想法類型(
idea)、用主題世界中的一個物件來描述其隱喻(form一句話)、以及每個步驟會改變什麼。至少使用 3 種想法類型,且不重複使用隱喻。僅對使用者實際想要展示的真實事物(如他們的應用程式、產品、地點)使用圖片。 -
撰寫場景程式碼,存放於
presentaciones/<theme>.js(scene("name", (K) => {…})),並在 JSON 中加入其"draw"。每個場景 20 到 60 行程式碼。繪製世界的工件,預設為平面視角(詳見escenas.md)。 -
生成與審閱:
python "<此技能的資料夾路徑>/scripts/build.py" presentaciones/<theme>.json這會寫入
presentaciones/<theme>.html。修正警告(無對應場景的名稱、語法錯誤、遺漏的圖片、不完整的視覺方向、被拒絕的外觀、缺乏多樣性、與先前簡報相似)。若有瀏覽器,無需耗費截圖即可審閱:- 啟動預覽伺服器:
python "<此技能的資料夾路徑>/scripts/preview.py" presentaciones/<theme>.json(背景執行),然後開啟 http://localhost:8767。 - 在頁面上執行
JSON.stringify(CERULEAN_REPORT())。它會報告哪些場景有錯誤、哪些部件超出畫布、哪些步驟沒有變化,以及哪些文字在外觀下可讀性不佳(legibility)。修正後重新執行;頁面會自動重新載入。 - 只對總覽頁(按鈕「全部」或按鍵 G)進行一次截圖,以評估整體:視覺識別是否明顯(顏色、字體、繪圖風格),以及場景之間是否不相似。不要逐步驟截圖:這是最耗費時間與 token 的操作。
- 啟動預覽伺服器:
-
交付。 提供 HTML 的路徑,並用幾行文字說明使用方式:
- → 或空白鍵前進,← 後退。
- F 全螢幕,N 顯示筆記,G 總覽。
- E 編輯模式:修正文字、拖曳圖片,以及移動或調整卡片與插圖的大小(使用手柄 ✥ 與 ⤡)。「下載副本」會儲存包含修改的 HTML。
- PDF 按鈕會將簡報儲存為每頁一個場景的 PDF。
若仍有遺漏的圖片,最後附上清單:場景、應顯示的內容,以及檔名
presentaciones/imagenes/scene-<n>.png。
不可妥協的規則
- 不要捏造數字、日期、引言、姓名或研究。場景中出現的數字必須來自內容或廣為人知的常識,而且也應出現在步驟的文字中。
- 不要使用虛構或任意的圖片來取代真實但遺漏的圖片:應保留預留空間。
- 每個場景都有專屬的插圖與核心編排,並在每個步驟中變化。
- 每場簡報都有專為其主題設計的視覺識別:其世界、色板、字型與外觀。色板、字型與預設外觀不是可隨意選擇的。
- 絕對不要為了某個特定的簡報而編輯
assets/目錄:播放器與動畫套件是所有簡報共用的。