コンテンツ オーサリング ツールをインストールする
この記事では、Microsoft Learn に対して効率的な詳細または大規模なコントリビューションを行うために必要な推奨ツールをインストールする方法について説明します。 主な更新プログラムの例を次に示します。
- 複数の記事に対する長いリビジョン
- 新しい記事の作成
- Learn Authoring Pack など 、使用可能な Visual Studio Code 拡張機能を使用する作業を行います。
重要
軽微な変更しか加えていない場合は、この記事の手順を完了する必要はありません。 ツールをインストールせずに簡単に編集する方法については、「ブラウザーでの編集」を参照してください。
大きな変更を加える共同作成者には、これらの手順を完了することをお勧めします。 メイン リポジトリで書き込みアクセス許可を持っている場合でも、リポジトリのフォークと複製を行い (本ガイドでもそれを前提としています)、予定している変更をフォークに保存することを強くお勧めします。
この記事では、次のことを行います。
- Git
- Visual Studio Code をインストールします
- Learn Authoring パックをインストールします
Windows 用 Git クライアント ツールをインストールする
このインストールには、Git バージョン管理システムや、ローカル Git リポジトリとの対話で使用するコマンドライン アプリである Git Bash が含まれます。
Git for Windows をダウンロードします。
ダウンロードした実行可能ファイル (.EXE) を実行し、画面の指示に従ってインストールします。 各プロンプトで [次へ] を選択して、すべての既定の設定を受け入れます。
メッセージが表示されたら、コード エディターを選択します。 既定のエディターは Vim です。
[完了] を選択してインストールを完了します。
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 リポジトリを設定する準備が整いました。