今日は「mkdocs」についてめもめも…
本家はこちら https://www.mkdocs.org/
何するツール?
- markdownをhtmlにリアルタイム変換
- markdownが配置されたフォルダ名やファイル名から目次を自動作成
- テストwebサーバを内包
- ローカルでテストwebサーバを動かしながら、markdownを書いていくと、リアルタイムにwebサイトとしてみることができる
インストール
python、pipが使える環境で
$ pip install mkdocs
プロジェクト作成
$ mkdocs new project-name
プロジェクトのひな形が作られます。
project-name/
docs/
index.md
mkdocs.yml
テストwebサーバを起動
$ cd project-name
$ mkdocs serve
ブラウザで http://127.0.0.1:8000/ にアクセスするとwebサイトとしてみることができます。
この状態でmarkdownに修正を加えたり、フォルダを追加したり、ファイルを追加したりしていくわけですねー
ビルド
$ mkdocs build
CIの中で実行するにはこちら。
materialデザイン
セットアップ
$ pip install mkdocs-material
mkdocs.ymlにちょっと追記
site_name: プロジェクト名
theme:
name: material