Skip to main content

MkDocs plugin that combines all pages into one, allowing for easy export to PDF and standalone HTML.

Project description

Actions Status PyPI - Python Version PyPI PyPI - Downloads codecov GitHub contributors PyPI - License

mkdocs-print-site-plugin

MkDocs 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.

Features :star2:

  • Support for mkdocs-material theme, including features like instant loading and dark color themes.
  • Support for pagination in PDFs.
  • Many options to customize appearance
  • Option to add a cover page
  • Lightweight, no dependencies.

Setup

Install the plugin using pip3:

pip3 install mkdocs-print-site-plugin

Next, add the following lines to your mkdocs.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)
  • Export to PDF using your browser using File > Print > Save as PDF (see export to PDF)

Documentation

Available at timvink.github.io/mkdocs-print-site-plugin.

Contributing

Contributions are very welcome! Start by reading the contribution guidelines.

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

mkdocs-print-site-plugin-2.2.2.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

mkdocs_print_site_plugin-2.2.2-py3-none-any.whl (25.2 kB view details)

Uploaded Python 3

File details

Details for the file mkdocs-print-site-plugin-2.2.2.tar.gz.

File metadata

  • Download URL: mkdocs-print-site-plugin-2.2.2.tar.gz
  • Upload date:
  • Size: 21.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.1

File hashes

Hashes for mkdocs-print-site-plugin-2.2.2.tar.gz
Algorithm Hash digest
SHA256 5594820d5dcf69f892019e871e21ee87e7f95f2f9e62ea48130fdc2f958adcc9
MD5 0273e681d3c6cedeaf643dcc8d7785d8
BLAKE2b-256 e6c2829d3a2fe41566f46b1de61c552c2c2f5b4287d5d21e1f4760be9e8dc523

See more details on using hashes here.

File details

Details for the file mkdocs_print_site_plugin-2.2.2-py3-none-any.whl.

File metadata

  • Download URL: mkdocs_print_site_plugin-2.2.2-py3-none-any.whl
  • Upload date:
  • Size: 25.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.1

File hashes

Hashes for mkdocs_print_site_plugin-2.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3da6dd4b3f681eecccdddbadbc7bf05ce571bde307e2c76a61de179567e0de70
MD5 82dbd238e37648b65b0248457c2113ad
BLAKE2b-256 a510635a7c2bed08dc798609c99781a367550ced50ad5e681f22576d128a1a3f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page