[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Using texinfo for works that are not software-related

From: Oleander
Subject: Re: Using texinfo for works that are not software-related
Date: Wed, 30 Aug 2023 06:54:45 +0000

As far as I know latex3 does not support exporting to html, epub,
ascii and I need those formats. I should have explained it better but
I don't need all the formatting options latex offers since I mostly
write prose with some code/quote blocks.

By "good things" I meant semantic elements, indexes, cross references.

I've explored other markup languages but I've always been on the fence
about those and I keep switching.

Markdown does not support indexes so I tend to exclude it for long

Org Mode is great but it lacks semantic elements besides blocks.

Asciidoc: good markup syntax and support semantic elements but I read
the tooling leaves something to be desired.

Restructured text: great tooling but I don't like the syntax of some

As regards at least sys admin documentation which is not only
software-related (bureaucratic stuff) and general prose, would you still recommend texinfo?

-------- Original Message --------
On Aug 30, 2023, 04:52, Christopher Dimech <> wrote:

Sent: Wednesday, August 30, 2023 at 9:01 AM From: "Oleander" <> To: Subject: Re: Using texinfo for works that are not software-related Correction: sys admin documentation is related to software obviously. -------- Original Message -------- On Aug 29, 2023, 22:22, Oleander <> wrote: Hello everyone! > Does texinfo suit other works that are not software-related like sys > admin documentation, lectures, long essays, fictional/non fictional > books? From what I've read in the manual so far, it is possible to > produce some of them but would you recommend it? Chapter 1 states: >> Texinfo was devised specifically for the purpose of writing software >> documentation and manuals. If you want to write a good manual for >> your program, Texinfo has many features which we hope will make your >> job easier. However, Texinfo is not intended to be a general-purpose >> formatting program. > If not, what markup do you prefer for works that are not > software-related, without missing most of the good things texinfo > provides? In its current state, I would not recommend it. Use latex3 from the Latex Project ( One can use colour, images can be made floating, and everything works much better. Texinfo is still mostly based on tho old tex substrate, and does not work very well for non software documentation related things.  
reply via email to

[Prev in Thread] Current Thread [Next in Thread]