Metadata-Version: 2.1
Name: mkdocs-material-adr
Version: 1.0.1a1
Summary: 
Home-page: https://github.com/Kl0ven/mkdocs-material-adr
License: Apache-2.0
Author: jeanloup.monnier
Author-email: jean-loup.monnier@spikeelabs.fr
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Project-URL: Repository, https://github.com/Kl0ven/mkdocs-material-adr
Description-Content-Type: text/markdown

# ADR for MkDocs's Material Theme

[ADR](https://lyz-code.github.io/blue-book/adr/) are short text documents that captures an important architectural decision made along with its context and consequences.


[Demo](http://blog.kloven.fr/mkdocs-material-adr/)

## Install

```bash
pip install mkdocs-material-adr
# or
poetry add mkdocs-material-adr
```

In the `mkdocs.yml` file

```yaml
theme:
  # set the name
  name: mkdocs-material-adr

  # Configuration for the material theme
  features:
    - navigation.instant
```

## Features

### ADR Headers
Information about the ADR are displayed in a header
Define information about the ADR in the frontmatter.

![Alt text](https://raw.githubusercontent.com/Kl0ven/mkdocs-material-adr/main/docs/assets/header.png)


```md
---
    title: 0004 Title
    adr:
        author: Jean-Loup Monnier
        created: 01-Aug-2023
        status:  draft | proposed | rejected | accepted | superseded
        superseded_by: 0001-test
---
```
You can change the colors or add new status using css

```css
/* Background color */
.c-pill-<lower_case_status_name> {
    background: #a3a3a3;
}

/* Dot color */
.c-pill-<lower_case_status_name>:before {
    background: #505050;
}
```

### ADR Graph
WIP

