Make man page links clickable

Seravo / docs

Documentation for Seravo.com customers and developers

https://seravo.com/docs/

14 stars 16 forks source link

Make man page links clickable #48

Open ottok opened 4 years ago

ottok commented 4 years ago

The man pages include some links. Currently they are not rendered into real clickable links in seravo.com/docs:

It would be nice if they could be rendered. Links to external man pages could go to manpages.ubuntu.com, e.g. http://manpages.ubuntu.com/manpages/focal/en/man1/rdiff-backup.1.html

sjaks commented 4 years ago

Idea for automating this in a script:

start scraping the comma seperated list under SEE ALSO
find enties starting with wp-* and find-replace them with markdown links pointing to seravo.com/docs/wp-$1
find entries starting with wp and add links to developer.wordpress.org/cli/commands/$1
link rest to ubuntu man pages (maybe check if man page is found online)

ottok commented 4 years ago

Did you check that pandoc itself does not support some kind of link generation? Those items are after all links to begin with in the original man pages.

sjaks commented 4 years ago

Haven't come across such feature. Afaik, "links" in man pages are clickable due to the terminal emulator treating man page entries cmd(#) as links.