コンテンツ オーサリング ツールのインストール

この記事では、Git クライアント ツールと Visual Studio Code を対話形式でインストールする手順について説明します。

• Git
• Visual Studio Code をインストールします
• Learn Authoring Pack をインストールする

重要

記事に軽微な変更しか加えていない場合は、この記事の手順を実行する必要はないため、直接簡易な変更のワークフローに進めます。

大規模な変更を行う共同作成者は、これらの手順を行うことをお勧めします。そうすることで、大規模または長期間の変更のワークフローを使用できるようになります。 メイン リポジトリで書き込みアクセス許可を持っている場合でも、"リポジトリのフォークと複製を行うことを強くお勧めします (本ガイドでもそれを前提としています)"。それにより、予定している変更をフォークに保存するための読み取り/書き込み権限が付与されます。

Git クライアント ツールのインストール

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

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

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

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

3. プロンプトが表示されたら、コード エディターを選択します。 既定のコード エディターは Vim で、まだ使い慣れていない場合は使いにくいです。 既定のコード エディターを変更するには、「 エディターを設定する」を参照してください。

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

   

Git for Windows をインストールした後、Visual Studio Code をインストールする前に、Git 名とメール アドレスを構成する必要があります。

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

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

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

次の記事では、ローカル Git リポジトリを設定します。

Git の追加のリソースは、Git 用語集 | Git の基礎 | Git および GitHub の学習にあります

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

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

ヒント

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

Windows、Mac、Linux 用 Visual Studio Code をインストールする

• Windows。 VS Code のホーム ページでは、オペレーティング システムが正しく検出されます。
• Mac
• Linux

Visual Studio Code 拡張機能をインストールする

この拡張機能をインストールするには:

1. Visual Studio Code を開始します。

2. 左のナビゲーションで、四角形の [拡張機能] アイコンを選択します。 [拡張機能: Marketplace] ペインが表示されます。

3. [Marketplace で拡張機能を検索する] 検索ボックスに、見つけたい拡張機能の名前を入力します。

   

4. 表示される結果で、目的の拡張機能を見つけて、[インストール] を選択します。

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

重要

Visual Studio Code 用 Learn Authoring Pack には、基本的な Markdown 作成の支援、ページ プレビュー、Markdown テンプレートのサポート、マークダウン、コードスペル チェックが含まれています。 これらの機能を使用することにより、投稿プロセスを容易にし、合理化できます。 そのため、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 を追加します。

詳細については、「 Learn Authoring Pack for Visual Studio Code」を参照してください。

Markdown エディターについて

Markdown は、コンテンツの作成に使用される簡易マークアップ言語です。 Visual Studio Code は、Markdown を編集するために Microsoft が推奨しているツールです。 その他の Markdown 編集ツールを使用できます。 Markdown リファレンスの記事では、Markdown の基本と、Open Publishing Services (OPS) カスタム Markdown 拡張機能でサポートされる機能について説明します。

次のステップ

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