pppadump

Bunch of scripts to extract documents from an etherpad instance and produce templated static files.

Forked from constant's active archives etherdump mixed with logic devised for varia's etherpump project.

It's all about __MAGICWRORDS__ 🪄✨

Requirements / dependencies

* python3 / pip3
* html5lib
* requests
* python-dateutil, 
* jinja2

Installation

pip3 install python-dateutil jinja2 html5lib
python setup.py install

Usage

mkdir mydump
cd myddump
pppadump init

The program then interactively asks some questions:

Please type the URL of the etherpad: 
	http://automatist.local:9001/
The APIKEY is the contents of the file APIKEY.txt in the etherpad folder
Please paste the APIKEY: 
	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The settings are placed in a file called .pppadump/settings.json and are used (by default) by future commands.

pppadump list

You should see a list of pads.

subcommands

• init
• pull
• list
• listauthors
• gettext
• settext
• gethtml
• creatediffhtml
• revisionscount
• index
• deletepad
• pushhtml

To get help on a subcommand:

pppadump revisionscount --help

Magicwords

Following the suggestions of sister project/friendly fork etherpump, the magic word mechanism has been expanded (from the inital single hard coded __NOPUBLISH__ value) to and generalized to allow a the use of text markers in the source text to control various options, including options for use in preprocessing and translation of markdown using pandoc.

Originally designed for use at: constant.