mb
2c08a83739
|
1 year ago | |
---|---|---|
snapshots | 3 years ago | |
static | 2 years ago | |
templates | 2 years ago | |
INSTALL.md | 2 years ago | |
LICENSE.txt | 2 years ago | |
Makefile | 2 years ago | |
README.md | 1 year ago | |
octomode.py | 2 years ago | |
requirements.txt | 2 years ago | |
settings.py | 2 years ago |
README.md
octomode
work-in-progress
Octomode is a collective editing space for PDF making, using Etherpad, Paged.js and Flask.
Inspired by the multi-centered, tentacular cognition capabilities of the octopus, we imagined a space in which the artificial boundaries of writing and design can be crossed; where writing, editing and designing can be done in one environment simultaneously, allowing the format to influence the matter and vice-versa.
How to use octomode?
If you want to work collectively on making a PDF, you can use octomode. There is an instance installed here: https://octomode.vvvvvvaria.org/. You can write any name of in the input field, this will create a new octomode environment.
Working in octomode includes:
pad
: all materials for the PDF are collected here. (written in Markdown)stylesheet
: all CSS rules for the PDF are collected here (written in CSS)html
: render the lay out as a HTML (rendered with PyPandoc)pdf
: render the lay out as a PDF (rendered with Paged.js)
When creating a new environment, a few things happen:
- a pad is created for collecting the materials of your PDF. The name of the octomode environment will become the name of this pad. For example:
http://pad.vvvvvvaria.org/NAME.md
. - another pad is created for writing the stylesheet of your PDF. The name of the octomode environment will become the name of this pad, followed by .css. For example:
https://pad.vvvvvvaria.org/NAME.css
- If both pads were not created yet, a template is added to the pad. The main pad will get a Markdown template and the stylesheet pad a CSS template.
In case a pad was already made, you can copy the templates below and paste them at the top of your pads.
The PDFs are rendered using Paged.js, a free and open source JavaScript library "that paginates content in the browser to create PDF output from any HTML content. This means you can design works for print (eg. books) using HTML and CSS!" The project is maintained by the Coko Foundation. Paged.js adds not (yet) implemented CSS rules to the ones that browsers implemented already, expanding the possibilities to make lay outs for specific sections, place content in the margins of pages, and render indexes (amongst other things). The Paged.js documentation is very helpful and can be found here: https://pagedjs.org/documentation/.
Octomode Markdown template
---
title: tentacular thinking
language: en
---
# tentacular thinking
Octomode CSS template
@charset "utf-8";
@page{
size: A5;
}
@page:first{
background-color: pink;
}
body{
color: green;
}
section#cover{
page-break-after: always;
}
Note
When working with multiple people on one PDF it is recommended to use the same browser. CSS rules are rendered slightly differently on different browsers.
Continuums
Octomode resonates other software practices based on pad-to-PDF workflows or collective infrastructure, including:
- ethertoff http://osp.kitchen/tools/ethertoff/ by OSP
- ether2html http://osp.kitchen/tools/ether2html/ by OSP
- etherpash https://freeze.sh/_/2015/conversations/#mdsh by Freeze/Christoph Haag
- etherbox https://networksofonesown.constantvzw.org/ by Michael Murtaugh/Constant
- etherdump https://gitlab.constantvzw.org/aa/etherdump by Michael Murtaugh/Constant
- pad2print https://gitlab.com/Luuse/pad2print by Luuse
Install octomode
You can clone this repository to run octomode on your own computer or server.
git clone https://git.vvvvvvaria.org/varia/octomode.git
Install the dependencies.
All the python
dependencies are listed in requirements.txt
To install them, you can run:
make setup
This creates a virtual environment at .venv/
and installs all the dependencies here.
Next to this, you also need to install pandoc
.
sudo apt install pandoc
Now we need to configure octomode:
cd octomode
nano .env
Configure your environment, save the following configuration settings as to a file called .env
:
OCTOMODE_APPLICATION_ROOT=XXX
OCTOMODE_PORTNUMBER=XXX
OCTOMODE_PAD_URL=XXX
OCTOMODE_PAD_API_URL=XXX
OCTOMODE_PAD_API_KEY=XXX
- OCTOMODE_APPLICATION_ROOT: optional, default:
/
- OCTOMODE_PORTNUMBER: optional, default:
5001
- OCTOMODE_PAD_URL: optional, default:
https://pad.vvvvvvaria.org/
- OCTOMODE_PAD_API_URL: optional, default:
https://pad.vvvvvvaria.org/api/1.2.15/
- OCTOMODE_PAD_API_KEY: required, no default
(Note: You must provide a value for OCTOMODE_PAD_API_KEY
.)
make run
(runs the Flask application)
Open the application at port 5001
, for example: http://localhost:5001 or https://mydomainname.ext:5001.
Install octomode with an URL prefix
If you want to install octomode with an URL prefix, like https://mydomainname.ext/octomode/, then you can use the gunicorn WSGI.
If you have ran the make setup
command already, then gunicorn
is already installed.
Configure your application root URL in your .env
file.
You can simply run octomode now with the following command to run it with gunicorn
(and not the built-in Flask dev server):
make action
Dependencies
- pandoc
- python dependencies, see:
requirements.txt
Use octomode locally
It's recommended to use Firefox when working with octomode locally. Chrome or Chromium do not load external etherpads in iframes.