jandecaluwe / urubu

A micro CMS for static websites, with a focus on good navigation practices.
urubu.jandecaluwe.com
GNU Affero General Public License v3.0
180 stars 36 forks source link

"Project-wide reference ids" not found on root index.md #2

Closed Galland closed 10 years ago

Galland commented 10 years ago

Simply by modifying the repo's "urubu/doc/index.md" adding, before the HTML, the following markdown linking to a "project-wide ref. id" (i.e. a page from the "manual" sub-folder):

 [Sample Structure][structure]

results in:

md_extensions.py:90: UrubuWarning: Undefined ref [structure] in file './index.md'
md_extensions.py:90: UrubuWarning: Undefined ref [sample structure] in file './index.md'

I believe the "structure" reference should link to a .md inside the "manual" sub-folder, through Urubu's "project-wide ref ids" instead of through a Markdown's reference-style link (where [...] are defined below).

I think this may be related to the manual's description of this ref. ids, where it says about them: "Urubu will resolve them depending on the file location in the project."

jandecaluwe commented 10 years ago

The ref ids for pages should be root-relative or relative pathnames, e.g. /manual/structure.

Please review the documentation and let me know it that is not clear.

Galland commented 10 years ago

Your example clarified it all. I hadn't really paid the required attention to the relative-paths paragraph. Thanks!