5 ms·

Pandoc http://johnmacfarlane.net/pandoc/index.html http://johnmacfarlane.net/pandoc/index.html can do that and much more.

by qubital 15y ago

dfc 15y ago
"Much more" is a drastic understatement. Pandoc is awesome. The only "convert X.txt to Y.txt" task that pandoc can not handle is X=wikipedia
- nknight 15y ago
  I noticed that a few years ago and found it surprising but figured it would show up soon. Is there a technical reason it hasn't, or just lack of sufficient motivation an anyone's part?
  - dfc 15y ago
    Apparently wikipedia's format is a pain to parse. I think jgm posts here as fiddlosopher he is the best source for the gory details... But there is definitely sufficient motivation just google "convert wikipedia to" for some examples. I think that the arcane syntax is a big lockin factor with large wikipedia based sites... There is a ticket for it: https://github.com/jgm/pandoc/issues/388 https://github.com/jgm/pandoc/issues/388
julian37 15y ago
Also, Asciidoc (used e.g. for the git documentation) has been supporting this for a long while. http://www.methods.co.nz/asciidoc/userguide.html#_manpage http://www.methods.co.nz/asciidoc/userguide.html#_manpage
antris 15y ago
Funny how I'm instantly repulsed to try it because it's not a GitHub link.
- dfc 15y ago
  The funnier part is that its actually distributed via github. Sorry not the troll food you were looking for.
TerminalPrgrmr 15y ago
"Write programs that do one thing and do it well." --Doug McIlroy
- dfc 15y ago
  Pandoc does, it converts text from one format to another and it does it superbly... Nobody was attacking you or your project. They are simply speaking about tools with similar uses.
  - TerminalPrgrmr 15y ago
    Thanks for clarifying. Defensive instincts engage when one's pet project fades from the spotlight on its own stage. You're right about Pandoc fulfilling my quoted aspect of Unix philosophy; I realized it later but was too proud to admit it. :)
limly 15y ago
Pandoc is indeed excellent. I suggest that anyone needing to write a man page just write it in Markdown and -- if a man page is necessary -- have Pandoc convert it.

Pandoc http://johnmacfarlane.net/pandoc/index.html http://johnmacfarlane.net/pandoc/index.html can do that and much more.

by qubital 15y ago

Pandoc http://johnmacfarlane.net/pandoc/index.html http://johnmacfarlane.net/pandoc/index.html can do that and much more.

dfc 15y ago

"Much more" is a drastic understatement. Pandoc is awesome. The only "convert X.txt to Y.txt" task that pandoc can not handle is X=wikipedia

nknight 15y ago
I noticed that a few years ago and found it surprising but figured it would show up soon. Is there a technical reason it hasn't, or just lack of sufficient motivation an anyone's part?
- dfc 15y ago
  Apparently wikipedia's format is a pain to parse. I think jgm posts here as fiddlosopher he is the best source for the gory details... But there is definitely sufficient motivation just google "convert wikipedia to" for some examples. I think that the arcane syntax is a big lockin factor with large wikipedia based sites... There is a ticket for it: https://github.com/jgm/pandoc/issues/388 https://github.com/jgm/pandoc/issues/388

julian37 15y ago

Also, Asciidoc (used e.g. for the git documentation) has been supporting this for a long while. http://www.methods.co.nz/asciidoc/userguide.html#_manpage http://www.methods.co.nz/asciidoc/userguide.html#_manpage

antris 15y ago

Funny how I'm instantly repulsed to try it because it's not a GitHub link.

dfc 15y ago
The funnier part is that its actually distributed via github. Sorry not the troll food you were looking for.

TerminalPrgrmr 15y ago

"Write programs that do one thing and do it well." --Doug McIlroy

dfc 15y ago
Pandoc does, it converts text from one format to another and it does it superbly... Nobody was attacking you or your project. They are simply speaking about tools with similar uses.
- TerminalPrgrmr 15y ago
  Thanks for clarifying. Defensive instincts engage when one's pet project fades from the spotlight on its own stage. You're right about Pandoc fulfilling my quoted aspect of Unix philosophy; I realized it later but was too proud to admit it. :)

limly 15y ago

Pandoc is indeed excellent. I suggest that anyone needing to write a man page just write it in Markdown and -- if a man page is necessary -- have Pandoc convert it.