This is a static dump of issues in the old "Flyspray" bugtracker for DokuWiki. Bugs and feature requests
are now tracked at the issue tracker at Github.
Closed
Fixed
Fixed
FS#1045 bugs InterWiki link in distributed files should be replaced with dokuwikibugs
Docs
-
2007-01-12 pchaintreuil
The "bugs>" interwiki link in distributed files to refer to DokuWiki bugs. There should be a unique interwiki link for DokuWiki bugs.
One of the first things I did when I found out you could customize interwiki links was to override the "bugs>" interwiki link to point to our bug server. This made the reference in wiki:syntax#windows_shares ("See 151 for more info.") point to issue #151 in my bug server instead of DokuWiki's.
I suggest making a "DokuWikiBug>" interwiki tag, and making sure that all distributed files use that tag instead of the standard "bug>" tag. (Search & replace as part of the process of making the tar file for distribution if needed.) The rest of DokuWiki's site is welcome to continue to use the shorter "bugs>" tag to refer to DokuWiki bugs.
There may be other interwiki tags that should also be made unique, the "bugs>" one is the only one I've run into. -
2007-01-12 pchaintreuil
For the wiki:syntax#windows_shares instance, I simply edited the page and replaced the original
* See [[bug>151]] for more info
with
* See [[http://bugs.splitbrain.org/index.php?do=details&id=151|DokuWiki bug #151]] for more info
This will probably get nuked when I upgrade though.... -
2007-02-20 gb
Overwriting the tag for interwiki linking is meant for what you want. If you need to use bug> tag for your own issue tracker use it and change the tag used for DokuWiki bugs. In your interwiki.local.conf:
bug http://your.bug.tracker/?
dokuwikibug http://bugs.splitbrain.org/index.php?do=details&id=
I don't see why the second should become the "default" tag for DokuWiki bugs in the distributed files. dokuwikibug is not a unique tag, neither is bug one. interwiki.local.conf tag definitions overwrite those distributed by default, so the best is to add whatever needed locally in this file.
BTW, this is not a bug.
Regards
gb
-
2007-02-20 pchaintreuil
The issue is not that I can't do it, it's that the current distribution make it very difficult and clumsy to do. Because references in the distributed docs use "bug>" to point to the Dokuwiki main bug tracker, it means that if I do exactly what you said, I'll have entries in the default distributed documents that point to *my* bug database, not the intended Dokuwiki bugs. The only work around to this is for me, and any other user who wants to use the "bug>" tag to point to their own bug tracker, to search-and-replace in the default distributed docs to point it to something else such as the suggested "dokuwikibug>" tag. This is a lot of work that has to be repeated at each and every upgrade by every single site that uses interwiki.local.conf to take control of "bug>".
Basically my point is that because these tags are used in the default distributed documents, they render the use of the interwiki.local.conf nearly pointless. Therefore, if tags such as these are going to be used in the default distributed docs, they should be more unique than the "bug>" tag, which is something most sites who have a bug tracker would probably want to use. -
2007-02-21 gb
OK, I was not seeing this enough from the point of view of the documentation. That said, please forgive my naive question, but why don't you use an interwiki tag different from bug> for your local bug database? -
2007-02-22 pchaintreuil
That is an understandable response. I think I took http://wiki.splitbrain.org/wiki:discussion:bugtracking as a suggestion as to how to hook a bug tracking system into DokuWiki. The page seemed to start as explaining how to hook flypaper into DokuWiki, and then other people seemed to have indicated that they hooked other systems in. (Such as Mantis, which is what we use.) I took this page as a suggestion "bug>" be used in your interwiki.local.conf to tie bugs into your wiki documentation.
These two paragraphs are the ones that caught my eye:
"To reference bugs an interwiki shortcut named bug was added which allows to link directly to a bugs detail page by its ID: [[bug>4]] → 4
"FlySpray seems to be a simple and easy to use Bug Tracking system. It’s a good choice, specially since it seems the development team aims to integrate some sort of WikiParser into it, which will ease writing and editing descriptions. Still, some nice-to-have features are lacking:"
Since interwiki.local.conf allows you to override "bug>", that enforced this perception that "bug>" was a suggested tag to use. If "bug>" was not overloadable, then I would have chosen something else. It seemed intelligible since it's short and easy to remember; probably for the same reasons DokuWiki chose it to link to their bug database. -
2007-02-22 pchaintreuil
If this isn't the intent, perhaps an short interwiki.local.conf.example should ship with [commented out] examples of common tags people use. For example:
------------------------------------------------------------------------
# Mantis Bug Tracker
#mantis http://your.mantis-server.com/mantisbt/view.php?id=
# Bugzilla
#bugzilla http://your.bugzilla-server.com/show_bug.cgi?id=
------------------------------------------------------------------------
Just to kick people off in the right direction and avoid the pitfall I made have made.
