|
General software and network General OS-independent software and network questions, X11, MTA, routing, etc. |
|
Thread Tools | Display Modes |
|
|||
Lightweight markup languages
I need to write some documentation for some Perl scripts. The command line options, the format of the initialization files, the networking requirements, the setup and running a test to verify the working.
What is your experience with any of the so-called 'Lightweight markup languages'? These are the ones I heard of: Any recommendation?
__________________
You don't need to be a genius to debug a pf.conf firewall ruleset, you just need the guts to run tcpdump Last edited by J65nko; 5th January 2016 at 03:22 AM. Reason: fixed typo |
|
||||
I use occasionally txt2tags when a quick html output is required. Normally I use TeX for writing papers. I would suggest you also check Pandoc which is written in Haskell. You can install it on OpenBSD using Cabal Haskell package manager since Pandoc is not in ports. Cabal is in ports and works very well on OpenBSD. Pandoc converts multiple documen (light mark up) formats into each other. For man pages I would use mandoc and mdoc macros written by Kristaps Dzonsons. Unlike Groff it supports html, PosrScript outputs and of course has beautiful Ascii output. Of course mandoc just like Groff and TeX is full blown text typing system and it doesn't have light learning curve. I will finish this post with the remark that TeX (my bread and butter) is not designed for Ascii or even HTML output. Man pages is one of those rare instances (besides Music for which I use LilyPond) where TeX is not a right tool for the job.
Last edited by Oko; 5th January 2016 at 08:29 PM. Reason: Original post was typed on Android phone and suffered numerous typographic errors. |
|
|||
Thanks to both of your for the feedback and suggestions.
At this moment I am writing a small test file in AsciiDoc, because it claims to be "semantically equivalent to DocBook XML". Many years ago I spent some time with DocBook, but although I liked it's possibilities, I found it too much of a hassle to use. Pandoc looks very interesting. I will definitely have a look at it.
__________________
You don't need to be a genius to debug a pf.conf firewall ruleset, you just need the guts to run tcpdump |
Tags |
asciidoc, markdown, markup language, txt2tags |
|
|
Similar Threads | ||||
Thread | Thread Starter | Forum | Replies | Last Post |
Package lists/Config files for Lightweight Desktop/Funding Option | shep | Feedback and Suggestions | 1 | 16th December 2013 07:24 PM |
Dynamic Languages Conference: it's an Edinburgh thing | J65nko | News | 0 | 15th August 2011 03:19 PM |
brief incomplete and mostly wrong history of programming languages | TerryP | Off-Topic | 2 | 9th May 2009 11:05 PM |
Need a lightweight browser to replace Fx3 | TerryP | General software and network | 15 | 12th February 2009 10:45 PM |