Prezentprogramo 3.2

Makes impress.js presentations from reStructuredText

Prezentprogramo

Prezentprogramo is a tool to make impress.js presentations from reStructuredText. For a quick explanation, see one of my slides or check list of them https://yoosofan.github.io/slide/

Based on Hovercraft!

Features

• Write your presentations in a text markup language. No slow, limiting GUI, no annoying HTML!

• Pan, rotate and zoom in 3D, with automatic repositioning of slides!

• A presenter console with notes and slide previews!

• Support for showing mathematical formulas.

• Styling is easy with CSS.

• The slide show generated is in HTML, so you only need a web browser to show it.

• Easy sharing, as it can be put up on a website for anyone to see!

Full documentation of Hovercraft is available at https://hovercraft.readthedocs.io/en/latest/ , and also in the documentation subdirectory.

Installation

Simple but not the best way to install

pip3 install prezentprogramo

It is better to follow the following steps instead because there will be less problems in the long run.

Prepare Environment

These steps can be done once. You don’t need to repeat them unless you really need to.

uv is a Python package and project manager. Using uv has multiple benefits including installing any version of python3 and related packages on it. uv can reduce many conflicts and problems you may face if you use pip alone. While it is not necessary but I would recommend to use it instead of pip.

1. Install the latest python3

   1. uv

      # First install curl from
      # https://curl.se/download.html
      # Instead on any debian based linux use the following command
      # apt install curl
      
      curl -LsSf https://astral.sh/uv/install.sh | sh
      
      # update uv periodically
      
      uv self update

   1. Install python3

      uv python install 3.13.7

2. It is better to use virtual environment in python3

   1. Create virtual environment

      1. Using uv

         uv venv --python 3.13.7 myvenv

      2. Pure python

         python -m venv myvenv

   2. Activate virtual environment whenever you want to use prezentprogramo

      source myvenv/bin/activate

Install Prezentprogramo

1. Use the latest changes in github repository

   1. Download Prezentprogramo repository to a directory, like ~/path/prezentprogramo

   2. Install Prezentprogramo by

      1. uv

         uv tool install ~/path/prezentprogramo/

      2. Or pip

         pip install ~/path/prezentprogramo/

2. Or use pypi.org

   1. uv

      uv tool install prezentprogramo

   2. Or pip

      pip3 install prezentprogramo

Prezentprogramo requires Python 3 and can be installed like any Python package.

It is better to use virtual environment:

$ cd ~/virtual_environment/path/
$ python -m venv myvenv
$ source myvenv/bin/activate

The easiest way to install prezentprogramo is by using pip and git, then run:

$ pip3 install git+https://github.com/yoosofan/prezentprogramo

Or download the code in a directory let’s name it ~/path/prezentprogramo/ then:

$ pip3 install ~/path/prezentprogramo/

or

$ python3 -m pip install ~/path/prezentprogramo/

Use prezentprogramo:

$ prezentprogramo prezentprogramo/docs/examples/tutorial.rst

It will automatically open browser if it is possible. If the browser did not open then run your browser and type the following link in your browser

Then you can deactivate virtual environment:

$ deactivate

Prezentprogramo creates a directory by the name of slide if it possible. However, Ii is possible to create a seperate directory too. For Example you can use my computer courses slide <https://github.com/yoosofan/slide>_ to test it

cd projects/slide/os
prezentprogramo cpu.rst cpu_htmls/

Convert to pdf

Install google-chrome

prezentprogramo cpu.rst --pdf cpu.pdf

Old methods for hovercraft

Run hovercraft

cd os
prezentprogramo mem.rst

###  Run browser

### Type 127.0.0.1:8000

Mothods

Screen Shot

1. Take screen shot by operating system

   1. for ubuntu-mate use short cut < Shift + PrtSc >

   2. Select the area

   3. Save

2. Or use browser screenshot

   1. like https://browsernative.com/screenshot-extension/

