ホーム

docs/ フォルダ(または、"docs" らしくないプロジェクトなら src/)を指定するだけ。ドキュメント、マーケティングサイト、ブログ、その他 Markdown で書けるものなら何でも、検索・i18n・実運用向けの Markdown ツールキットを備えた、高速でテーマ変更可能な静的サイトが手に入ります。

このサイト自体も、このリポジトリの docs/ フォルダ内の Markdown ファイルから BxSites によってビルドされています。

BxSites はリファレンスドキュメント専用ではなく、汎用の 静的サイトジェネレーターです。マーケティングサイト、ブログ、ナレッジベース、 プロダクトサイト、個人サイト - Markdown で書けるものなら何でも、同じテーマ、 同じ検索、同じ i18n を通して同じようにビルドされます。コンテンツは既定では docs/ に置きますが、「docs」というよりウェブサイトらしいプロジェクトなら src/ でも構いません - どちらでもすべてのコマンドは同じように動作します。

Markdown を入力して、静的 HTML を出力

docs/ フォルダ - あるいは「docs」というよりウェブサイトらしいプロジェクトなら src/ - を指定するだけで、site/ に完全なサイトが生成されます。ホスティング にサーバーは不要です。

フォルダ構造がそのままナビゲーション構造に

docs/(または src/)配下にフォルダとファイルをネストすると、フロントマターで 指定した順序でナビゲーションが自動的に構築されます。

10 個の組み込みテーマ

bootstrapmaterialtailwind、そして Docsy・Stripe・Docusaurus・ Just the Docs・VuePress・GitBook・Notion にインスパイアされた 7 個を加えた フルギャラリー - すべて独自テーマで上書き可能です。

静的なクライアントサイド検索

あいまい検索・前方一致検索に対応した MiniSearch 駆動の検索ボックスに加え、 Cmd/Ctrl+K コマンドパレットも搭載 - build 時に生成される検索インデックスと 連携し、サーバー依存なし。

標準搭載のブログ

docs/blog/posts/ に投稿を置くだけで、著者・カテゴリ・年別アーカイブ・ RSS フィード・投稿ごとのアイキャッチ画像が設定不要で手に入ります。

デフォルトで高速・エアギャップ対応

フィンガープリント付き CSS/JS バンドリングとレスポンシブ画像が標準搭載、 さらに Bootstrap、highlight.js、Alpine.js、lunr.js、(オプトインで)Mermaid もすべてベンダリング済み - ビルドされたサイトはデフォルトで外部への リクエストが一切発生しません。

本物のプラグインシステム

プラグインは単なる別の BoxLang モジュールです - 専用の Plugin API を学ぶ 必要はありません。

ForgeBox で公開されるプラグイン & テーマ

install:plugininstall:theme は、公開済みパッケージをプロジェクトに 直接ダウンロードします - ForgeBox の bxsites-pluginsbxsites-themes から探せます。

既存のテーマをインポート

theme:import --source=mkdocs|jekyll|hugo は、他のジェネレーター自身の テーマテンプレートを bx-sites のスキャフォールドに変換します - ゼロから 書き直す代わりに、そこから作り込めます。

GitBook、mkdocs、zip、または Notion から移行

bxSites migrate --from=gitbook|mkdocs|markdown-zip|notion は、既存の エクスポートやプロジェクトを、一つのコマンドで動作する bx-sites プロジェクトに 変換します。

どこへでもデプロイ

bxSites deploy は、ビルドしたサイトを S3、Azure、GCS、Firebase、FTP/SFTP、 rsync、Netlify、Vercel、Cloudflare Pages、GitHub Pages に直接デプロイします - bxSites package なら単一のアーカイブに zip 圧縮することもできます。

再利用可能な変数とマジック関数

{{ dotted.path }}bxsites.yaml 自身の variables ブロックから値を 取得し、{{ $name(args) }} は Markdown から直接、小さな BoxLang ヘルパー 関数を呼び出します - プラグインも配線も不要です。

リッチなコンテンツブロック

テーブル、ボタン、プロンプト、展開可能セクション、タブ、埋め込み OpenAPI 仕様 - 素の Markdown の上に構築された GitBook スタイルのブロックライブラリです。

読むだけでなく、実際に見てみる

BxSites 自身の Markdown ツールキットが、まさにこのホームページ上で動いています - スクリーンショットではなく、本物です:

1
インストール

install-bx-module bx-sites

2
スキャフォールド

bxSites new

3
ビルド & 配信

bxSites serve

あらゆる場面で使えるコールアウト

notetipwarningdanger など、12 種類の標準 Admonition タイプ - それぞれ専用のアクセントカラーを持ち、折りたたみ可能な ??? バリアントも あります。Markdown 拡張機能 を参照してください。

コンテンツタブ、数式、ダイアグラム

グループ化されたコードタブ、KaTeX 数式、Mermaid ダイアグラム、脚注、 定義リストがすべて標準搭載です - 詳しくは Markdown 拡張機能 を参照してください。

次のステップ

サイト構築の手伝いが必要ですか?

BxSites は無料でオープンソースです - ですが、開発チーム自身に作業を 任せたい場合は、Ortus Solutions が ドキュメントサイト、移行、その他 BxSites で構築されたあらゆる静的サイトに 関するプロフェッショナルサービス・コンサルティングを提供しています。

このページを編集 Markdownをダウンロード 最終更新 Aug 28, 2026, 3:16:38 AM