LinuxQuestions.org - Blog Entries

Helpful Debian Links

Posted 08-07-2021 at 12:15 PM by craigevil (craigevil's random words of wisdom)
Updated 09-14-2021 at 05:33 PM by craigevil (duplicate)

Tags debian, documentation, installer

duplicate post Sorry.

craigevil

Senior Member

Posted in Uncategorized

Views 610 Comments 1 craigevil is offline

(OOXML/XSL) Write man-pages in a modern text-processor

Posted 09-08-2018 at 12:56 AM by Michael Uplawski
Updated 09-08-2018 at 05:54 AM by Michael Uplawski (Corrections. Style sheet improved.)

Tags documentation, man, ooxml, restructuredtext, xsl

On the topic of writing man-pages as reStructuredText, see also simple-write-man-pages-docutils-and-tweaks (in this blog).
Introduction

In short, I have written an XSL-stylesheet to transform the XML-code from an OOXML document (M$ Word® format docx or SoftMaker®'s tmdx) into a reStructuredText file.

The current edition produces enough formatting for a man-page, although some enhancements should allow the inclusion of tables.

Text-Processor Templates

In the original OOXML

...

Michael Uplawski

Senior Member

Posted in Boundless Praise, Programming and creativity

Views 198 Comments 0 Michael Uplawski is offline

Wiki Site-books (RunBooks)

Posted 06-15-2010 at 11:23 PM by bits45
Updated 06-16-2010 at 01:00 AM by bits45

Tags documentation, runbook, wiki

Do you document your admin procedures? Tired of spending three hours learning how to configure something new or troubleshoot a problem, only to relearn all about it 11 months from now. Write the how-to in your own words so you understand it better.

We use MediaWiki servers for our run-books (site books). I'm not sure what "you" call them, but they are an invaluable asset to an aging team of developers and admin staff, like myself.

If you're not already using...

bits45

Member

Posted in Uncategorized

Views 987 Comments 0 bits45 is offline

Total Blogs

2,190

Total Entries

8,284

Entries in Last 24 Hours