3. convert images to pdf

   1. Install tools lilke image magic

   2. sudo apt-get install imagemagick –fix-missing

   3. link https://help.ubuntu.com/community/ImageMagick

   4. convert *.png mem1.pdf

dectape: Convert to pdf

https://github.com/astefanutti/decktape

https://awesomeopensource.com/project/astefanutti/decktape?categoryPage=29

Installation

sudo apt update
sudo apt install nodejs
sudo npm install -g npm@latest
sudo npm install puppeteer --unsafe-perm
# export PUPPETEER_SKIP_DOWNLOAD='true'  #npm i puppeteer
sudo npm install -g decktape

npm install decktape
`npm bin`/decktape

https://github.com/puppeteer/puppeteer/issues/5656#issuecomment-641412196 https://stackoverflow.com/questions/63187371/puppeteer-not-able-to-install-error-failed-to-set-up-chromium-r782078-set-pu

ls -l /etc/apt/sources.list.d/
ls -l /usr/share/keyrings/

rm  /usr/share/keyrings/nodesource.gpg
rm /etc/apt/sources.list.d/nodesource.list.save

https://unix.stackexchange.com/questions/541939/whats-going-wrong-with-my-attempt-to-install-upgrade-node-js-in-linux

# Using Ubuntu
curl -k -fsSL https://deb.nodesource.com/setup_15.x | sudo -E bash -
curl -k -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt-get install -y nodej

sudo apt-get remove nodejs npm node
sudo apt-get purge nodejs

sudo rm -rf /usr/local/bin/npm
sudo rm -rf /usr/local/share/man/man1/node*
sudo rm -rf /usr/local/lib/dtrace/node.d
sudo rm -rf ~/.npm
sudo rm -rf ~/.node-gyp
sudo rm -rf /opt/local/bin/node
sudo rm -rf opt/local/include/node
sudo rm -rf /opt/local/lib/node_modules

sudo rm -rf /usr/local/lib/node*
sudo rm -rf /usr/local/include/node*
sudo rm -rf /usr/local/bin/node

Instructions

`npm bin`/decktape --slides 1-70 --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/ ~/os922.pdf
decktape --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/ ~/os915.pdf
decktape --slides 1,111-273 --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/ ~/os913.pdf
decktape --slides 1-120 --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/     ~/830.pdf
decktape --slides 1-120 --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/     ~/d/830.pdf
decktape --slides 1-111 --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/     ~/901.pdf
decktape impress http://127.0.0.1:8000/ ~/test/f4.pdf
decktape --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/ ~/test/dectape/f1.pdf
decktape --slides 1,2,3 --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/ ~/test/dectape/f2.pdf
decktape --slides 1,13,116,117 --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/ ~/test/dectape/f3.pdf
decktape --chrome-path /usr/bin/google-chrome impress http://127.0.0.1:8000/ ~/test/dectape/f4.pdf

Errors “decktape” “TimeoutError:” Navigation timeout of 20000 ms exceeded

• https://giters.com/astefanutti/decktape/issues/224

• https://github.com/astefanutti/decktape/blob/9874f9e708b3eebcfa7e3061b591070e395c1fb3/decktape.js#L220

• https://github.com/puppeteer/puppeteer/issues/782

• https://ourcodeworld.com/articles/read/1106/how-to-solve-puppeteer-timeouterror-navigation-timeout-of-30000-ms-exceeded

• https://www.bountysource.com/teams/decktape/issues

• https://www.barelysignificant.com/IMSB2020/slides/Cours05#/79

Samples

# Capture a single slide
$ decktape --slides 1
# Capture a series of slides
$ decktape --slides 1,3,5
# Capture a range of slides
$ decktape --slides 1-10
# Capture a combination of slides and ranges
$ decktape --slides 1,2,5-10
$ decktape --slides 1,2,5-10 -s 1024x768