Skip to content

Mkdocs-material/HPづくり

This page describe how to create homepage like this. Just a note for myself.

(2022.5.17)

MBP16_2021_M1max_macOS 12.4 montereyで、OSのクリーンインストールしたのをきっかけに、GitHubでHPをつくるためのセットアップをおさらいした。

GitHub

  1. アカウントをつくる、GitHub Pagesを使っている。二段階認証の設定をした。
    （くわしくはわすれたので省略）

準備、インストーラ使用

  1. VS code（mdファイルを編集しやすい。GitHubへのdeployもできる） 古いインストーラなら、あとでアップデートも確認する。GitHubへのdeployは、最新版で行うため。
  2. Xcode（どこだったか、必要です、といわれるから） アップデート。About this Mac > Software update

準備、ターミナル作業

  1. Homebrewインストール（pyenvのインストール準備） サイトからコマンドをコピペ　https://brew.sh /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 環境パスを通す（Terminalに出てきたメッセージに従う、コピペがよい。usernameのところに自分のが入っているので。２つ実行。） echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/username/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)" バージョン確認、数字がでてくる brew -v

  2. pyenvインストール（pythonのインストール準備） brew install pyenv バージョン確認、数字がでてくる pyenv -v PATHを通す。よくわからんけど４つ順に。返答はない。 echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc echo 'eval "$(pyenv init -)"' >> ~/.zshrc source ~/.zshrc

  3. pythonインストール インストールできるバージョンの確認 pyenv install --list 新しめのバージョンをインストール（末尾がごちゃごちゃしてないやつ、2022.5.17) pyenv install 3.10.4 確認、インストールしたバージョン数が表示される pyenv versions インストールしたバージョンを指定する pyenv global 3.10.4 指定できたか確認する python --versioin

  4. pipアップデート（以降の準備） pipはすでにインストールされているはず、らしい。インストールではなくアップデート。これをさぼると、以降のインストール作業で要求される。 pip install --upgrade pip 確認できる pip --version

  5. mkdocsインストール サイトを参考に、https://www.mkdocs.org/getting-started/ pip install mkdocs

  6. mkdocs-materialインストール サイトを参考に、https://squidfunk.github.io/mkdocs-material/getting-started/ pip install mkdocs

  7. GitHubへのdeploy VS codeでmdファイルを編集し、はじめて、mkdocs gh-deployをうったとき、ブラウザでログインするように誘導される。ユーザ名とパスワードと、二段階認証コードでログインする。ログイン作業は、２回目以降は不要。

HPを書く

  1. VS codeで、Markdown形式で。
  2. ファイルは、ローカルに整理整頓。
  3. Dropboxに作っておけば、あちこちのパソコンで更新作業できる。
    （くわしくはわすれたので省略。たぶんMkDocs、Materials, GitHub Pagesの公式ページや、ググった情報で。）
  • Bashか、zshか。（ようわからん） 以前は、Bashで使っていたけど、今回2022.5.17は、zshのままでも作業できている。
  • pipが効かない。 pip、pip3をためす。
  • Homebrewのアップデート https://docs.brew.sh/FAQ#why-arent-some-apps-included-during-brew-upgrade brew update　リストがでてくる brew upgrade homebrewが管理しているアプリをアップデートする
  • mkdocsをバージョンアップ https://www.mkdocs.org/about/release-notes/ pip install -U mkdocs
  • mkdocs-materialsをバージョンアップ https://squidfunk.github.io/mkdocs-material/upgrade/?h=up pip install --upgrade mkdocs-material
  • anacondaやらminiforgeのこと pythonは、HP作りにしか使っていないので、今回2022.5.17は、なしでやってみた。
  • コマンドmk-doscがないとのエラー mkdocsをバージョンアップ、mkdocs-materialsをバージョンアップしたら、なおった。2024.6