karchnu
/
groff-template
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
This repository is a template for troff documents. Here is the product, once compiled: https://t.karchnu.fr/doc/grofftut.pdf
10 Commits
2 Branches
0 Tags
315 KiB
Roff 64.1%
Perl 19.2%
Shell 10.4%
Makefile 6.3%
 
 
 
 
Go to file
Karchnu e4eb27bf93 Add README. 2022-01-07 09:40:44 +01:00
bin First commit. 2021-10-11 05:57:55 +02:00
.source-highlight_groff-output-definition First commit. 2021-10-11 05:57:55 +02:00
Makefile main -> grofftut 2021-10-29 04:43:52 +02:00
Makefile.in Makefile: -M ~ (troffrc in home dir) + new macros 2021-12-16 00:57:08 +01:00
README.md Add README. 2022-01-07 09:40:44 +01:00
are-you.pdf First commit. 2021-10-11 05:57:55 +02:00
bibliography First commit. 2021-10-11 05:57:55 +02:00
grofftut.ms grofftut: hdtbl 2021-12-16 00:58:20 +01:00
header.ms Header: date fixed. 2022-01-07 09:40:32 +01:00
macros.ms New macros. 2022-01-07 09:40:23 +01:00

README.md

Troff template (batteries included)

This repository is an introduction to the good old tools to produce documents:

  • roff as the language to describe documents (groff is the implementation)
  • tbl and hdtbl for tables
  • pic for drawing images
  • grap for drawing graphs
  • refer for handling references and bibliography
  • etc.

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-highlight software and a script)
  • A makefile to automatically call every tool in right order; just type make!

Preview

https://t.karchnu.fr/doc/grofftut.pdf

Limitations

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.