コンテンツ オーサリング ツールをインストールする

  • [アーティクル]

この記事では、Microsoft Learn に対して効率的な詳細または大規模なコントリビューションを行うために必要な推奨ツールをインストールする方法について説明します。 主な更新プログラムの例を次に示します。

  • 複数の記事に対する長いリビジョン
  • 新しい記事の作成
  • Learn Authoring Pack など 、使用可能な Visual Studio Code 拡張機能を使用する作業を行います。

重要

軽微な変更しか加えていない場合は、この記事の手順を完了する必要はありません。 ツールをインストールせずに簡単に編集する方法については、「ブラウザーでの編集」を参照してください。

大きな変更を加える共同作成者には、これらの手順を完了することをお勧めします。 メイン リポジトリで書き込みアクセス許可を持っている場合でも、リポジトリのフォークと複製を行い (本ガイドでもそれを前提としています)、予定している変更をフォークに保存することを強くお勧めします。

この記事では、次のことを行います。

Windows 用 Git クライアント ツールをインストールする

このインストールには、Git バージョン管理システムや、ローカル Git リポジトリとの対話で使用するコマンドライン アプリである Git Bash が含まれます。

  1. Git for Windows をダウンロードします。

  2. ダウンロードした実行可能ファイル (.EXE) を実行し、画面の指示に従ってインストールします。 各プロンプトで [次へ] を選択して、すべての既定の設定を受け入れます。

  3. メッセージが表示されたら、コード エディターを選択します。 既定のエディターは Vim です。

  4. [完了] を選択してインストールを完了します。

Git for Windows をインストールした後、Git 名とメール アドレスを構成します。

Mac および Linux 用 Git クライアント ツールをインストールする

  • Mac 用の Git は Xcode コマンド ライン ツールの一部として提供されます。 コマンド ラインから単純に git を実行します。 必要に応じて、コマンド ライン ツールのインストールを求められます。 また、Software Freedom Conservancy から Mac 用の Git をダウンロードすることもできます。
  • Linux と Unix 用の Git

選択したクライアントについてインストールと構成の手順に従います。

Visual Studio Code をインストールする

Visual Studio Code は Windows、Linux、Mac で動作する軽量のエディターです。 これには、Git 統合と拡張機能のサポートが含まれています。

お使いのオペレーティング システム用の Visual Studio Code をダウンロードしてインストールします。

インストール時は、すべての既定の設定を受け入れます。

ヒント

VS Code を起動し、現在のフォルダーを開き、コマンド ラインまたは Bash シェルで code . コマンドを実行します。 現在のフォルダーがローカル Git リポジトリの一部である場合は、GitHub 統合が Visual Studio Code に自動的に表示されます。

Learn Authoring Pack をインストールする

Visual Studio Code 用 Learn Authoring Pack には、基本的な Markdown 作成サポート、ページ プレビュー、Markdown テンプレートのサポート、markdownlint、および Code Spell Checker が含まれています。 これらの機能を使用することにより、投稿プロセスを容易にし、合理化できます。 そのため、Learn Authoring Pack は共同作成者にとって必須の拡張機能と見なされます。

Learn Authoring Pack をインストールするには、VS Code Marketplace の Learn Authoring Pack ページから [インストール] を選択します。

Learn Authoring Pack の機能を使用するには、Visual Studio Code で Alt+M を押します。 使用可能な機能がツール バーに表示されるように構成するには、Visual Studio Code の設定を編集 (Ctrl + コンマ) して、ユーザー設定 "markdown.showToolbar": true を追加します。

詳細については、Visual Studio Code 用 Learn Authoring Pack に関するページを参照してください。

Markdown エディターについて

Markdown は、コンテンツの作成に使用される簡易マークアップ言語です。 Visual Studio Code は、Markdown を編集するために Microsoft が推奨しているツールです。 その他の Markdown 編集ツールを使用できます。 Markdown リファレンス記事では、Markdown の基本と、learn.microsoft.com Web サイトでサポートされている機能について説明します。

次のステップ

これで、ローカル Git リポジトリを設定する準備が整いました。