Skip to content

static copy of blog

Wordpress blog.iqonda.net.

Static site mkdocs setup steps

  • mkdocs new [dir-name] - Create a new project.
  • mkdocs serve - Start the live-reloading docs server.
  • mkdocs build - Build the documentation site.
  • mkdocs -h - Print help message and exit.

My custom/clean scripts

  • python3 organize.py - Take markdown posts and organize into yyyy/mm folders.
  • ./clean-pre.sh - Clean several old syntax highlighter lines.
  • ./upload-aws.sh - Upload new site folder after a new build.

mkdocs project layout

mkdocs.yml    # The configuration file.
docs/
    index.md  # The documentation homepage.
    ...       # markdown pages, images and other files.

my additional layout

mkdocs.yml    # The configuration file.
docs/
    index.md  # The documentation homepage.
    ...       # markdown pages, images and other files.
scripts/
    ...       # clean/organize scripts.