Der Snippet Extractor nimmt die Einsendung eines Lernenden und extrahiert daraus die ersten zehn „interessanten“ Codezeilen. Das extrahierte Snippet wird auf verschiedenen Seiten der Website angezeigt.
Standardmäßig werden die ersten zehn Zeilen angezeigt, wobei führende leere Zeilen ignoriert werden. Diese ersten zehn Zeilen könnten Dinge wie Kommentare enthalten, die in einem Snippet normalerweise nicht ideal sind.
Wir empfehlen jedem Track, die Snippet-Extraktion anzupassen, um zumindest Kommentare aus dem Quellcode zu entfernen. Um die Snippet-Extraktion anzupassen, musst du:
Eine Datei lib/languages/<track_slug>.txt hinzufügen, die die Snippet-Extraktion konfiguriert.
Diese Datei kann entweder den Basic-Modus oder den Extended-Modus verwenden.
Die meisten Tracks verwenden den Extended-Modus, da er mehr Flexibilität bietet.
Einen oder mehrere Testfälle zu einem Verzeichnis tests/<track_slug>/<test_slug> hinzufügen.
Jedes Testverzeichnis braucht zwei Dateien:
tests/<track_slug>/<test_slug>/code.<track_extension>: der Code, auf dem der Snippet-Extractor ausgeführt wirdtests/<track_slug>/<test_slug>/expected_snippet.<track_extension>: das erwartete SnippetSieh dir diesen Beispiel-Pull-Request an, der die Snippet-Extraktion für die Sprache Arturo anpasst.