mkdocs

How to publish the site to local LAN

ifconfig 
# en0找到本地局域网ip,inet 后面192开头的
# en0 表示以太网接口0，通常是wifi，如果连接了网线还会有en1 等
mkdocs serve -a 0.0.0.0:8000 
# 局域网内通过192...:8000访问

icons in mkdocs

This is the domain of material for mkdocs. How to use Icons, Emojis can be found here. On the head of the page, there is a Search input which is used to find the exact code for icons/emojis you need like :smile:

Errors

could not determine a constructor for the tag 'tag:yaml.org,2002:python/name:material.extensions.emoji.twemoji' in "mkdocs.yml", line 14, column 20 happened in pre-commit Same problem can be found in pre-commit issues 552

# in the .pre-commit-config.yaml
args: [--unsafe]

Authntication

Access private MkDocs after logging in #5875 OAuth2 Proxy(Active)