#+title: Grundregeln für  EWS 3.0

Hier entsteht das neue Grundregelwerk für EWS 3.0 ( http://www.1w6.org ).

- Texte: ews.org
- Cover: ewstitle.tex
- LaTeX-Setup: ews30setup.tex
- Emacs-Setup für den Export: ews30setup.el

* Bearbeiten

: ./edit.sh

* Bauen

: ./autogen.sh; make

erzeugt ews.pdf und ews.html

Aus Release-Archiv (tarball) oder ohne autoconf+automake:

: ./configure; make

* Veröffentlichen

- Version aktualisieren: configure.ac und ewstitle.tex
- Wichtigste Änderungen notieren: NEWS
- Sicherstellen, dass alle Bilder und TeX-Dateien in configure.ac AC_CONFIG_LINKS stehen.

: ./autogen.sh; ./configure; make distcheck && make release

- Erstelltes Archiv weitergeben.

* Benötigt

- Emacs: http://gnu.org/s/emacs (Windows: http://www.gnu.org/software/emacs/download.html )
- Make: http://gnu.org/s/make (Windows: http://www.mingw.org/wiki/MSYS oder http://gnuwin32.sourceforge.net/packages/make.htm )
- Mercurial: http://www.mercurial-scm.org
- eine LaTeX-Umgebung mit pdflatex und memoir. Z.B. texlive (GNU/Linux: https://tug.org/texlive/) oder MiKTeX (Windows: http://miktex.org/ )
- pdfgrep für ews-cheat-sheet-taschenformat.pdf: https://pdfgrep.org/

* Bilder

Die PNGs sind händisch verkleinert mit Posterisierung via [[http://imagemagick.org][imagemagick]]:

: convert BILD.png -auto-level -posterize 16 BILD-converted.png ; pngquant BILD-converted.png

Pass das Posterisierungslevel auf den niedrigsten Wert an, bei dem du keinen Unterschied zwischen BILD.png und =BILD-converted-fs8.png= siehst.

* Reproduzierbarkeit prüfen

#+begin_src bash
make ews.pdf && \
sha256sum ews.pdf > reproducibility-check-state1 && \
make -B ews.pdf && \
sha256sum ews.pdf > reproducibility-check-state2 && \
cat reproducibility-check-state[12] && \
diff -u reproducibility-check-state[12] && \
rm reproducibility-check-state[12]
#+end_src

Der tarball kann nicht reproduzierbar sein, weil chargen.pdf zufällig erzeugte Charaktere enthält.
