iREADME.md - tgtimes - The Gopher Times Err bitreich.org 70 hgit clone git://bitreich.org/tgtimes git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/tgtimes URL:git://bitreich.org/tgtimes git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/tgtimes bitreich.org 70 1Log /scm/tgtimes/log.gph bitreich.org 70 1Files /scm/tgtimes/files.gph bitreich.org 70 1Refs /scm/tgtimes/refs.gph bitreich.org 70 1Tags /scm/tgtimes/tag bitreich.org 70 1README /scm/tgtimes/file/README.md.gph bitreich.org 70 i--- Err bitreich.org 70 iREADME.md (1711B) Err bitreich.org 70 i--- Err bitreich.org 70 i 1 The Gopher Times Err bitreich.org 70 i 2 ================ Err bitreich.org 70 i 3 Welcome to editor office of The Gopher Times. Err bitreich.org 70 i 4 Err bitreich.org 70 i 5 The newspaper uses Plan 9 version of troff(1). Install plan9port and Err bitreich.org 70 i 6 run `make` on Linux/BSD/... or run `mk` on Plan 9. Err bitreich.org 70 i 7 Err bitreich.org 70 i 8 ``` Err bitreich.org 70 i 9 opus - "v=1", or "v=2", ..., to maintain by hand Err bitreich.org 70 i 10 opus$v/article-*.mw - troff source of the articles included Err bitreich.org 70 i 11 opus$v/tgtimes$v.mw - the troff source that includes the articles Err bitreich.org 70 i 12 opus$v/tgtimes$v.pdf - working draft, pdf version (troff) Err bitreich.org 70 i 13 opus$v/tgtimes$v.txt - working draft, plain text version (nroff) Err bitreich.org 70 i 14 archive/YYYY-MM-DD/ - generated from opus$v with `mk publish` Err bitreich.org 70 i 15 archive/YYYY-MM-DD-errata1/ - archive/YYYY-MM-DD, copied by hand Err bitreich.org 70 i 16 ``` Err bitreich.org 70 i 17 Err bitreich.org 70 i 18 Dependencies Err bitreich.org 70 i 19 ------------ Err bitreich.org 70 i 20 * POSIX make Err bitreich.org 70 i 21 * u2ps for Postscript to PDF conversion: Err bitreich.org 70 i 22 https://github.com/arsv/u2ps Err bitreich.org 70 i 23 * Ghostscript for ps2pdf Err bitreich.org 70 i 24 * boxes for fancy ASCII textboxes: Err bitreich.org 70 i 25 https://github.com/ascii-boxes/boxes Err bitreich.org 70 i 26 https://boxes.thomasjensen.com/ Err bitreich.org 70 i 27 Err bitreich.org 70 i 28 Generating a document Err bitreich.org 70 i 29 --------------------- Err bitreich.org 70 i 30 `make` on Linux/BSD/... or `mk` will generate `opus$v/tgtimes$v.{pdf,txt}`. Err bitreich.org 70 i 31 For generating another document, run `make thedocument.pdf` for instance. Err bitreich.org 70 i 32 The main `tgtimes$v.mw` file has usually the header of the document, then Err bitreich.org 70 i 33 a list of `.so opus$v/article-[...].mw` to source each article. Err bitreich.org 70 i 34 Err bitreich.org 70 i 35 Publishing an edition Err bitreich.org 70 i 36 --------------------- Err bitreich.org 70 i 37 1. Run `make clean publish` or `mk publish` to create `YYYY-MM-DD/` from `opus$v`. Err bitreich.org 70 i 38 2. Update the version with `echo v=123 >opus` Err bitreich.org 70 i 39 3. Commit the changes and push. Err bitreich.org 70 i 40 Err bitreich.org 70 i 41 Publishing an errata Err bitreich.org 70 i 42 -------------------- Err bitreich.org 70 i 43 1. Run `cp -r YYYY-MM-DD YYYY-MM-DD-errata1` to prepare the new release. Err bitreich.org 70 i 44 2. Edit the files in the `opus$v` directory that match the publication. Err bitreich.org 70 i 45 3. Run `make YYYY-MM-DD-errata1/tgtimes$v.{pdf,txt}` to rebuild it. Err bitreich.org 70 i 46 4. Commit the changes and push. Err bitreich.org 70 .