Skip to main content

MkDocs plugin to add some MPG branding to the Material for MkDocs theme

Project description

MkDocs MPG Theme

A MkDocs plugin that makes the Material for MkDocs theme look a bit like MPG.

This plugin uses the "Material for MkDocs" theme and just adds some visual touches.

Requirements

Demo

https://tombreit.github.io/mkdocs-mpgtheme-plugin/

Usage

  • Setup MkDocs and Material for MkDocs theme

  • Install this plugin:

    pip install mkdocs-mpgtheme-plugin
    
  • Activate and configure this plugin in your MkDocs project:

    # file: mkdocs.yml
    
    plugins:
      - search
      - mpgtheme
    theme:
      name: material
      logo: _assets/header-logo.svg
      footer_logo: _assets/footer-logo.svg
    extra:
      # all extras are optional
      support_email: mail@example.org
      support_phone: +49 123 456 789
      privacy_policy_url: https://example.org/privacy
      imprint_url: https://example.org/imprint
      copyright_string: ACME Inc.
    
  • Save and reference your header and footer logo files.

  • That's it.

Notes

  • Installing this plugin will install mkdocs and mkdocs-material as dependencies.
  • For a more complete configuration, see our demo mkdocs.yml.
  • Due to licensing and copyright issues, the MPG logo files are not part of this project, but we ship placeholder files for header-logo.svg and footer-logo.svg. Just set your logos (format: SVG) via logo and footer_logo in the theme config (see above).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs_mpgtheme_plugin-0.0.2.tar.gz (62.7 kB view details)

Uploaded Source

Built Distribution

mkdocs_mpgtheme_plugin-0.0.2-py3-none-any.whl (63.2 kB view details)

Uploaded Python 3

File details

Details for the file mkdocs_mpgtheme_plugin-0.0.2.tar.gz.

File metadata

File hashes

Hashes for mkdocs_mpgtheme_plugin-0.0.2.tar.gz
Algorithm Hash digest
SHA256 68ae4a96ad37fa6f2cacdc3974d4278369c5de46a83059470aadf71caa12200b
MD5 09152947ed9cb1e1c316f8ef1f8f058c
BLAKE2b-256 5bf88934e26d2cca822d18739b4a4e42aa6305b3155f108654ba167be930a1b9

See more details on using hashes here.

File details

Details for the file mkdocs_mpgtheme_plugin-0.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_mpgtheme_plugin-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6a7cc0b0bbf5cdc6745e0b0c90ab6753e3cde847ed8bc5c1f61e4327f4e2ead1
MD5 a39fc8b6848e6fca3ad340f01a238bd1
BLAKE2b-256 f9a2609190dd47f75524690b5c5b90ca480acd0123a4c4b845d186ea6767d937

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page