In short, I have an existing api/repo and I want to integrate a nice wrapper to the existing .md files (documentation). My repo structure (locally anyway) is
docs/ (all of the existing API/Service docs that BE engineers contribute to)
site/ (the site generated by Hugo)
src/ (all of the existing source code for the project we’re documenting)
My question is simple … am I able to link to and easily display .md files from docs/ inside of the Hugo app? I tried to link using relative url paths and I get REF_NOT_FOUND: “…/docs/md_file_to_render.md” …
I feel silly asking this, but I’m trying to find the easiest way to leverage all of the existing markdown files, without imposing or polluting the existing repo/codebase and requiring extra management or duplication of the documentation files. If that makes sense?
Any guidance is appreciated.
Also, I’m posting this to GH Pages eventually, and symlinks are not allowed … I don’t believe.