README.md 1.26 KB
Newer Older
Michael Murtaugh's avatar
Michael Murtaugh committed
1 2 3
etherdump
=========

Michael Murtaugh's avatar
Michael Murtaugh committed
4
Tool to publish [etherpad](http://etherpad.org/) pages to files.
Michael Murtaugh's avatar
Michael Murtaugh committed
5 6 7 8 9


Requirements
-------------

Michael Murtaugh's avatar
Michael Murtaugh committed
10 11
	* html5lib
	* python-datutil, jinja2 (index subcommand)
Michael Murtaugh's avatar
Michael Murtaugh committed
12

Michael Murtaugh's avatar
readme  
Michael Murtaugh committed
13 14 15 16

Installation
-------------

Michael Murtaugh's avatar
Michael Murtaugh committed
17
    pip install python-dateutil jinja2 html5lib
Michael Murtaugh's avatar
Michael Murtaugh committed
18
    python setup.py install
Michael Murtaugh's avatar
readme  
Michael Murtaugh committed
19

Michael Murtaugh's avatar
Michael Murtaugh committed
20 21 22 23 24 25 26
Example
---------------
	mkdir mydump
	cd myddump
	etherdump init

The program then interactively asks some questions:
Michael Murtaugh's avatar
Michael Murtaugh committed
27

Michael Murtaugh's avatar
Michael Murtaugh committed
28 29 30 31 32
	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
Michael Murtaugh's avatar
Michael Murtaugh committed
33

Michael Murtaugh's avatar
Michael Murtaugh committed
34
The settings are placed in a file called .etherdump/settings.json and are used (by default) by future commands.
Michael Murtaugh's avatar
Michael Murtaugh committed
35 36 37



Michael Murtaugh's avatar
Michael Murtaugh committed
38
subcommands
Michael Murtaugh's avatar
Michael Murtaugh committed
39 40
----------

Michael Murtaugh's avatar
Michael Murtaugh committed
41 42
* init
* pull
Michael Murtaugh's avatar
Michael Murtaugh committed
43 44
* list
* listauthors
Michael Murtaugh's avatar
Michael Murtaugh committed
45
* gettext
Michael Murtaugh's avatar
readme  
Michael Murtaugh committed
46
* settext
Michael Murtaugh's avatar
Michael Murtaugh committed
47 48
* gethtml
* creatediffhtml
Michael Murtaugh's avatar
Michael Murtaugh committed
49
* revisionscount
Michael Murtaugh's avatar
Michael Murtaugh committed
50
* index
Michael Murtaugh's avatar
readme  
Michael Murtaugh committed
51
* deletepad
Michael Murtaugh's avatar
Michael Murtaugh committed
52

Michael Murtaugh's avatar
Michael Murtaugh committed
53
To get help on a subcommand:
Michael Murtaugh's avatar
Michael Murtaugh committed
54

Michael Murtaugh's avatar
Michael Murtaugh committed
55
	etherdump revisionscount --help
Michael Murtaugh's avatar
Michael Murtaugh committed
56

Michael Murtaugh's avatar
Michael Murtaugh committed
57 58 59 60 61 62 63 64 65 66

Change log / notes
=======================

Originally designed for use at: [constant](http://etherdump.constantvzw.org/).


17 Oct 2016
-----------------------------------------------
Preparations for [Machine Research](https://machineresearch.wordpress.com/) [2](http://constantvzw.org/site/Machine-Research,2646.html)
67