次の方法で共有

開発言語の完了

  • [アーティクル]

拡張機能の名前

Learn Authoring Pack、Visual Studio Code メタ拡張機能は、複数のサブ拡張機能で構成されています。 この機能は、 Learn Markdown 拡張機能に含まれています。 Learn Markdown 拡張機能は Learn Authoring Pack の一部であり、個別にインストールする必要はありません。

まとめ

共同作成者は、Markdown ファイルでトリプルバッククォート (コード フェンスの始まり) の後に続けることができる有効な言語識別子 (開発言語) を決定するための支援を必要とします。 残念ながら、開発言語のビルド時検証機能はありません。 その結果、同じ概念 docset 内で単一の言語が異なって表現されています。

例として、C# について考えてみましょう。 共同作成者は、言語の開発言語表現として c#、C#、cs、csharp を使用しています。 これらの表現のうち、正しいのはどれでしょうか?

"開発言語の完了" 機能は、既知の dev lang の一覧を表示することにより、混乱を解消します。 IntelliSense から開発言語名を選択すると、次のようになります。

  • コード フェンスは閉じられます。
  • カレットは、コード フェンス内に配置されます。

Preferences

この機能を無効にすることはできません。 次の設定を使用できます。

一般的に使用されている開発言語を表示する

単一の docset で、有効な開発言語のサブセットのみが使用されます。 ユーザー エクスペリエンスを向上するには、次の操作を行います。

  1. Visual Studio Code で、ルート ディレクトリに相対的な docset を開きます。

  2. [ ファイル>設定]>を選択 し、[ Learn Markdown Extension] でフィルター処理します。

  3. [Markdown: Docset Languages](Markdown: docset の言語) セクションの [settings.json で編集] リンクをクリックします。

  4. 次の markdown.docsetLanguages プロパティを "settings.json" ファイルに追加します。

    {
    "markdown.docsetLanguages": [

    ]
}

  5. プロパティの空の配列にカレットを位置付け、IntelliSense をアクティブにします (Ctrl + Space キーを押します)。 既知の開発言語名の一覧が表示されます。

  6. 満足できる一覧になるまで、開発言語名を配列に追加します。 たとえば、次の一覧では、ユーザーがトリプルクォートを入力した後、4 つの開発言語が表示されます。

    {
    "markdown.docsetLanguages": [
        ".NET Core CLI",
        "C#",
        "Markdown",
        "YAML"
    ]
}

  7. "settings.json" ファイルの変更を保存します。

警告

markdown.docsetLanguages 配列が空の場合、既知のすべての開発言語が表示されます。

既知のすべての開発言語を表示する

既定では、既知のすべての開発言語名が IntelliSense に表示されます。 この設定は、「一般的に使用されている開発言語を表示する」で説明した markdown.docsetLanguages プロパティをオーバーライドします。

この設定を変更するには:

  1. [ ファイル>設定]>を選択 し、[ Learn Markdown Extension] でフィルター処理します。
  2. [Markdown: All Available Languages](Markdown: 使用可能なすべての言語) セクションの設定を切り替えます。

操作の実例

この機能の簡単なデモンストレーションを以下に示します。

開発言語の完了