Wed, 18 May 2016 01:34:24 +0200 Ingo Schwarze <schwa...@usta.de> > Hi Predrag, > > Predrag Punosevac wrote on Tue, May 17, 2016 at 06:59:15PM -0400: > > > OpenBSD is shipped with the static webpage generator (sort of). > > It is called mandoc. man mandoc and check out -T html switch.
Not in the sense web site publishers understand it, without mid layer. > That one is a bit specialized: for manual pages. =:c) Because the main application directs semantics derivation from many years of improvements. This is why slapping an extra application results in mere rarely used features or rather changes that deviate and possibly interfere with the main original semantics application. > True, i once heard of one developer who used it for creating a small > static website that had nothing to do with manuals. But i must > admit it's not really intended as a general-purpose tool. But there are exports from mandoc(1) that look stunningly beautiful. mandoc - format and display UNIX manuals: Output Formats [http://man.openbsd.org/OpenBSD-current/man1/mandoc.1#Output_Formats] Check the -T option with html and pdf output, this is incredibly good. mandoc_char - mandoc special characters [http://man.openbsd.org/OpenBSD-current/man7/mandoc_char.7] NB: I think http://man.openbsd.org/mandoc ought to work, magic touch? Would be nice to see how people make it work for them anyway still ;-) > > If you ask me this > > http://mdocml.bsd.lv/ > > and this > > http://manpages.bsd.lv/history.html > > are pretty darn good looking static websites. > > They are generated with mandoc. > > Sorry, no, they aren't, they were written by hand, mostly by Kristaps. > They are merely using a stylesheet that slightly resembles the > mandoc.css stylesheet. > > But here are a few static webpages generated by mandoc(1) -Thtml: > > http://mdocml.bsd.lv/man/ > > Basically, all the links of the form "name(section)" on that > page, and on the pages you can reach from there. > > Ironically, the same pages on > > http://man.openbsd.org/ > > are not statically pregenerated, but dynamically generated > on demand. But the user will hardly care. > > Yours, > Ingo Thanks for bringing this up, hopefully someday org-mode [http://orgmode.org/] gets an output export for mandoc. Org-mode manual - Exporting [http://orgmode.org/manual/Exporting.html] P.S. Does Emacs have a well functioning mandoc mode, or similar?
