git.guelker.eu epp / master
master

Tree @master (Download .tar.gz)

                                E.P.P.
                                ------

E.P.P. ist mein persönliches E-Reader-Präparations-Programm. Dieses
Programm verarbeitet Texte der gängigen juristischen (Fach-)Webseiten
so, daß man sie auf einem E-Reader mit dem alternativen E-Reader
KOReader (siehe <https://koreader.rocks/>) gut lesen kann.

Es handelt sich um „work in progress“. Ziel des Programms ist es,
meine persönlichen Bedürfnisse im Bereich des Lesens von juristischen
Fachtexten, namentlich Urteilen und Aufsätzen, zu erfüllen. Diese
Anforderungen lauten:

1. Lesbarkeit des Texts. Das Layout juristischer Fachwebseiten ist
   kaum je mit Blick auf Lesbarkeit gestaltet worden.
2. Ausgabe der Texte im HTML-Format, um dem E-Reader den bestmöglichen
   Ausgangspunkt für das Layout zu geben.
3. Möglichst minimalistisches CSS, um auch hier dem E-Reader die
   wesentliche Arbeit (die er meist selbst am besten kann) zu
   überlassen.
4. Deutliche Sichtbarkeit von Randnummern.
5. Verlinkung von Fußnoten oder -- präferiert -- Darstellung als Randnotiz.
6. Inhaltsverzeichnis, das KOReader versteht.
7. Sinnvolle Informationen im Dokumenttitel, um einen guten Überblick
   in der Datei-Auflistung in KOReader zu erhalten.

Die obigen Anforderungen sind derzeit noch nicht alle erfüllt. Es
handelt sich insoweit um Ziele.

Das Programm kann nur mit Quelldaten umgehen, deren Format
implementiert worden ist. Da Webseiten ihre Gestaltung gelegentlich
ändern, kann es sein, daß E.P.P. dann fehlerhafte Dokumente
produziert. In diesem Fall sollte eine Aktualisierung von E.P.P. das
Problem beheben.

                           -- Benutzung --

E.P.P. ist ein Kommandozeilenprogramm. Einzelheiten zur Nutzung können
in der Handbuchseite epp(1) nachgelesen werden (im Quellenverzeichnis
unterhalb von doc/ zu finden).

Folgendes Beispiel erstellt ein E-Reader-fähiges Dokuments direkt von
einer öffentlich zugänglichen Webseite:

$ epp -t bverfg \
      -o metall-auf-metall.html \
      -O "title:Metall auf Metall" \
      https://www.bundesverfassungsgericht.de/SharedDocs/Entscheidungen/DE/2016/05/rs20160531_1bvr158513.html

Ist eine Webseite nicht öffentlich zugänglich, kann E.P.P. auf
heruntergeladenes HTML angewandt werden:

$ epp -t bverfg \
      -o metall-auf-metall.html \
      -O "title:Metall auf Metall" \
      eingabe.html

                             -- Lizenz --

Copyright © 2019 Marvin Gülker.

Dieses Programm kann durch jedermann gemäß den Bestimmungen der
Deutschen Freien Software Lizenz genutzt werden.

Die Lizenz kann unter <http://www.d-fsl.de> abgerufen werden.

This Program may be used by anyone in accordance with the terms of the
German Free Software License.

The License may be obtained under <http://www.d-fsl.org>.