* New Crowdin translations by Github Action * Reset broken translated files to English * Ran script/i18n/homogenize-frontmatter.js * Ran script/fix-translation-errors.js * Reverted translated files with parsing and rendering errors * fix malformed liquid * add next directory to exclude list * currentversion -> currentVersion * fix liquid errors * fix liquid errors * Reset broken translated files to English * Ran script/i18n/homogenize-frontmatter.js * Revert /ja/github/authenticating-to-github/about-authentication-with-saml-single-sign-on * Reset known broken translation files LAST * Run script/i18n/homogenize-frontmatter.js Co-authored-by: Crowdin Bot <support+bot@crowdin.com> Co-authored-by: Rachael Sewell <rachmari@github.com> Co-authored-by: Kevin Heis <heiskr@users.noreply.github.com>
学習トラック (別名 学習パス)
学習トラックは、特定のテーマをマスターするのに役立つ記事の集まりです。 学習トラックは製品ごとに定義されています。 例としてhttps://docs.github.com/ja/actions/guidesを参照してください。
製品の学習トラックのデータは2カ所で定義されています:
-
学習トラック名のシンプルな配列は、製品のサブランディングの索引ページの前付けで定義されています。
たとえば
content/actions/guides/index.mdでは以下のようになっています:learningTracks: - getting_started - continuous_integration - continuous_deployment - deploy_to_the_cloud - hosting_your_own_runners - create_actions -
各トラックの追加データは、
dataディレクトリ中のproductの名前のYAMLファイルで定義されています。たとえば
data/learning-tracks/actions.ymlでは、コンテンツファイルのlearningTracks配列の各アイテムは、titleやdescription、guidesリンクの配列といった追加データとともに表現されています。バージョンごとにこのYAML中の1つの学習トラックを、
featured_track: trueを通じて「注目の」学習トラックとして指定する必要があります。これは、製品のサブランディングページの上部に表示されるように設定されます。 このプロパティがないと、テストは失敗します。featured_trackプロパティは、シンプルな論理値(すなわちfeatured_track: true)もしくは、バージョン付けの宣言を含む文字列( たとえばfeatured_track: '{% if currentVersion == "free-pro-team@latest" %}true{% else %}false{% endif %}')とすることができます。 バージョン付けを使用するなら、YMLファイルごとに複数のfeatured_trackを持つことになりますが、必ず現在サポートされている各バージョンごとに1つだけがレンダリングされるようにしてください。 各バージョンに対して注目のリンクが1つより多くても少なくてもテストは失敗します。
学習トラックのバージョン付けは、ページのレンダリングの時点で処理されます。 コードはlib/learning-tracks.jsにあり、これはpage.render()によって呼ばれます。 そして処理された学習トラックは、layouts/product-sublanding.htmlによってレンダリングされます。
学習トラックのYAMLを検証するためのスキーマはtests/helpers/schemas/learning-tracks-schema.jsにあり、tests/content/lint-files.jsによって実行されます。