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.3.5.tar.gz (24.3 kB view details)

Uploaded Source

Built Distribution

mkdocs_print_site_plugin-2.3.5-py3-none-any.whl (30.4 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for mkdocs-print-site-plugin-2.3.5.tar.gz
Algorithm Hash digest
SHA256 f7a1e8b67092547273cf2da9a7cbf6e179c86c65c3ef5af293e5bb78323d645c
MD5 fb212229f05921855ee573c29dc14d6e
BLAKE2b-256 647983eebfaa74eccdcec53c6cce01bd5a02a61645eaab7963f9515c890e82c4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mkdocs_print_site_plugin-2.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 0340561a1a0fd99c2a0966f6f5ca8b8d208a0c199049a8f936d3c20ccccf435c
MD5 eb671776cffca99a4154b76de0c2692a
BLAKE2b-256 5787d7b5eaa465e25af30ee2792c104349c7b74d0b65a41e18d9218ea9caad1d

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