bell notificationshomepageloginNewPostedit profile

Topic : Is there a definition for formatting plain text documents like they are on TLDP.org? Is there a formal specification for authoring plain text documents like they (mostly) are on http://www.tldp.org/HOWTO/text/? - selfpublishingguru.com

10.02% popularity

Is there a formal specification for authoring plain text documents like they (mostly) are on www.tldp.org/HOWTO/text/?
If so, what is it called? Where is it documented?

I'm looking for a guide/spec that would state the formatting rules like "break sections apart with the - character repeated the full length of the screen," etc. Basically I'm wondering if there's a manual I can read that outlines the rules for authoring documents like these in plain text, or if I should just do my best to mimic it.

Aside: I noticed that several of these text documents don't follow 100% exactly the same format, though they all look roughly alike. Are there different versions of this specification, or is this just personal preference by the authors?


Load Full (2)

Login to follow topic

More posts by @Gretchen741

2 Comments

Sorted by latest first Latest Oldest Best

10% popularity

It seems that the documents you refer to are not written directly in plain text. According to the TLDP FAQ the "HOWTOs are written in SGML or XML, and translated to different output formats using SGML-Tools (Linuxdoc DTD) or the DocBook/DSSSL tools."

I'm supposing then that the plain text output layout is specified by the tools themselves.

Linuxdoc DTD seems to be old tech, but there is a page here: Creating documentation with LinuxDoc that could give you a way forward.

Similarly, this page: DocBook Project gives information on DocBook.

Good luck with your search - I hope you find what you need.


Load Full (0)

10% popularity

Yes, there is the LDP Author's Guide, on LDP itself.


Load Full (0)

Back to top