🎃
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 と連携
- VSCode を起動
- 拡張機能「Remote - WSL」をインストール
- コマンドパレット(
Ctrl+Shift+P) →Remote-WSL: New Window - 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