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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for mkdocs-print-site-plugin-2.3.4.tar.gz
Algorithm Hash digest
SHA256 40c8c918a58f66c1f44b97512433fefd28a7ae74f8aa6c1633ddf14a6c04aa7f
MD5 7265e7c7102d08f678b16e4082777b7a
BLAKE2b-256 38a97247ca8846172e9b86c2e0e254c324106bae6801781dcca01c0123069950

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mkdocs_print_site_plugin-2.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a74540cc3098695ae4623effc2c0be1631d0d1061344dcce283e775044cca0b4
MD5 b3307524f3e140e77d858628344ab40f
BLAKE2b-256 055ea84a74f6b29ead31c449d48162feba4da26968886d4b7faa61daa4c1d3c7

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