Ckgdocu is a very great plugin! But it has one important issue: it converts relative doku links to absolute. In certain cases it is unacceptable.
Let me explain.
We are going to switch to DokuWiki for developing, translation and providing documentation for our software users. We need develop documentation for many languages and froze documentation for particular version of our software.
Therefore, the namespace of our DokuWikis looks like this:
en
dev
ugd
gui
faq
tags
v2_1
ugd
gui
faq
v2_2
ugd
gui
faq
ru
dev
ugd
gui
faq
tags
v2_1
ugd
gui
faq
v2_2
ugd
gui
faq
..................
Root namespaces en,ru,fr, etc are the language selectors.
Each language subtree contains development (dev) and fixed (tags) branches.
Dev is where doc-developers and interpriters works on the currently developing software version.
Tags contains documentation for the fixed versions of software (v2_1,v2_2,,,) (Each version have to have corresponding documentation)
ugd,gui,faq are namespaces for documents (User Guide, GUI context help, FAQ)
ugd, gui, faq have internal cross links, for example [[..:gui:add_user]] refs from User Guide page to GUI page.
We use relative links to simplify development and fix versions.
For example, to create new language translation we can simple copy base language development tree [:en:dev] to new language tree [:zh-tw:dev]. Since all links are relative and the overall documentation structure is uniform, we don't need any other actions for correction of internal links.
The same is for the tags tree. We just copy dev tree to tags's v_... tree.
Unfortunately , Ckgdoku breaks this simple scenarios at all!
For example, the link [..:ugd:add_user] is saved as [en:dev:ugd:add_user]. If we copy this page, for example, to taiwan language tree, all links from taiwan dev tree will point to english dev tree!
Is it possible to add these features to your plugin:
- add plugin configuration parameter flag: 'Save internal links as relative'
- the same flag in the dialog for internal link create/edit dialog
?
With respect,
Sergey Kotov.