Skip to content
Permalink
main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
 
 
Cannot retrieve contributors at this time

Custom Modifications for Mk-Docs

Some quick modifications for MK docs and teaching

  • Current mk-docs material version 7.1.7
  • Updated Mkdocs mateiral is 8.3.9

Main Docs can be found here

https://squidfunk.github.io/mkdocs-material/

Usage Notes

Install

With python. (I would also use a virtualenv)

(env)python -m pip install -r REQUIREMENTS.txt

Uploading the docs

mkdocs gh-deploy

YAML Notes

Turned Navigation Sections on, meaning we no longer need a new index.

nav:
  - Section:
    - section/index.md 


    - Page 1: section/page-1.md
    ...
    - Page n: section/page-n.md

Notes for Updating

If I make changes it may be useful to update any other repos We can do this with

PS C:\Users\dang\Documents\GitHub\245CT> git remote add template https://github.coventry.ac.uk/aa9863/mkdocs-template.git
PS C:\Users\dang\Documents\GitHub\245CT> git fetch --all
PS C:\Users\dang\Documents\GitHub\245CT> git merge template/main --allow-unrelated-histories
Merge made by the 'recursive' strategy.

CHANGES

  • Material 9.2 (2023-24)

  • Material 8.3.9 (2022-23)

  • Material 7.2.1

    • Material 7.x Introduced dark mode toggle, So this has been removed.
    • Added Analytics script section for probable plausible integrations.
  • Version 1.0

    • Removed my boilerplate text for how the docs work etc. This is now a subrepo. Ask if you want a copy.

NOTES ON UDATES

INFO - DeprecationWarning: 'materialx.emoji.twemoji' is deprecated. Material emoji logic has been officially moved into mkdocs-material version 9.4. Please use Material's 'material.extensions.emoji.twemoji' instead of 'materialx.emoji.twemoji' in your 'mkdocs.yml' file.

       ```
       markdown_extensions:
         - pymdownx.emoji:
             emoji_index: !!python/name:material.extensions.emoji.twemoji
             emoji_generator: !!python/name:material.extensions.emoji.to_svg
       ```

       'mkdocs_material_extensions' is deprecated and will no longer be
       supported moving forward. This is the last release.