Hi, Can anyone on this list recommend a good style guide for formatting technical documentation (HOWTOs related to CentOS servers) using ASCII text only ? Markdown and/or AsciiDOC are *not* an option, since these documents should be easily readable in a text console. Cheers from the sunny South of France, Niki -- Microlinux - Solutions informatiques durables 7, place de l'?glise - 30730 Montpezat Site : https://www.microlinux.fr Blog : https://blog.microlinux.fr Mail : info at microlinux.fr T?l. : 04 66 63 10 32 Mob. : 06 51 80 12 12
On Fri, 6 Nov 2020 07:37:26 +0100 Nicolas Kovacs wrote:> Can anyone on this list recommend a good style guide for formatting technical > documentation (HOWTOs related to CentOS servers) using ASCII text only ?Lyx article and export the result as plain text? That would kind of force a pretty robust format onto your document. -- Can we uninstall 2020 and install it again? This one has a virus. MELVILLE THEATRE ~ Real D 3D Digital Cinema ~ www.melvilletheatre.com
Am 06.11.20 um 07:37 schrieb Nicolas Kovacs:> Hi, > > Can anyone on this list recommend a good style guide for formatting technical > documentation (HOWTOs related to CentOS servers) using ASCII text only ? > > Markdown and/or AsciiDOC are *not* an option, since these documents should be > easily readable in a text console. >pandoc can output to plain text. Markdown > plain text. -- Leon
Stephen John Smoogen
2020-Nov-06 14:43 UTC
[CentOS] Style Guide for ASCII Text Documents ?
On Fri, 6 Nov 2020 at 01:38, Nicolas Kovacs <info at microlinux.fr> wrote:> Hi, > > Can anyone on this list recommend a good style guide for formatting > technical > documentation (HOWTOs related to CentOS servers) using ASCII text only ? > > Markdown and/or AsciiDOC are *not* an option, since these documents should > be > easily readable in a text console. > >At this point, there isn't going to be a good style guide, because both of those formats are considered by various groups to be easy to read on a text console. [Same with Python RST and anything listed on https://en.wikipedia.org/wiki/Lightweight_markup_language ]. What I am meaning is that a lot of formatting comes down to the eye of the beholder and I have yet to find 12 people who agree on any layout as being pleasing. [Which was why at one job we had 4 nroff filters for a set of reports back even into the 2000's. Each one processed man pages and other documents into a format that meets various groups 'needs for proper documentation.' In the end, I would say choose a layout language you need and work out a filter for pandoc or nroff or <fill in what you chose> to process it into what is aesthetically pleasing for your audience.> Cheers from the sunny South of France, > > Niki > -- > Microlinux - Solutions informatiques durables > 7, place de l'?glise - 30730 Montpezat > Site : https://www.microlinux.fr > Blog : https://blog.microlinux.fr > Mail : info at microlinux.fr > T?l. : 04 66 63 10 32 > Mob. : 06 51 80 12 12 > _______________________________________________ > CentOS mailing list > CentOS at centos.org > https://lists.centos.org/mailman/listinfo/centos >-- Stephen J Smoogen.