Skip to content

Mkdocs material

raw html

You can paste raw html into the site like this:

<figure class="video_container">
  <video controls="true" allowfullscreen="true">
    <source src="../res/out.mp4" type="video/mp4">
  </video>
</figure>

Made use of this in https://vectorspace.xyz/tech/ffmpeg/

source: https://github.com/squidfunk/mkdocs-material/discussions/3984#discussioncomment-6374978

systemd service

~/bin/mkdocs-server.sh: 

#!/bin/bash

cd /home/vector/vectorspacexyz.github.io
mkdocs serve

Service file ~/.config/systemd/user/mkdocs-server.service:

[Unit]
Description=Start the mkdocs server

[Service]
ExecStart='/home/vector/bin/mkdocs-server.sh'

[Install]
WantedBy=default.target
Finally:

systemctl --user daemon-reload

systemctl --user start mkdocs.service

systemctl --user enable mkdocs.service

extensions

Add the following to extension:

https://squidfunk.github.io/mkdocs-material/reference/code-blocks/

markdown_extensions:
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences

Comments