This is meant to be a simple example document that is easily readable so that it can be used as a learning tool to get up and running with groff very quickly.
I come form using markdown as well as LaTeX so this document is written with the point of view of someone looking for an alternative to LaTeX for professional looking documents.
I also just wanted to experiment with groff because I like retro computing and typesetting and the idea of using a typesetting system that is older than me to make documents just excites me a little bit.
This document will not go into depth on advanced features of groff like macros but I will attempt to address most features that can be found in markdown.
- lists and bullets
- images
- figures and diagrams using PIC
- equations
- references
- block-quotes
- cover-page features
- headers and footers
- page numbering
- basic formatting (bold, italic, etc)
- code listings
- tables
- table of contents
- compilation and PDF output
- a short section containing helpful resource
- a simple guide on how to optimize your workflow and layout a project folder for a document
- convert into a short document that expalins everythin on starting with groff.
- strip back the example document and split into a few samller ones with increasing complexity
- use more meaningful text in the examples
- better organization of the sections