Skip to main content

An MkDocs plugin to process configuration items with Jinja2

Project description

mkdocs-jconfig-plugin

This MkDocs plugin allows to process configuration variables using Jinja templates.

Installation

Install the package with pip:

pip install mkdocs-jconfig-plugin

Activate the plugin in mkdocs.yml:

plugins:
  - search
  - calendar
  - jconfig

Configuration

The plugin can be configured in the plugins section of mkdocs.yml as follows:

plugins:
  - search
  - calendar
  - jconfig:
      items:
        - copyright

The plugin supports the following configuration options:

Option Description
items The configuration variables to process. Defaults to [].

Typical usage

This plugin is useful when you want to automatically adjust the year in the copyright:

copyright: copyright {{ cal.today.year }} The Authors

plugins:
  - search
  - calendar
  - jconfig:
      items:
        - copyright

Note that you need to activate the calendar plugin for this to work.

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_jconfig_plugin-0.1.3.tar.gz (2.7 kB view hashes)

Uploaded Source

Built Distribution

mkdocs_jconfig_plugin-0.1.3-py3-none-any.whl (3.3 kB view hashes)

Uploaded Python 3

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