Metadata-Version: 2.1
Name: mkdocs-branchcustomization-plugin
Version: 0.1.3
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
```

In this case the `+extra_css` indicates that this list should be *appended* to
the global `extra_css` value, rather than overriding it, while `extra_js` overrides
the global value.


