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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for mkdocs-print-site-plugin-2.3.6.tar.gz
Algorithm Hash digest
SHA256 82e5cabcfb7fe3074daecea018f28ccb4bff086f965e3103fe91019a76752f22
MD5 50011c10662b255824254f03d8056d1f
BLAKE2b-256 4dd54bc2c92048c19a42abb8db49a3a0b8693129baa20677c4aaf191493ea05e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mkdocs_print_site_plugin-2.3.6-py3-none-any.whl
Algorithm Hash digest
SHA256 01ccb1ceccc87f29e1612bebb77c3bf9980809fbce750fc2113f9d6acea589d4
MD5 f1909d0ff9ea9976eb4969f70e75a891
BLAKE2b-256 849e760eb38d54826a5678c175fef526755f8b66fc811d4013cde63dbc238474

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