解說影片
從儲存庫根目錄使用 uv run 操作。README.md 包含指令和檔案格式;EDITORIAL.md 是標準流程。以下是工作的順序,以及使用者的檢核點所在。
0. 對話,影片的起點
影片源自於所有者(owner)經過檢驗的想法,而非來自主題列表。在進行任何研究之前,先與他們訪談。
- 一次只問一兩個問題,以簡單對話的形式進行,並且簡短:所有者會透過聽寫回答,一次問五個問題會太多,難以回答或理清。在幾輪對話中,混合不同類型的問題:開放式問題(「每一方在保護什麼?」)、小測驗(他們在你自己查答案之前先猜測,例如「你猜會佔多少比例?」)、鋼鐵人測試(「把另一方的論點表達得連他們都會同意」),以及誘餌:對他們剛才所說的話提出最強烈的反對意見,直接了當。跟隨那個讓你驚訝的回答,而不是列表上的下一個問題。
- 所有者錯誤的猜測可以出現在螢幕上:他們已經同意了。但是,一個數字只有在他們主動提出作為猜測時,才算是他們的猜測。在例子中的數字(例如「假設他們把 70% 花在帳單上……」)是說明用的:將其記錄為說明,切勿將其計分或作為猜測顯示,並且在不清楚是哪種情況時提問。
- 聆聽回答底下的主張:一個可能是錯誤的論點、他們不斷做出的區別、他們自己的故事。這些就是影片的題材。一個主題(例如「墮胎」)不是一個想法;「雙方在回答不同的問題」才是一個想法。
- 保留他們的用詞。將回答逐字記錄並標註日期,存放到
notes/<topic>.md中,該檔案已被 git 忽略:這些筆記是原始且私密的,而腳本才是公開的形式。將你自己的摘要標記為你的。 - 根據腳本將會需要的內容來分類他們所說的話。可以查證的內容會變成研究,然後成為「事實」、「估計」或「觀點」拍子(beats)。屬於他們的內容則成為「意見」或「猜測」。在他們進一步討論之前,先釐清帶有情緒的詞彙(例如「被設計的」:由誰設計,以及我們如何知道?),並且當資料來源不支持他們所相信的某些事情時,清楚地告訴他們。
- 當有一個論點、三到四個支持它的論點轉折,以及對它最強烈的反對意見時,就可以停下來。用幾句話回放給他們聽,並且在進行研究之前獲得他們的同意。
所有者想要了解事物目前的運作方式。事物的來源只是影片中的一個簡短旁白,而非影片的主體。
1. 研究,在任何腳本之前
- 用一句話確定影片要回答的問題,以及觀眾在觀看後應該能夠說出的三到四件事情。
- 建立事實清單:每行一個主張,每個主張都附有在此工作階段中擷取並閱讀過的來源,以及支持該主張的段落。從第一天起就將來源保存在
videos/NAME/sources.toml中(只有該檔案的資料夾代表一個正在研究或擱置中的影片),並將主張保存在notes/NAME.md中。在子代理程式中進行研究是可以的,但要指示它回傳逐字引述,並標記它無法證實的內容;絕不要接受它沒有開啟過的 URL。 - 對於有爭議的主題,從每個陣營最有力的倡導者那裡收集他們的論點,並注意哪些分歧是關於事實的,哪些是關於價值的。
- 記錄下來哪些是資料來源不支持的。一個故事的流行版本通常比證據本身更整潔。
2. 腳本(檢核點:使用者批准)
python -m explainers.new NAME(它會根據已有的sources.toml填入內容),然後編輯script.md。- 一部影片長度約 12 到 25 分鐘:以所有者的閱讀速度(大約每分鐘 175 個字,含停頓)約為 2,100 到 4,400 個字。為影片劃分章節,讓觀眾能感受到轉折,每個章節都有自己的問題。
- 一個拍子一個想法,一個拍子一口氣:15 到 40 個字。為聽覺而寫:短句,重要的詞放在最後,數字取整到聽眾能記住的範圍,沒有括號或縮寫。
- 以問題或驚喜開場,而不是以問候語開場。每個章節都應該讓觀眾期待下一個章節。
- 根據句子承諾的內容來標籤,而不是根據你的確定程度。將混合不同類型的拍子拆分。一個大部分是「事實」和「觀點」並帶有幾個清楚標記的「意見」拍子的腳本是目標;
check指令會印出各種標籤的比例。 - 不要自己撰寫頻道對於有爭議問題的「意見」。留下一個標記好的空白,或者起草一個版本並清楚說明這是一個草稿,供使用者接受、修改或刪除。
- 在每個章節下方加上一個
>註解,說明畫面上應該顯示什麼。每個拍子都需要一張圖片,並且至少每五秒左右更換一次。 python -m explainers.check videos/NAME --urls必須通過。向使用者展示帶有標籤分佈和來源列表的腳本。
3. 配音(檢核點:使用者錄製)
- 使用合成語音起草:
python -m explainers.narrate videos/NAME。修正say.txt中它猜錯的字詞。當一個拍子的圖片需要時間來呈現時,在該拍子加上pause。圖片可以在這個草稿階段建構,腳本也可以在此時定稿。 - 當文字定稿後,使用者在自己專屬的終端機中錄製:
python -m explainers.record videos/NAME會顯示每個拍子,錄製它,並檢查錄音的音量水準和是否符合腳本的文字。--room參數會先錄製一次空房間的背景音,用於填充間隙。然後再次執行narrate:它會在有任何新錄音的地方使用該錄音。圖片會保持在它們對應的文字上,因為提示點(cues)是根據單字來查詢的,但拍子的長度可能會改變:在渲染之前,執行sweep並檢視聯絡表(contact sheet)。 - 使用者不必逐字照稿唸。當錄音偏離腳本時,
record會顯示差異,如果使用者保留了偏離的內容,它會將script.md中的該拍子改寫成他們實際說的話。因此,在使用者錄音之前先提交腳本,之後再閱讀git diff來查看變更:整理新詞彙的拼寫和標點符號(這不會使錄音失效),並且對於每個被更改的「事實」、「估計」或「觀點」拍子,都要將來源的引述對照新詞彙重新閱讀。如果新的詞彙不再能支持該來源,請告訴使用者:該拍子需要重新錄製或重新標籤,不能留著不處理。 - 你自己改寫一個已錄製的拍子會導致使用者需要重新錄製。將這類修改批次處理並先徵求同意。
--audition VOICE ...可以比較不同的合成語音用於草稿;腳本中的voice:行會選定一個。
4. 圖片
- 從模板中的
video.py開始,逐個場景替換它。通常一個章節一個場景;使用theme.scenes在場景之間切換。 - 影片發生在一個場景(
explainers/sets.py中定義):目前是一個帶有投影螢幕的教室,這是所有者要求的。將圖表、卡片或圖形繪製成投影片,一個 1920x1080 的圖片,然後交給場景:同一張投影片在廣角鏡頭中會顯示在螢幕上,當攝影機拉近時則填滿整個畫面(鏡頭移動方式請參考sets.shots)。當投影片需要被閱讀時就拉近,當主持人有事情要做時就拉遠,當主持人走上前發表意見時就調暗投影機(使用on)。將章節標題寫在黑板上(使用chalk),並為標籤提供一個名牌(plate),使其在房間中清晰可讀。腳本中的>註記會說明是「廣角」還是「投影機」。未來會加入其他場景:保持投影片不包含房間背景。 - 每個鏡頭移動都掛鉤在一個提示點上:
N.at(beat, word)。切勿直接輸入以秒為單位的時間。 - 在解釋某些事物時,主持人要縮小並靠邊站;當要表達自身觀點時(開場、意見、結尾),主持人則要放大。主持人要看著並指向正在討論的事物。
- 圖表、圖形和任何數學內容都放在 manim 的
Insert中。其他所有內容則使用 Skia。 - 爭論的雙方分別是
theme.SIDE_A/theme.SIDE_B。圖表所使用的資料集需要保存在影片的data/資料夾中,並記錄其來源和時間。 - 迭代循環:
preview一個章節,查看結果,修正,重複;在每次渲染之前執行sweep。
5. 渲染與交付(檢核點:使用者觀看)
python -m explainers.render videos/NAME --fresh,然後執行python -m explainers.describe videos/NAME。- 報告哪些內容已經過事實查核、哪些尚未查核、任何標籤是基於判斷決定的拍子,以及配音聽起來任何不自然的的地方。