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