Metadata-Version: 2.4
Name: mkdocs-zip-folders
Version: 1.0.5
Summary: MkDocs plugin to zip configured folders and add them to the site.
Home-page: https://github.com/JakubAndrysek/mkdocs-zip-folders
Author: Jakub Andrýsek
Author-email: email@kubaandrysek.cz
License: MIT
Project-URL: Source, https://github.com/JakubAndrysek/mkdocs-zip-folders
Project-URL: Documentation, https://zip-folders.kubaandrysek.cz/
Project-URL: Tracker, https://github.com/JakubAndrysek/mkdocs-zip-folders/issues
Project-URL: Funding, https://github.com/sponsors/jakubandrysek
Keywords: mkdocs plugin zip folders download zip-folders
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mkdocs
Provides-Extra: dev
Requires-Dist: mkdocs-material; extra == "dev"
Requires-Dist: mkdocs-open-in-new-tab; extra == "dev"
Requires-Dist: mkdocs-glightbox; extra == "dev"
Requires-Dist: mkdocs-git-revision-date-localized-plugin; extra == "dev"
Requires-Dist: setuptools; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: description
Dynamic: description-content-type
Dynamic: license-file

# ZipFolders MkDocs Plugin

The `ZipFolders` plugin is used to create archives (zip and tar.gz) of specified folders in your MkDocs project after the site build process. This can be helpful if you need to distribute or backup parts of your documentation.

![Plugin](https://raw.githubusercontent.com/JakubAndrysek/mkdocs-zip-folders/main/docs/assets/plugin.png)

## Installation

Install the plugin using pip from [PyPI](https://pypi.org/project/mkdocs-zip-folders/):

```bash
pip install mkdocs-zip-folders
```

## Configuration

To use the `ZipFolders` plugin, you need to add it to your `mkdocs.yml` configuration file.

Here is a sample configuration:

```yaml
plugins:
  - search
  - zip_folders:
      folders:
        - myCode
        - toShare
        - folderX/thisWillBeZipped
      formats:
        - zip
        - tar.gz
      hash_extension: ".hash" # default extension
      debug: true # optional - default is false
```

- `folders` - A list of folders to archive. The folders are relative to the root of the MkDocs documentation project - docs_dir (default is `docs`).
- `formats` - A list of archive formats to create. Supported formats are `zip` and `tar.gz`. Default is `['zip']`.
- `debug` - Optional. If set to `true`, the plugin will print debug messages to the console. Default is `false`.
- `hash_extension` - The extension to use for hashing archives. Default is `.hash`.


## Git configuration

It is highly recommended to add the archive files and hash files to your `.gitignore` file. This will prevent you from accidentally committing the archive files to your repository.

```gitignore
# Archive files generated by mkdocs-zip-folders
*.zip
*.tar.gz
*.zip.hash
*.tar.gz.hash
```

Archive files will be generated automatically after each build.

## Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

## Do You Enjoy My Work?
Then definitely consider:

- supporting me on GitHub Sponsors: [![](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/jakubandrysek)

## License

[MIT](https://choosealicense.com/licenses/mit/)
