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
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
23 Commits
1 Branch
0 Tags
289 KiB
 
 
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Go to file
Karchnu ec878ad01d
No number on the first section. 		2 years ago
bin Notes on troffrc + groff options. 2 years ago
.source-highlight_groff-output-definition First commit. 2 years ago
Makefile main -> grofftut 2 years ago
Makefile.in Remove uuoc and utf8 script filter (preconv just works). 2 years ago
README.md Readme: add neatroff and SILE. 2 years ago
are-you.pdf First commit. 2 years ago
bibliography First commit. 2 years ago
grofftut.ms No number on the first section. 2 years ago
header.ms Header: date fixed. 2 years ago
macros.ms Remove useless macros. 2 years ago

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
  • eqn for math equations
  • 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!

How to compile

You need groff installed on your system, and source-highlight (or remove the right line in the makefile).

Then:

make

If you have entr on your system, you can also recompile your file each time you modify it:

make serve

Read the makefile for more options.

Preview

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

(Read this document on a PDF viewer, not directly in your browser!)

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.

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.

TODO

Besides fixing minor problems (image inclusion, browser view), other tools should be tested:

  • neatroff: roff but with a modern implementation
  • SILE: not roff, but allows way more complex layouts while still remaining simple