代码片段提取器会接收学生的提交内容,并从中提取出前 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 语言自定义了代码片段提取。