Metadata-Version: 2.4
Name: ons_mkdocs_theme
Version: 1.2.4
Summary: An ONS MkDocs Theme based on Material for MkDocs for creating documentation websites
Home-page: https://github.com/ONSdigital/ons_mkdocs_theme
Author: Keilan Evans, ONS
Author-email: Keilan.Evans@ons.gov.uk
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: <3.13,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Babel==2.15.0
Requires-Dist: certifi==2024.7.4
Requires-Dist: charset-normalizer==3.3.2
Requires-Dist: click==8.1.7
Requires-Dist: colorama==0.4.6
Requires-Dist: csscompressor==0.9.5
Requires-Dist: ghp-import==2.1.0
Requires-Dist: htmlmin2==0.1.13
Requires-Dist: idna==3.7
Requires-Dist: Jinja2==3.1.4
Requires-Dist: jsmin==3.0.1
Requires-Dist: Markdown==3.6
Requires-Dist: MarkupSafe==2.1.5
Requires-Dist: mergedeep==1.3.4
Requires-Dist: mkdocs==1.6.0
Requires-Dist: mkdocs-get-deps==0.2.0
Requires-Dist: mkdocs-material==9.5.30
Requires-Dist: mkdocs-material-extensions==1.3.1
Requires-Dist: mkdocs-minify-plugin==0.8.0
Requires-Dist: packaging==24.1
Requires-Dist: paginate==0.5.6
Requires-Dist: pathspec==0.12.1
Requires-Dist: platformdirs==4.2.2
Requires-Dist: Pygments==2.18.0
Requires-Dist: pymdown-extensions==10.9
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: PyYAML==6.0.1
Requires-Dist: pyyaml_env_tag==0.1
Requires-Dist: regex==2024.7.24
Requires-Dist: requests==2.32.4
Requires-Dist: six==1.16.0
Requires-Dist: urllib3==2.2.2
Requires-Dist: watchdog==4.0.1
Dynamic: license-file

<p align="center" style="padding: 50px">
    <img src="ons_mkdocs_theme/assets/images/logo.svg" width="450px">
</p>

## :red_car: Getting Started

Setting up your documentation site to use this theme couldn't be easier. The quickest and easiest way to get up and running is to install with `pip`.

To be able to use this theme, you need to be using at least **Python v3.8**.

### :computer: Installation

#### with pip

ONS MkDocs Theme is published as a Python package and can be installed with
`pip`, ideally by using a [virtual environment][virtual environment]. Open up a terminal and install
ONS MkDocs Theme with:

```
pip install ons_mkdocs_theme
```

This will automatically install compatible versions of all dependencies:
[MkDocs], [Markdown], [Pygments] and [Python Markdown Extensions][Python Markdown Extensions].

!!! tip

    If you don't have prior experience with Python, we recommend reading
    [Using Python's pip to Manage Your Projects' Dependencies], which is a
    really good introduction on the mechanics of Python package management and
    helps you troubleshoot if you run into errors.

#### with git

ONS MkDocs Theme can be directly used from [GitHub] by cloning the
repository into a subfolder of your project root folder.

Simply create a folder called `ons_mkdocs_theme`. In the terminal, ensure you are in the root folder directory of your project and run the following command:

```
mkdir ons_mkdocs_theme
```

You then need to `cd` into the new directory with the following command:

```
cd ons_mkdocs_theme
```

To clone the theme files, run the following command:

```
git clone https://github.com/ONSdigital/ons_mkdocs_theme
```

Next, install the theme and its dependencies with:

```
pip install -e .
```

[GitHub]: https://github.com/ONSdigital/ons_mkdocs_theme
[virtual environment]: https://realpython.com/what-is-pip/#using-pip-in-a-python-virtual-environment
[semantic versioning]: https://semver.org/
[MkDocs]: https://mkdocs.org
[Markdown]: https://python-markdown.github.io/
[Pygments]: https://pygments.org/
[Python Markdown Extensions]: https://facelessuser.github.io/pymdown-extensions/
[Using Python's pip to Manage Your Projects' Dependencies]: https://realpython.com/what-is-pip/
