Skip to main content

Termage

See the docs for some live examples.

Termage allows you to generate up-to-date, reproducible and real screenshots of Python output while building your documentation. It uses PyTermGUI to create the SVGs, and pre-processes your markdown file into a codefences format.

Code Output

Installation

Termage is best installed using pip:

$ pip install mkdocs-termage-plugin

This installs the plugin, as well as PyTermGUI as a dependency. By this point you probably should already have mkdocs installed.

Setup

To use the plugin, you should first add it to your mkdocs.yml plugin list:

plugins:
    - termage

Latest release

0.6.0 - 2022-08-22

Additions

  • Add support for inserting SVGs inline, without writing files

Refactors

  • Unify the codeblock-formatting API under execution.format_codeblock
  • Rewrite & refactor most of the plugin to be more maintainable
  • Refactor the Python API so that the termage function is called by the CLI, not the other way around.

Read the full changelog here.

Metadata

Release files for Termage 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Termage 0.6.0
File Size Uploaded
termage-0.6.0.tar.gz 3.0 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for Termage 0.6.0
File Interpreter ABI Platform
termage-0.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 3.0 MB

Release files / termage-0.6.0.tar.gz

Download URL termage-0.6.0.tar.gz
Size 3.0 MB
Tags Source
SHA-256 checksum
How to use checksums
2a7d11c22002d0cf4f53df41527b685e5529c8c6757a05cab9ed9df17808dc8e
BLAKE2b-256 checksum
How to use checksums
b8521603d31f9a837e5bd6759dcb1c8037a8b6eeb5146221b90abe18bd0a8179
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-httpx/0.22.0

Release files / termage-0.6.0-py3-none-any.whl

Download URL termage-0.6.0-py3-none-any.whl
Size 9.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
67f3cce369ef9ea2fea2fdba15858c73e232bc27b1ed15000ff1337850774efd
BLAKE2b-256 checksum
How to use checksums
e18797a1da06a275209fc445052a3733a6523606b7eee97ab237d20f6fd58bde
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-httpx/0.22.0

Release history Release notifications | RSS feed

This release

0.6.0 This release

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page