Skip to main content

Sphinx extension to turn any web page into a lightweight presentation

Project description

You want to give a presentation. But you also want the material to be available in a plain reading format. In fact, you want to target the “looks good when read” rather than the presentation mode. And you want the minimum work.

This extension transforms any HTML page into an presentation by hiding unnecessary elements, increasing space between the sections, and adding a direct scroll (using left and right arrow keys) between sections.

Right now it is distributed as a Sphinx documentation generator extension since that’s how the authors use it, but minipres.js should be usable by others.

Examples:

Sphinx extension usage

Install:

pip install sphinx-minipres

Add to extensions:

extensions = [
  'sphinx_ext_minipres',
]

In any rendered page:

  • Add ?pres to the URL to go into slideshow mode

  • Add ?plain to go into “plain” mode - no scrolling, but remove unnecessary elements from the page (most useful for sphinx_rtd_theme)

  • Add &h=3 (or so on) to the URL to select the highest (or lowest actually) heading to use as each section

In the slideshow mode, you can use the left and right arrow keys to navigate.

Independent usage

The sphinx extension simply copies minipres.js to the build and includes it - there is not much Sphinx specific here.

On an unrelated website with it hard coded, minipres can be loaded dynamically from the browser console x = $.getScript('/path/to/minipres.js') and then started with minipres()

Development status

Alpha and works. However, it needs to be adapted to work for each theme/page style, which will limit its usefulness. Currently removes unneeded elements on sphinx_rtd_theme but the core scrolling probably works on others.

See also

Please let me know if you know of other tools such as this.

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

sphinx_minipres-0.2.1.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

sphinx_minipres-0.2.1-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

File details

Details for the file sphinx_minipres-0.2.1.tar.gz.

File metadata

  • Download URL: sphinx_minipres-0.2.1.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6

File hashes

Hashes for sphinx_minipres-0.2.1.tar.gz
Algorithm Hash digest
SHA256 3cef3fa842c57e0f447dd26c1efe5d3150de815cac76c72c12ce777bbd6a515a
MD5 7b6986e2c39f243843d7463c4255bd8a
BLAKE2b-256 04a5d08fe1d46c3724f7b74fbf095aaf057eb4bb8e72a1dfd3c2933338d22fc6

See more details on using hashes here.

File details

Details for the file sphinx_minipres-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: sphinx_minipres-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 5.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6

File hashes

Hashes for sphinx_minipres-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6eecc74d2c0a2176c5249c90c730e592dcfdb539e75251d766ee1a50bf8ca4a2
MD5 b52d555846d7f587face0e7cf61f6e9f
BLAKE2b-256 0644de84f145599c971fd66bcc9cc859e54709aade5f5242b7527737d38710e6

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