Metadata-Version: 2.1
Name: mkdocs-homepage-copier
Version: 0.0.1
Summary: Copy homepage file
Home-page: https://github.com/onyonkaclifford/MkDocs-homepage-copier
Author: Clifford Onyonka
Author-email: clifford.onyonka@8teq.co.ke
Maintainer: Clifford Onyonka
Maintainer-email: clifford.onyonka@8teq.co.ke
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mkdocs

[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/onyonkaclifford/MkDocs-homepage-copier/blob/main/LICENSE)
[![Linting workflow](https://github.com/onyonkaclifford/MkDocs-homepage-copier/actions/workflows/linting.yml/badge.svg?branch=main)](https://github.com/onyonkaclifford/MkDocs-homepage-copier/actions/workflows/linting.yml)
[![SAST workflow](https://github.com/onyonkaclifford/MkDocs-homepage-copier/actions/workflows/SAST.yml/badge.svg?branch=main)](https://github.com/onyonkaclifford/MkDocs-homepage-copier/actions/workflows/SAST.yml)
[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Code style: flake8](https://img.shields.io/badge/code%20style-flake8-orange.svg)](https://github.com/pycqa/flake8)

# MkDocs Homepage Copier

Reuse the `README.md` file by copying it into the `docs/` directory as the `docs/index.md` file

## Linting

Isort, black, and flake8 are used to check that code is well formatted and styled. Pre-commit hooks are used to automate
this process.

- Install pre-commit package: `pip install pre-commit`
- Install git hook scripts: `pre-commit install`
- (optional) Run against all files: `pre-commit run --all-files`


## Usage

- Build the package: `pip wheel --no-deps . -w dist`
- Install the resultant wheel: `pip install dist/mkdocs_homepage_copier-0.0.1-py3-none-any.whl`
- Add `mkdocs-homepage-copier` entry under the `plugins` section of `mkdocs.yml`

If the file to be copied is not named `README.md` and/or the destination path isn't `docs/index.md`, use the parameters
`src` and `dest` to identify the correct file to be copied and the correct destination path it's to be copied to. Either
one, both, or none of the two parameters can be used depending on the need.

```yaml
plugins:
  - search
  - mkdocs-homepage-copier:
      src: source.md
      dest: path/to/destination.md
```
