MkDocsでM5StickCの日本語リファレンスを書き始めてみた

Blogだとばらばらしちゃうので、MkDocsでまとめてみました。

まだ1ページだけですが、まとめるよりフォーマット決めるのが大変でした。

https://lang-ship.com/reference/unofficial/M5StickC/

MkDocsのインストール

Windows10上の場合、Microsoft Store経由だとpipでインストールできなかったので、オフィシャルサイトからダウンロードしてインストールしました。

https://www.python.org/

インストール場所を「C:\Program Files (x86)」とかにするといろいろ面倒そうなので、「C:\Pg\Python37」みたいな感じのPathにいれました。

https://www.mkdocs.org/

あとはmkdocsのインストール手順通り

  • pip install –upgrade pip
  • pip install mkdocs

でセットアップできます。

プロジェクト作成

  • mkdocs new my-project

プロジェクト設定

「my-project\mkdocs.yml」を編集します。

テーマ変更

https://squidfunk.github.io/mkdocs-material/

Materialを使おうと思いましたが、日本語検索がうまく動かなかったので、githubから最新版をダウンロードしてきて使っています。

https://github.com/squidfunk/mkdocs-material

上記からダウンロードしてきて、「my-project\mkdocs-material\material」にいれてあげます。

設定ファイル

markdown_extensions:
  - codehilite
  - admonition
  - toc:
      permalink: true

theme:
  name: null
  custom_dir: 'mkdocs-material/material'
  language: 'ja'
  palette:
    primary: 'indigo'
    accent: 'indigo'
  font:
    text: 'Roboto'
    code: 'Roboto Mono'
  logo:
    icon: 'cloud'
  feature:
    tabs: true

とりあえず、この設定はいまは作ってみました。

コメントする

メールアドレスが公開されることはありません。

日本語が含まれない投稿は無視されますのでご注意ください。(スパム対策)