編寫程式碼研究室
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
簡介
程式碼研究室是以 Markdown 語法編寫的互動式教學課程。我們會在 blocklycodelabs.dev 發布程式碼研究室。程式碼研究室會混合使用自然語言、程式碼範例和螢幕截圖，打造更有趣的教學課程體驗。程式碼研究室的目標使用者是跟著閱讀並執行程式碼。
撰寫程式碼研究室是貢獻社群的絕佳方式。這有助於分享知識，讓遇到相同問題的開發人員輕鬆解決。
如何製作優質程式碼研究室？
優秀的程式碼研究室應著重於特定主題，且容易閱讀。清楚說明使用者將建構的內容和學習的知識，並逐步引導使用者編寫及瞭解程式碼，以完成特定工作。
程序
如果您對程式碼研究室有任何想法，可以在 blockly-samples 存放區中提出功能要求。請說明您想教導的內容，以及在程式碼研究室中建構的內容。我們會討論並修正這個想法。
然後撰寫並提交提取要求。通過審查後，Blockly 團隊成員就會發布。
書寫提示
本頁其餘部分提供一系列提示和問題，引導您撰寫程式碼研究室。
如要快速瞭解技術寫作，請參閱技術寫作。
觀眾
- 目標讀者是誰？
- 他們對使用 Blockly 的瞭解程度如何？
- 他們想學習什麼？
設定
如有需要，您可以在 examples 目錄中發布範例程式碼和完成的程式碼。
結構
如同撰寫任何文章，請先擬定大綱。大多數程式碼實驗室都適合採用這種結構：
- 簡介
- 步驟一：[在此輸入標題]
- 說明/動機
- 程式碼範例
- 預期結果
- (選用) 更多說明
- ...
- 步驟十：[在這裡輸入標題]
- 摘要
- 您學到的內容
- 您建構的內容
- 其他資源
- 完成的程式碼連結 (如有)
雖然步驟可以超過十個，但如果達到二十個，建議您將其分成兩個程式碼研究室。
寫作風格
- 使用對話式寫作風格。
- 使用標題清楚劃分內容。
- 使用項目符號清單，將大段文字分開。
- 使用圖片和 GIF！
程式碼樣式
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-09-30 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-09-30 (世界標準時間)。"],[],["Codelabs, interactive markdown tutorials, are published at blocklycodelabs.dev. To contribute, submit a feature request in the blockly-samples repository with the codelab's content and build. After discussion and refinement, write the codelab and submit a pull request for review and publication. Structure includes an introduction, step-by-step instructions with code samples, and a summary. Focus on a conversational, clear writing style with headings, lists, and visuals, following Google's code style guide.\n"]]
