🎃

WSL環境設定(AsciiDocとvscode-pdf)

に公開

🔧 手順:WSL2 で AsciiDoc + vscode-pdf 環境構築

✅ ステップ 0: WSL2 のインストール(済ならスキップ)

PowerShell(管理者)で実行:

wsl --install
  • デフォルトで WSL2 が入ります。
  • 再起動後、Ubuntu を選んでセットアップ。

WSL バージョン確認:

wsl -l -v

Ubuntu が WSL2 になっているか確認(VERSION が 2 ならOK)。


✅ ステップ 1: WSL2 (Ubuntu) に入る

wsl

✅ ステップ 2: AsciiDoc 環境をインストール(WSL2 内)

sudo apt update
sudo apt install asciidoc

もしくは asciidoctor を使いたい場合は:

sudo apt install ruby ruby-dev build-essential
sudo gem install asciidoctor asciidoctor-pdf

これで .adoc → .pdf 変換可能になります。


✅ ステップ 3: VSCode を WSL2 と連携

  1. VSCode を起動
  2. 拡張機能「Remote - WSL」をインストール
  3. コマンドパレット(Ctrl+Shift+P) → Remote-WSL: New Window
  4. WSL2 上のフォルダを開く(例:\\wsl$\Ubuntu\home\ユーザー名\projects\asciidoc-test

✅ ステップ 4: vscode-pdf をインストール

VSCode の拡張機能から vscode-pdf を検索&インストール(作者: tomoki1207 など)。


✅ ステップ 5: AsciiDoc を PDF に変換(WSL2 内)

asciidoctor-pdf yourfile.adoc

PDF ファイルが同じディレクトリに出力されます。
VSCode で開けば vscode-pdf がプレビュー表示してくれます。


Discussion