gitdocs icon indicating copy to clipboard operation
gitdocs copied to clipboard

`gitdocs build` generates all links relative to the web server root

Open sargsyan opened this issue 6 years ago • 2 comments

All static pages built with gitdocs build have hyperlinks to each other starting with "/". This will only work if the website is going to be deployed in a separate web server. This will not work if you want to put the documentation in one of the subfolders of your website. Because of the same reason, you cannot deploy gitdocs even in github pages project, because the root for github pages is the folder of the user whereas projects root is always a folder inside the root.

P.S. Of course, you can always fix the links after each build, but this adds manual work.

sargsyan avatar Nov 09 '18 16:11 sargsyan

Thanks for reporting @sargsyan, I think you're right. There should be a configuration option to turn allow relative/absolute urls.

zsherman avatar Nov 09 '18 17:11 zsherman

+1 I tried setting baseURL to an empty string but that did not have the effect I was hoping for

mberneis avatar Mar 11 '20 20:03 mberneis