mkdocs

mkdosc 環境作った時のメモ（on AlmaLinux 8.6）
趣味で自分用に使ってる mkdocs がいろいろ調子悪かったり古かったりしたので、作り直し。

バージョンなど

AlmaLinux 8.6  
Python 3.6.8

mkdocs                     1.3.1
mkdocs-glightbox           0.2.1
mkdocs-material            8.2.11
mkdocs-material-extensions 1.0.3
pymdown-extensions         9.1

nginx version: nginx/1.14.1

インストール

# minimal だとはいってなかった
dnf install python3

# mkdocs のインストール
pip3 install mkdocs

# material テーマのインストール
pip3 install mkdocs-material

# 画像表示用に glightbox のインストール
pip3 install mkdocs-glightbox

# nginx のインストール
dnf install -y nginx

vim /etc/nginx/conf.d/default.conf

server {
    listen       80;
    server_name  docs.naokilog.com;

    location / {
        root   /var/www/site;
        index  index.html index.htm;
    }

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

nginx -t
systemctl start nginx

ファイアウォール調整

firewall-cmd --add-service http
firewall-cmd --runtime-to-permanent
firewall-cmd --list-all

/var/www 配下にて

mkdocs new docs
mkdocs build