MkDocsメモ¶
MkDocsとGitHub Pagesを使った静的サイト構築に関する情報をまとめています。
📚 MkDocs関連記事¶
基本ガイド¶
- mkdocsを使ったGitHub Pagesの作成方法 - 完全な初心者向けガイド
- 環境構築からデプロイまでの全手順
- 実際のコマンド例とスクリーンショット
- トラブルシューティング情報
応用・カスタマイズ¶
- デザイン改善ガイド - モダンなUI/UX実装
- Material テーマの高度な機能
- カスタムCSS設定
レスポンシブデザイン対応
Google Analytics設定 - アクセス解析の導入
- GA4の設定手順
- プライバシー対応
カスタムイベント設定
高度な設定 - プラグインとCI/CD
- 豊富なプラグイン紹介
- 多言語対応
- 自動デプロイ設定
🌟 このサイトの特徴¶
このサイト(https://aiedoc.github.io/note/)自体がMkDocsの活用例となっています:
実装済み機能¶
- ダークモード: システム設定に応じた自動切り替え
- 高速ナビゲーション: インスタントローディング
- 日本語対応: 検索機能、フォント最適化
- レスポンシブ: 3列グリッドレイアウト
- 豊富なコンテンツ: 100以上の記事
コンテンツの種類¶
- 技術ドキュメント: チュートリアル、リファレンス
- ナレッジベース: リンク集、便利ツール
- システム管理: インフラ、セキュリティ情報
🚀 始めるなら¶
- 初心者の方: mkdocsを使ったGitHub Pagesの作成方法から開始
- カスタマイズしたい方: デザイン改善ガイドでUI強化
- アクセス解析したい方: アナリティクス設定でGA4導入
- 高度な機能が欲しい方: 高度な設定でプロ仕様に
💡 MkDocsのメリット¶
- 無料: GitHub Pagesで完全無料運用
- 簡単: Markdownで書ける
- 高機能: 検索、ナビゲーション、テーマ
- 高速: 静的サイトで超高速
- SEO対応: 検索エンジン最適化済み
📧 フィードバック¶
記事の改善点や追加してほしい情報があれば、GitHubリポジトリでIssueやPull Requestをお送りください。