#Static Site
25 件の記事
Docusaurusでマニュアルを作る #3 コンテンツ作成 — コードブロック、Mermaid、admonition
ドキュメントを読みやすくする三つの要素を扱います。タイトル・行強調が付くコードブロック、コードで描くMermaidのダイアグラム、そして注意・警告を見せるadmonitionまで、Docusaurusでの使い方を整理します。
Hugoでマニュアルを作る #4 Cloudflare Pages でデプロイしてドメインを接続する
ローカルで作ったドキュメントを世に送り出します。GitHub に上げ、Cloudflare Pages に接続してビルド設定を整え、カスタムドメインを付ける過程を整理します。Hextra の Go モジュールと公開日の落とし穴まで一緒に押さえます。
MkDocsでマニュアルを作る #3 コンテンツ作成 — コードブロック、Mermaid、admonition
ドキュメントを読みやすくする3つの要素を扱います。タイトルや行ハイライトが付くコードブロック、コードで描くMermaidの図、そして注意・警告を目立つように見せるadmonitionまで、MkDocs Materialでの使い方を整理します。
Starlightでマニュアルを作る #3 コンテンツ作成 — コードブロック、Mermaid、aside
ドキュメントを読みやすくする三つの要素を扱います。タイトル・行強調が付くコードブロック、プラグインで加えるMermaidのダイアグラム、そして注意・警告を見せるasideまで、Starlightでの使い方を整理します。
Docusaurusでマニュアルを作る #2 サイドバーと検索 — ドキュメントの情報構造を組む
ドキュメントが数十編に増えても読者が道に迷わないためには、サイドバーと検索が核心です。Docusaurusでsidebars.jsを使ってサイドバーを自動・手動で構成し、検索を付ける選択肢を整理します。
Hugoでマニュアルを作る #3 コンテンツ作成 — コードブロック、Mermaid、コールアウト
ドキュメントを読みやすくする三つの要素を扱います。ファイル名・行ハイライトが付くコードブロック、コードで描く Mermaid のダイアグラム、そして注意・警告を目立たせて見せるコールアウトまで、Hextra での使い方を整理します。
MkDocsでマニュアルを作る #2 navと検索 — ドキュメントの情報構造を整える
ドキュメントが数十編に増えても読者が迷わないためには、サイドバーと検索が要です。MkDocsでnavをmkdocs.ymlに直接設計し、Materialのナビゲーション機能と内蔵検索をオンにするところまで整理します。
Starlightでマニュアルを作る #2 サイドバーと検索 — ドキュメントの情報構造を整える
ドキュメントが数十編に増えても読者が道に迷わないためには、サイドバーと検索が肝心です。Starlightでサイドバーを自動・手動で構成し、標準で組み込まれた検索を見ていきます。
Docusaurusでマニュアルを作る #1 インストールから最初のドキュメントまで
Docusaurusでチームドキュメントや製品マニュアルのサイトの骨組みを立てます。Node.jsの準備からcreate-docusaurusでサイトを生成し、開発サーバーで最初のドキュメントを表示するところまで一気に進めます。
Hugoでマニュアルを作る #2 サイドバーと検索 — ドキュメントの情報構造を整える
ドキュメントが数十編に増えても読者が道に迷わないためには、サイドバーと検索が要です。Hextra でフォルダ構造によってサイドバーの階層を整え、weight で順序を決め、上部メニューと内蔵検索を接続するところまで整理します。
MkDocsでマニュアルを作る #1 インストールから最初のドキュメントまで
MkDocsとMaterialテーマで、チームドキュメントや製品マニュアルのサイトの骨組みを立てます。Pythonの仮想環境へのインストールから、新しいサイトの作成、テーマの適用、ローカルサーバーで最初のドキュメントを表示するところまでを一気に進めます。
Starlightでマニュアルを作る #1 インストールから最初のドキュメントまで
AstroのStarlightで、チームドキュメントや製品マニュアルサイトの土台を組み立てます。Node.jsの準備からcreate astroでサイトを生成し、開発サーバーで最初のドキュメントを表示するところまで一気に進めます。