はじめに
AsciiDoc Zero-Network Preview
https://marketplace.visualstudio.com/items?itemName=YoshihideShirai.asciidoc-local-preview
を開発しました。VS CodeのAsciiDocのプレビューする拡張機能です。
AsciiDoc を VS Code で編集するなら、多くの人は Asciidoctor VS Code Extension を使っていると思います。
私も普段から利用しています。
この拡張は、
- ライブプレビュー
- PDF出力
- HTML出力
- Kroki連携
- アウトライン表示
などを備えた非常に優れた拡張です。
では、なぜ私は別の AsciiDoc プレビュー拡張を作ったのでしょうか。
きっかけは「ネットワークに出したくない」
業務では、
- 社外秘の設計書
- 顧客向け提案資料
- 開発中の仕様書
を扱うことがあります。
そのような文書では、
「この文書は本当にローカルだけで処理されるのか？」
が気になることがあります。
もちろん、多くのツールはローカルで動作します。
しかし、
- 外部レンダリングサービス
- クラウド連携
- SaaS前提のワークフロー
が一般的になった現在、
「ネットワークを一切使わないこと」
そのものに価値があると感じるようになりました。
Zero-Network という考え方
そこで作ったのが
AsciiDoc Zero-Network Preview
https://marketplace.visualstudio.com/items?itemName=YoshihideShirai.asciidoc-local-preview
です。
名前の通り、
AsciiDoc のプレビューのためにネットワークアクセスを必要としない
ことを最優先にしています。
目標はシンプルです。
プレビューのために、どこにも送らない。
なぜ「Zero-Network」なのか
最近の開発環境は便利になりました。
一方で、
- クラウドサービス
- AIサービス
- 外部レンダラ
- Web API
への依存も増えています。
しかし、
AsciiDoc のプレビューという用途だけを見ると、
本来はネットワークが不要なはずです。
テキストファイルと画像ファイルが手元にあるなら、
ローカルだけで完結できます。
AsciiDoc Zero-Network Preview は、
この考え方を徹底したかったのです。
Asciidoctor VS Code と何が違うのか
私は Asciidoctor VS Code の代替を作りたかったわけではありません。
むしろ思想の違いです。
Asciidoctor VS Code
- 高機能
- 豊富なエコシステム
- 多くのユースケースをカバー
AsciiDoc Zero-Network Preview
- Zero-Network
- ローカル完結
- 最小依存
- シンプルなプレビュー
想定している利用シーン
- 社内設計書
- ネットワーク制限のある環境
- 顧客向けドキュメント
- 機密情報を扱う文書
- オフライン環境
- インターネット接続がない場所
- 長期保守プロジェクト
- 将来的なサービス停止や外部依存を避けたいケース
名前に込めた意味
あえて Zero-Network Preview という名前を選びました。
私が伝えたいのは実装ではなく思想です。
重要なのは、
ネットワーク接続を前提にしない
ことです。
AsciiDoc Zero-Network Preview は、
そのための VS Code 拡張です。
まとめ
AsciiDoc Zero-Network Preview は、
「もっと高機能なプレビュー」
を目指したものではありません。
目指したのは、
Zero-Network なドキュメントプレビュー
です。
- プレビューのために外部へ送らない
- ネットワーク接続を前提にしない
- ローカル環境だけで完結する
- AsciiDoc 本来のシンプルさを活かす
そんな考え方に共感していただける方がいれば、ぜひ試してみてください。