mkdocs theme based on DOCter
Project description
# mkDOCter
mkDOCter is an [MkDocs](http://www.mkdocs.org/) theme based on the
[DOCter template for Jekyll](https://github.com/ascott1/DOCter).
## Usage
Use pip to install mkDOCter. If you're using mkdocs within a
[virtualenv](https://virtualenv.pypa.io/en/stable/), please be sure to
install mkDOCter into the same virtualenv.
```
pip install mkDOCter
```
Once installed, you can add mkDOCter to your mkdocs configuraiton file:
```
theme: mkDOCter
```
## Configuration
mkDOCter has a few config extras to customize its appearances:
```
extras:
brand_color: "#1096CF"
logo_url: http://xmlsoft.org/catalog.gif
logo_alt: My Awesome Logo
```
*`brand_color`* controls the header and sidebar accent lines.
*`logo_url`* is the URL to a logo to display in the top right.
*`logo_alt`* is the alt text for the logo.
## License
The project is in the public domain, and all contributions to it will be
released as such. By submitting a pull request, you are agreeing to
waive all rights to your contribution under the terms of the
[CC0 Public Domain Dedication](TERMS.md).
If you contribute the open source work of others, please mark it clearly
in your pull request.
mkDOCter is an [MkDocs](http://www.mkdocs.org/) theme based on the
[DOCter template for Jekyll](https://github.com/ascott1/DOCter).
## Usage
Use pip to install mkDOCter. If you're using mkdocs within a
[virtualenv](https://virtualenv.pypa.io/en/stable/), please be sure to
install mkDOCter into the same virtualenv.
```
pip install mkDOCter
```
Once installed, you can add mkDOCter to your mkdocs configuraiton file:
```
theme: mkDOCter
```
## Configuration
mkDOCter has a few config extras to customize its appearances:
```
extras:
brand_color: "#1096CF"
logo_url: http://xmlsoft.org/catalog.gif
logo_alt: My Awesome Logo
```
*`brand_color`* controls the header and sidebar accent lines.
*`logo_url`* is the URL to a logo to display in the top right.
*`logo_alt`* is the alt text for the logo.
## License
The project is in the public domain, and all contributions to it will be
released as such. By submitting a pull request, you are agreeing to
waive all rights to your contribution under the terms of the
[CC0 Public Domain Dedication](TERMS.md).
If you contribute the open source work of others, please mark it clearly
in your pull request.
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
mkDOCter-1.0.5.tar.gz
(11.8 kB
view details)
Built Distribution
File details
Details for the file mkDOCter-1.0.5.tar.gz
.
File metadata
- Download URL: mkDOCter-1.0.5.tar.gz
- Upload date:
- Size: 11.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e190b7df2877d06d9686caa94a7c68c7f845c3706c3c310310397c73299a6430 |
|
MD5 | 51a04320c45025addfd322ab538d45b6 |
|
BLAKE2b-256 | ec6da68b295c1debe1f7d7251d4b2d9a4a71651bb1fec59b61c0f53c252a873c |
File details
Details for the file mkDOCter-1.0.5-py2.py3-none-any.whl
.
File metadata
- Download URL: mkDOCter-1.0.5-py2.py3-none-any.whl
- Upload date:
- Size: 13.6 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | dc94e327c75e7c94d841a7a377395f3048c37de4caef9a9499f01fab98e15cbe |
|
MD5 | b52fbee2d61a74bd3b202a20665dced6 |
|
BLAKE2b-256 | 770247f4d82ad067d761fc95c85a495d431e387a071372a0b150f08662c39579 |