Metadata-Version: 2.1
Name: mkdocs-branchcustomization-plugin
Version: 0.1.2
Summary: Update mkdocs configuration based on the git branch
Home-page: https://github.com/effigies/mkdocs-branchcustomization-plugin
Author: Christopher J. Markiewicz
Author-email: markiewicz@stanford.edu
Maintainer: Christopher J. Markiewicz
Maintainer-email: markiewicz@stanford.edu
License: MIT License
Platform: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Provides: mkdocs_branchcustomization_plugin
Requires-Python: >=3.6
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Requires-Dist: mkdocs
Requires-Dist: gitpython

# MkDocs Branch Customization Plugin

This plugin allows configuration options to be overridden on a per-branch basis.
Branches are matched with regular expressions.

An example for adding CSS to the `master` branch might be:

```YAML
plugins:
  - branchcustomization:
      update_config:
        - branch: /master/
          extra_css: css/master_branch.css
```

Note that this will *override* the global `extra_css` value.

To customize every branch *except* `master`:

```YAML
plugins:
  - branchcustomization:
      update_config:
        - branch: /(?!^master$)/
          extra_css: css/draft.css
          extra_js: js/draft.js
```

This is just to demonstrate that multiple configuration options can be overridden.


