程式碼片段擷取器會接收學生的提交內容,並從中擷取前 10 行「有趣」的程式碼。 擷取出來的片段會顯示在網站上的各個頁面。
預設會顯示前 10 行,並忽略開頭的空行。 這前 10 行可能包含註解之類的內容,而這類內容通常不適合出現在程式碼片段中。
我們建議每個軌道都自訂程式碼片段擷取,至少要把註解從原始碼中移除。 如要自訂程式碼片段擷取,你需要:
新增一個lib/languages/<track_slug>.txt檔案,用來設定程式碼片段擷取。
這個檔案可以使用基本模式或擴充模式。
大多數軌道都使用擴充模式,因為它更有彈性。
在tests/<track_slug>/<test_slug>目錄中新增一個或多個測試案例。
每個測試目錄都需要兩個檔案:
tests/<track_slug>/<test_slug>/code.<track_extension>:要讓程式碼片段擷取器處理的程式碼tests/<track_slug>/<test_slug>/expected_snippet.<track_extension>:預期的片段請參考這個範例 Pull Request,它為 Arturo 語言自訂了程式碼片段擷取。