||2 years ago|
|bin||2 years ago|
|.source-highlight_groff-output-definition||2 years ago|
|Makefile||2 years ago|
|Makefile.in||2 years ago|
|README.md||2 years ago|
|are-you.pdf||2 years ago|
|bibliography||2 years ago|
|grofftut.ms||2 years ago|
|header.ms||2 years ago|
|macros.ms||2 years ago|
Troff template (batteries included)
This repository is an introduction to the good old tools to produce documents:
roffas the language to describe documents (
groffis the implementation)
tbland hdtbl for tables
eqnfor math equations
picfor drawing images
grapfor drawing graphs
referfor handling references and bibliography
It also includes a few examples of custom macros and images.
Furthermore, this repository includes:
- UTF-8 characters translation into ms macros (via a script)
- source code highlight (via the
source-highlightsoftware and a script)
- A makefile to automatically call every tool in right order; just type
How to compile
groff installed on your system, and
source-highlight (or remove the right line in the makefile).
If you have
entr on your system, you can also recompile your file each time you modify it:
Read the makefile for more options.
(Read this document on a PDF viewer, not directly in your browser!)
Images are poorly handled, and they aren't easily managed with
roff by default.
Some macros exist to do it properly, but it still is to include in custom macros then to document.
Browser preview is ugly as fuck. It may have something to do with font embedding, I have to investigate, but right now you just can't have a nice preview on a browser.
Besides fixing minor problems (image inclusion, browser view), other tools should be tested: