スキル

Slidev:公式スキャフォールドで開発者向けスライドを作る

開発者向けのスライドプロジェクトをローカルで始めたい人向け。主経路は npm init slidev。Node.js >= 20.12.0 が必要。実行前に書き込み先ディレクトリを確認する。

公式ソース · Slidev

インストール

npm init slidev

誰向けか

開発者向けの発表資料を作り、公式スキャフォールドでローカルにスライドプロジェクトをすぐ始めたいときに、このスキルが合う。位置づけは開発者向けのプレゼンテーションスライド。公式のローカル主経路は1本だけ。先に Node.js >= 20.12.0 を満たし、それから npm init slidev を実行する。材料にはオンライン入口とエディタ説明もあるが、ローカル初期化と並べて置き換え可能な主経路にしない。Node が 20.12.0 未満、またはこのマシンでプロジェクトを生成するつもりがないなら、初期化を走らせない。

すでに Node を実行でき、プレビューできるスライドプロジェクトだけが足りない人向け。要求バージョンまで入っておらず、先にテーマや拡張を変えたい人には向かない。エディタ面では、材料は統合エディタ、または VSCode 拡張に触れている。それは編集面であり、2つ目のインストーラではない。発表のアウトラインがなくても初期化はできるが、スキャフォールドが完成原稿を書いてくれるとは期待しない。

3分で最初の試行

公式インストールコマンドはこの1本だけ:

npm init slidev

前提条件:先に Node.js >= 20.12.0 を確認する。Node の入手ページは

https://nodejs.org/

この回は新しいプロジェクトを1つ初期化するだけ。公開せず、主経路として書かれていないオンライン入口にもつなげない。

インストール先は、npm init が作るそのローカルディレクトリ。実行前にアシスタントへ目標ディレクトリと Node バージョンを復唱させ、確認してから走らせる。ディスクに書き込むため。

成功の合図:ローカルに新しいスライドプロジェクトが現れ、スキャフォールド自身の案内でプレビューを開けること。コマンドが失敗したら、先に Node バージョンを照合する。主経路ではないオンライン作成に切り替えない。材料にデフォルトテーマ名や PDF 書き出し手順はない。初期化がプロジェクト名を尋ねたら空のディレクトリを使い、既存ファイルを上書きしない。

使用例

例1:ローカルに開発者向けデッキを新規作成する。Node バージョンを確認したあと公式初期化を実行し、プロジェクトを1つだけ生成してトップが出るか見る。根拠は npm init slidev まで。質問項目やテンプレート一覧はない。それを超える部分は「初期化して開ける」層で止める。一度に初期化するディレクトリは1つだけ。

例2:統合エディタまたは VSCode 拡張でスライドを直す。プロジェクトが立ち上がったあと、材料が名指しした編集面で1ページを変える。根拠は integrated editor と VSCode extension まで。拡張マーケットの番号もショートカットもない。エディタ導入を別のプロジェクトスキャフォールドと読まない。ページを変える前に、今初期化したそのプロジェクトを直していることを確認する。先に見出し1つか説明1段落を変え、プレビューが追随することを確認してから、さらにページを足す。

利用の境界

ローカル主経路は npm init slidev だけであり、Node.js >= 20.12.0 が必要。材料にはオンラインアドレスも出る。

https://sli.dev/new

それは今回推奨の主経路ではない。npm init と並べない。エディタ文書はそれぞれ次を指す。

https://sli.dev/guide/index#editor

https://sli.dev/features/vscode-extension

それらは編集面だけを説明する。初回は初期化とプレビューで止める。書かれていないインストーラを捏造せず、ディレクトリ未確認のまま init を繰り返さない。Node バージョンが足りなければ、先にランタイム要件で止める。書かれていない古いコマンドへ下げない。