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:
minipres mode, vs normal page, vs plain mode. In minipres mode, try pushing left and right arrow keys.
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3cef3fa842c57e0f447dd26c1efe5d3150de815cac76c72c12ce777bbd6a515a |
|
MD5 | 7b6986e2c39f243843d7463c4255bd8a |
|
BLAKE2b-256 | 04a5d08fe1d46c3724f7b74fbf095aaf057eb4bb8e72a1dfd3c2933338d22fc6 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6eecc74d2c0a2176c5249c90c730e592dcfdb539e75251d766ee1a50bf8ca4a2 |
|
MD5 | b52d555846d7f587face0e7cf61f6e9f |
|
BLAKE2b-256 | 0644de84f145599c971fd66bcc9cc859e54709aade5f5242b7527737d38710e6 |