reconquest / shdoc

Documentation generator for shell scripts (bash, sh, zsh). Javadoc for shell scripts.
MIT License
291 stars 61 forks source link

Regarding hyperlink option non-availability #32

Closed mani3029 closed 3 years ago

mani3029 commented 3 years ago

Hi Team,

Currently i am not able to find a way to create hyperlink in generated .md file. If opened in browser the generated .md file it is all plain .So do we have any option with which we can create hyperlink b/w Index and functions. Do we have option to create pdf file documentation as well from shdoc itself as well?

Thanks

mani3029 commented 3 years ago

Hi Team,

Any suggestions ?

Thanks

kovetskiy commented 3 years ago

Hello,

mani3029 commented 3 years ago

Thanks a lot @kovetskiy for your suggestions .2nd part is clear regarding 1st one still i have some doubt.

To be precise below is what i am trying to achieve .

Index

func_1()

Description of func_1

Function has no arguments.

Exit codes

func_2()

Description of func_2

Function has no arguments.

Exit codes

func_3()

Description of func_3

Function has no arguments.

Exit codes

So While opening in browser can we achieve a functionality where Index of func_1 becomes hyperlink as well as clicking there will take us to it's function definition.

Thanks

kovetskiy commented 3 years ago

But it's working like that already, no? Here we have Index with clickable links https://github.com/reconquest/shdoc/blob/master/examples/readme-example.md

mani3029 commented 3 years ago

In case i am opening raw .md file generated by shdoc hyperlink part not working for me .Tried opening .md file in chrome browser in windows 10. Version details-Version 88.0.4324.150 (Official Build) (64-bit). Let me know in case i am missing something.

Thanks

kovetskiy commented 3 years ago

I'm not sure what you mean by opening markdown in chrome browser. Markdown should be rendered by something into HTML.