-
Notifications
You must be signed in to change notification settings - Fork 1
groff
dozens edited this page Oct 3, 2024
·
3 revisions
uh oh dozens you're writing more groff bullshit last night on how to do a zine layout in groff in the finished version!
-pinhook
groff is a (mostly) linebased markup for typesetting and layout similar to LaTeX but much more lightweight.
it used to be used to create man pages, but mandoc
is better at that now
you can still use it to create papers, documents, and books.
07:48 dozens: yeah that's my take on it too. Trying to get deep into complicated, pretty, or modern layout and it just doesn't feel like the right tool
07:48 but if you just need black text on white paper in boxes for boring business shit like invoices or "reports" BOY does it work SO well
here are some "neat" things about groff:
- you basically can't get anything done in groff itself, so there are all these standard macro sets like
ms
andmom
that add ergonomics and stuff to it - there are these pre-processors like
eqn
,tbl
, andpic
so you can include mathematical equations, tables, and pictures in your document. - there are diversions (like m4) and 'traps' that you can spring with macros and distances (see:
.wh
and.ch
)
Resources:
- The GNU Troff Manual https://www.gnu.org/software/groff/manual/groff.html
- Tbl — A Program to Format Tables http://doc.cat-v.org/unix/v10/10thEdMan/tbl.pdf
- PIC — A Graphics Language for Typesetting, Brian W. Kernighan https://pikchr.org/home/uv/pic.pdf
- Writing a resume in groff https://noxz.tech/articles/writing_a_resume_in_groff/
- Pikchr (pronounced "picture") is a PIC-like markup language for diagrams in technical documentation https://pikchr.org/home/doc/trunk/homepage.md