スニペット抽出ツール

Snippet Extractorは、学習者の解答を受け取り、その中から「興味深い」コードを最初の10行だけ抽出します。 抽出されたスニペットは、ウェブサイトのさまざまなページに表示されます。

デフォルトでは、先頭の空行を無視して、最初の10行が表示されます。 この最初の10行には、コメントなどが_含まれることもあります_。コメントは通常、スニペットに表示するのにあまり向いていません。

スニペット抽出をカスタマイズする

各トラックでスニペット抽出をカスタマイズして、少なくともソースコードからコメントを削除することをおすすめします。 スニペット抽出をカスタマイズするには、次のことを行う必要があります。

1. スニペット抽出を設定するlib/languages/<track_slug>.txtファイルを追加します。 このファイルでは、基本モードか拡張モードのどちらかを使えます。 ほとんどのトラックは、より柔軟に設定できる拡張モードを使っています。

2. tests/<track_slug>/<test_slug>ディレクトリに、1つ以上のテストケースを追加します。 各テストディレクトリには2つのファイルが必要です。

   1. tests/<track_slug>/<test_slug>/code.<track_extension>: スニペット抽出の対象となるコード
   2. tests/<track_slug>/<test_slug>/expected_snippet.<track_extension>: 期待されるスニペット

Arturo言語向けにスニペット抽出をカスタマイズしたこちらのプルリクエストの例を参照してください。