| name | mkdocs-common-issues |
| description | Sub-skill of mkdocs: Common Issues (+1). |
| version | 1.0.0 |
| category | _internal |
| type | reference |
| scripts_exempt | true |
Common Issues (+1)
Common Issues
Build Fails with "Page not in nav"
validation:
nav:
omitted_files: info
not_found: warn
absolute_links: info
Mermaid Diagrams Not Rendering
markdown_extensions:
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
Search Not Working
plugins:
- search:
lang: en
prebuild_index: true
Git Revision Plugin Fails
git fetch --unshallow
plugins:
- git-revision-date-localized:
fallback_to_build_date: true
Social Cards Generation Fails
pip install pillow cairosvg
apt-get install libcairo2-dev libffi-dev
brew install cairo
Debug Mode
mkdocs build --verbose
mkdocs serve --verbose --dev-addr 0.0.0.0:8000
mkdocs build --strict