Skip to content

MkDocsメモ

MkDocsとGitHub Pagesを使った静的サイト構築に関する情報をまとめています。

📚 MkDocs関連記事

基本ガイド

応用・カスタマイズ

  • デザイン改善ガイド - モダンなUI/UX実装
  • Material テーマの高度な機能
  • カスタムCSS設定
  • レスポンシブデザイン対応

  • Google Analytics設定 - アクセス解析の導入

  • GA4の設定手順
  • プライバシー対応
  • カスタムイベント設定

  • 高度な設定 - プラグインとCI/CD

  • 豊富なプラグイン紹介
  • 多言語対応
  • 自動デプロイ設定

🌟 このサイトの特徴

このサイト(https://aiedoc.github.io/note/)自体がMkDocsの活用例となっています:

実装済み機能

  • ダークモード: システム設定に応じた自動切り替え
  • 高速ナビゲーション: インスタントローディング
  • 日本語対応: 検索機能、フォント最適化
  • レスポンシブ: 3列グリッドレイアウト
  • 豊富なコンテンツ: 100以上の記事

コンテンツの種類

  • 技術ドキュメント: チュートリアル、リファレンス
  • ナレッジベース: リンク集、便利ツール
  • システム管理: インフラ、セキュリティ情報

🚀 始めるなら

  1. 初心者の方: mkdocsを使ったGitHub Pagesの作成方法から開始
  2. カスタマイズしたい方: デザイン改善ガイドでUI強化
  3. アクセス解析したい方: アナリティクス設定でGA4導入
  4. 高度な機能が欲しい方: 高度な設定でプロ仕様に

💡 MkDocsのメリット

  • 無料: GitHub Pagesで完全無料運用
  • 簡単: Markdownで書ける
  • 高機能: 検索、ナビゲーション、テーマ
  • 高速: 静的サイトで超高速
  • SEO対応: 検索エンジン最適化済み

📧 フィードバック

記事の改善点や追加してほしい情報があれば、GitHubリポジトリでIssueやPull Requestをお送りください。