| Name | mkdocs-print-site-plugin JSON |
| Version |
2.8
JSON |
| download |
| home_page | None |
| Summary | MkDocs plugin that combines all pages into one, allowing for easy export to PDF and standalone HTML. |
| upload_time | 2025-08-03 14:15:07 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
mkdocs
plugin
print
pdf
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://github.com/timvink/mkdocs-print-site-plugin/actions)
[](https://codecov.io/gh/timvink/mkdocs-print-site-plugin)
# mkdocs-print-site-plugin
[MkDocs](https://www.mkdocs.org/) plugin that adds a print page to your site that combines the entire site, allowing for easy export to PDF and standalone HTML. See [demo](https://timvink.github.io/mkdocs-print-site-plugin/print_page.html).
## Features :star2:
- Support for [mkdocs-material](https://github.com/squidfunk/mkdocs-material) theme, including features like instant loading, dark color themes and certain plugins (f.e. the [tags](https://squidfunk.github.io/mkdocs-material/plugins/tags/) plugin)
- Support for [readthedocs](https://www.mkdocs.org/user-guide/choosing-your-theme/#readthedocs) theme
- Support for pagination in PDFs
- Many options to customize appearance
- Option to add a cover page
- Lightweight, no dependencies
- Support for the [autorefs plugin](https://github.com/mkdocstrings/autorefs)
## Setup
Install the plugin using `pip3`:
```bash
pip3 install mkdocs-print-site-plugin
```
Next, add the following lines to your `mkdocs.yml`:
```yml
plugins:
- search
- print-site
```
> ⚠️ Make sure to put `print-site` to the **bottom** of the plugin list. This is because other plugins might alter your site (like the navigation), and you want these changes included in the print page.
> If you have no `plugins` entry in your config file yet, you'll likely also want to add the `search` plugin. MkDocs enables it by default if there is no `plugins` entry set.
## Usage
- Navigate to `/print_page/` or `print_page.html`
- Export to standalone HTML (see [export to HTML](https://timvink.github.io/mkdocs-print-site-plugin/how-to/export-HTML.html))
- Export to PDF using your browser using *File > Print > Save as PDF* (see [export to PDF](https://timvink.github.io/mkdocs-print-site-plugin/how-to/export-PDF.html))
## Documentation
Available at [timvink.github.io/mkdocs-print-site-plugin](https://timvink.github.io/mkdocs-print-site-plugin/).
## Contributing
Contributions are very welcome! Start by reading the [contribution guidelines](https://timvink.github.io/mkdocs-print-site-plugin/contributing.html).
Raw data
{
"_id": null,
"home_page": null,
"name": "mkdocs-print-site-plugin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mkdocs, plugin, print, pdf",
"author": null,
"author_email": "Tim Vink <vinktim@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/a9/18/5c71f48b83191fb30cc58617fea20f56647eaa6cafd06a7fb34c738c5acb/mkdocs_print_site_plugin-2.8.tar.gz",
"platform": null,
"description": "[](https://github.com/timvink/mkdocs-print-site-plugin/actions)\n\n\n\n[](https://codecov.io/gh/timvink/mkdocs-print-site-plugin)\n\n\n\n# mkdocs-print-site-plugin\n\n[MkDocs](https://www.mkdocs.org/) plugin that adds a print page to your site that combines the entire site, allowing for easy export to PDF and standalone HTML. See [demo](https://timvink.github.io/mkdocs-print-site-plugin/print_page.html).\n\n## Features :star2:\n\n- Support for [mkdocs-material](https://github.com/squidfunk/mkdocs-material) theme, including features like instant loading, dark color themes and certain plugins (f.e. the [tags](https://squidfunk.github.io/mkdocs-material/plugins/tags/) plugin)\n- Support for [readthedocs](https://www.mkdocs.org/user-guide/choosing-your-theme/#readthedocs) theme\n- Support for pagination in PDFs\n- Many options to customize appearance\n- Option to add a cover page\n- Lightweight, no dependencies\n- Support for the [autorefs plugin](https://github.com/mkdocstrings/autorefs)\n\n## Setup\n\nInstall the plugin using `pip3`:\n\n```bash\npip3 install mkdocs-print-site-plugin\n```\n\nNext, add the following lines to your `mkdocs.yml`:\n\n```yml\nplugins:\n - search\n - print-site\n```\n\n> \u26a0\ufe0f Make sure to put `print-site` to the **bottom** of the plugin list. This is because other plugins might alter your site (like the navigation), and you want these changes included in the print page.\n\n> If you have no `plugins` entry in your config file yet, you'll likely also want to add the `search` plugin. MkDocs enables it by default if there is no `plugins` entry set.\n\n## Usage\n\n- Navigate to `/print_page/` or `print_page.html`\n- Export to standalone HTML (see [export to HTML](https://timvink.github.io/mkdocs-print-site-plugin/how-to/export-HTML.html))\n- Export to PDF using your browser using *File > Print > Save as PDF* (see [export to PDF](https://timvink.github.io/mkdocs-print-site-plugin/how-to/export-PDF.html))\n\n## Documentation\n\nAvailable at [timvink.github.io/mkdocs-print-site-plugin](https://timvink.github.io/mkdocs-print-site-plugin/).\n\n## Contributing\n\nContributions are very welcome! Start by reading the [contribution guidelines](https://timvink.github.io/mkdocs-print-site-plugin/contributing.html).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MkDocs plugin that combines all pages into one, allowing for easy export to PDF and standalone HTML.",
"version": "2.8",
"project_urls": {
"Homepage": "https://github.com/timvink/mkdocs-print-site-plugin"
},
"split_keywords": [
"mkdocs",
" plugin",
" print",
" pdf"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3f3e7513f2f37c563da65d1b91781e047f4a1c0ceac8206d4f6042428428e4ad",
"md5": "24adbe00b20bc1991995ecc040deba4f",
"sha256": "838bd0a9b7141c11c0f1fdaa51ffe70c35740bec1f07c0806f8018e92f93f9da"
},
"downloads": -1,
"filename": "mkdocs_print_site_plugin-2.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "24adbe00b20bc1991995ecc040deba4f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 21477,
"upload_time": "2025-08-03T14:15:06",
"upload_time_iso_8601": "2025-08-03T14:15:06.301647Z",
"url": "https://files.pythonhosted.org/packages/3f/3e/7513f2f37c563da65d1b91781e047f4a1c0ceac8206d4f6042428428e4ad/mkdocs_print_site_plugin-2.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a9185c71f48b83191fb30cc58617fea20f56647eaa6cafd06a7fb34c738c5acb",
"md5": "1d656d2556e89a4e4e281a5b1b25255f",
"sha256": "ab1c89cdb468352975e3bb3bb0ef25dcc2bb88931b03f173206dc95ab02f843f"
},
"downloads": -1,
"filename": "mkdocs_print_site_plugin-2.8.tar.gz",
"has_sig": false,
"md5_digest": "1d656d2556e89a4e4e281a5b1b25255f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 231688,
"upload_time": "2025-08-03T14:15:07",
"upload_time_iso_8601": "2025-08-03T14:15:07.579590Z",
"url": "https://files.pythonhosted.org/packages/a9/18/5c71f48b83191fb30cc58617fea20f56647eaa6cafd06a7fb34c738c5acb/mkdocs_print_site_plugin-2.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-03 14:15:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "timvink",
"github_project": "mkdocs-print-site-plugin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mkdocs-print-site-plugin"
}
