integration of a wiki into Tracks
Would it be possible to add a Wiki section into Tracks? That would make it an all-in-one webapp for me to use as a single data collection inbox.
Leave a comment
on 2005-04-02 23:16 *
By Anonymous
Status changed from New to Accepted
Status changed from New to Accepted
It's a good idea. I'd been thinking about something on the same lines myself, though it may not happen for a while. The tricky bit is thinking how to make it integrated without causing the whole interface to be bloated. If it was just going to be a wiki available from the Tracks interface then it could probably just use any wiki engine, but I think it would be nicer to make it fit in a little more.
This system, Trac, has nice integration between the wiki parts and the more structured parts (timeline, changesets, source etc.). You can put special wiki links in to link to a particular ticket for example. It would be nice to have something like that, with special links to take you to a particular next action, context or project.
I've marked it for the 1.1 milestone because I think it will need a fair bit of work. Thanks for the input!
This system, Trac, has nice integration between the wiki parts and the more structured parts (timeline, changesets, source etc.). You can put special wiki links in to link to a particular ticket for example. It would be nice to have something like that, with special links to take you to a particular next action, context or project.
I've marked it for the 1.1 milestone because I think it will need a fair bit of work. Thanks for the input!
Another personal opinion follows:
There are tons of wiki's to choose from and they are easy to implement. Why pick one and spend a lot of time integrating it?
As long as tracks make it easy to link to specific next actions etc, any given wiki could implement a map for its own wikiwords to tracks.
So not sure about wiki in tracks either.
There are tons of wiki's to choose from and they are easy to implement. Why pick one and spend a lot of time integrating it?
As long as tracks make it easy to link to specific next actions etc, any given wiki could implement a map for its own wikiwords to tracks.
So not sure about wiki in tracks either.
I use Instiki and Tracks together running off the same USB key on both WindowsXP and MacOSX. This works pretty well actually - I don't really see the need for a wiki inside of Tracks.
The only issues I run up against is when I run Tracks together with some of the later versions of Instiki (like instiki-ar, the active-record version of instiki). It seems that the session cookie used by tracks also gets used by Instiki, resulting in "page not found" errors in Instiki. This is common to many attempts to run two different rails apps concurrently on the same host - but I'm hoping that there must be a way to do the session cookies in such a way that they don't "collide" with those used byy another Rails app. (This is probably better requested in a rails forum, as it is perhaps something every Rails developer should probably look at.)
The only issues I run up against is when I run Tracks together with some of the later versions of Instiki (like instiki-ar, the active-record version of instiki). It seems that the session cookie used by tracks also gets used by Instiki, resulting in "page not found" errors in Instiki. This is common to many attempts to run two different rails apps concurrently on the same host - but I'm hoping that there must be a way to do the session cookies in such a way that they don't "collide" with those used byy another Rails app. (This is probably better requested in a rails forum, as it is perhaps something every Rails developer should probably look at.)
just wanted to point your attention onto "LesserWiki":http://www.lesserwiki.org/ - I stumbled over it accidently...
What I like is that it seems to be a nice "TiddlyWiki":http://www.tiddlywiki.com/ port (I already tried a different server side PHP port of it) and that it uses Ajax.
What I like is that it seems to be a nice "TiddlyWiki":http://www.tiddlywiki.com/ port (I already tried a different server side PHP port of it) and that it uses Ajax.
I think it is a fine idea. i think it would be a good project plan space.
the tricky part is the integration. with project notes in 1.04 and the wiki plan in the works...
how to make it all work well elagantly and without redundancy.
allowing wikiwords in plan notes, and allowing referencing plan notes in wiki plan pages.
something like this. it is similar to the approach of planner mode emacs of which i am also a fan.
although i am appreciating the GTD feel of tracks and rails flexibility a bit more these days.
the tricky part is the integration. with project notes in 1.04 and the wiki plan in the works...
how to make it all work well elagantly and without redundancy.
allowing wikiwords in plan notes, and allowing referencing plan notes in wiki plan pages.
something like this. it is similar to the approach of planner mode emacs of which i am also a fan.
although i am appreciating the GTD feel of tracks and rails flexibility a bit more these days.
I'm also strongly in favour of some wiki features, for the notes. I like !TiddlyWiki but it's too light-weight for every-day use. The wiki features there are definitely appreciated though.
For tracks, I was playing around with markdown/textile and I tend to think that one change that would almost get us wiki functionality would be if we could optionally name our notes, as !WikiWords, instead of indexing them by ID.
That way, you could refer to other notes via:
"link text":/notes/linkName
Which would be translated to: http://hostname/notes/linkname .
The next step might be a pre-parser to translate !WikiWords directly into textile format, up to and including the "notes/" portion.
I believe that would be sufficent for a wiki, as far as I'm concerned.
I may do some playing with Rails to see how tough this would be, and if there are other issues I'm not thinking of here.
For tracks, I was playing around with markdown/textile and I tend to think that one change that would almost get us wiki functionality would be if we could optionally name our notes, as !WikiWords, instead of indexing them by ID.
That way, you could refer to other notes via:
"link text":/notes/linkName
Which would be translated to: http://hostname/notes/linkname .
The next step might be a pre-parser to translate !WikiWords directly into textile format, up to and including the "notes/" portion.
I believe that would be sufficent for a wiki, as far as I'm concerned.
I may do some playing with Rails to see how tough this would be, and if there are other issues I'm not thinking of here.
Is would like to suggest a very simple approch. I could place a simple configuration option in tracks like:
http://mywiki.local/index.php?title={word}
If this variable is set, tracks parses all words like this:
This is [my article] in Wiki.
And creates autmaticly a like for it. I dont know ruby, but in other langs this could be done very simple with regular expressions.
http://mywiki.local/index.php?title={word}
If this variable is set, tracks parses all words like this:
This is [my article] in Wiki.
And creates autmaticly a like for it. I dont know ruby, but in other langs this could be done very simple with regular expressions.
on 2011-12-05 19:20 *
By pavel.zupa
I use wiki for my project notes (namely dokuwiki). I've tried to use Tracks to write some project notes but wiki is a wiki, everyone is used to something else. I believe a tool should not try to be able to do everything...
My proposal would be to add configuration option for wiki url like http://my.wiki.somewhere/projects:{placeholder}
Then if this option is filled show a link icon on every project that would point to page on the wiki with placeholder replaced by actual project name.
There may be some issues with national characters in project names or standards for page names for different wikis. But maybe for starters replacing spaces with underscores would be sufficient...
Damn, since I discovered Tracks I hate I'm a Java developer. This should be pretty easy but after an hour i got totally lost in the code.
My proposal would be to add configuration option for wiki url like http://my.wiki.somewhere/projects:{placeholder}
Then if this option is filled show a link icon on every project that would point to page on the wiki with placeholder replaced by actual project name.
There may be some issues with national characters in project names or standards for page names for different wikis. But maybe for starters replacing spaces with underscores would be sufficient...
Damn, since I discovered Tracks I hate I'm a Java developer. This should be pretty easy but after an hour i got totally lost in the code.
Haha, I was used to Java too, RoR was just an exiting new challenge :-)
We have one function that renders the note for todos/project which allready does some filtering. Does the markdown markup have something to reference a wiki page? We should try to use the same syntax.
Selecting the right project name for the placeholder is tricky. You could take the project name of the project that the todos belongs too, but what happens if you change the project of the todo. Or, in case of the project, what happens if you change the project name? Perhaps an edit field in the project edit form where you can enter the wiki page name for the project?
We have one function that renders the note for todos/project which allready does some filtering. Does the markdown markup have something to reference a wiki page? We should try to use the same syntax.
Selecting the right project name for the placeholder is tricky. You could take the project name of the project that the todos belongs too, but what happens if you change the project of the todo. Or, in case of the project, what happens if you change the project name? Perhaps an edit field in the project edit form where you can enter the wiki page name for the project?
on 2011-12-06 13:43 *
By pavel.zupa
Man! Great, that was the hell of a quick reply! Ok, I’m thinking about wiki links as addition to existing project and todo notes not as a replacement. Notes I see as ideal place for short notes, like for todo “talk to my wife about my mountain trip”, the note is ideal for something like “don’t forget to mention she looked great in that dress last night”. On project “mountain trip” that’s where I’d like to see a link to wiki page “Mountain Trip” with all that brainstorming and packaging lists, map links and so on…
In fact I don’t think todos themselves need links to wiki. If so then i think each todo deserves it’s own page for simplicity. If you want to get to project wiki it's one more click... not that bad.
Now about the transformation of project name to link placeholder. I’ve been looking around and I think there are only a few link styles wikis use. For mediawiki it’s just spaces to underscores, it allows lower and upper case and is case sensitive. And it even allows national characters. For dokuwiki (which is my personal favourite) I would prefer national characters to be removed which is pretty hard task, also lowercasing the name would be nice. But I think for starters simple spaces-to-underscores (maybe also chars like '#?&*') should be good for most cases. Maybe for some future version the transformation could get more sophisticated.
The last problem is project renaming. I think the solution is to add a field to database (e.g. 'project_wiki'). Ok, what an idea:-) Stay with me, i believe the logic around this field could make it quite useful. So user creates project. The 'project_wiki' field is blank so user can freely rename the project. When user clicks the wiki button on project for the first time the 'project_wiki' field gets filled with actual project name (transformed). From this time on no changes to project name should be reflected in 'project_wiki' field (simple logic "if not blank"). User should be able to edit this field right from the beginning (even when it's not filled yet) so the transformation function does not need to be perfect because user can fix it.
What do you think? It's not as simple as I thought in the beginning but nothing ever is. Never ever:-)
In fact I don’t think todos themselves need links to wiki. If so then i think each todo deserves it’s own page for simplicity. If you want to get to project wiki it's one more click... not that bad.
Now about the transformation of project name to link placeholder. I’ve been looking around and I think there are only a few link styles wikis use. For mediawiki it’s just spaces to underscores, it allows lower and upper case and is case sensitive. And it even allows national characters. For dokuwiki (which is my personal favourite) I would prefer national characters to be removed which is pretty hard task, also lowercasing the name would be nice. But I think for starters simple spaces-to-underscores (maybe also chars like '#?&*') should be good for most cases. Maybe for some future version the transformation could get more sophisticated.
The last problem is project renaming. I think the solution is to add a field to database (e.g. 'project_wiki'). Ok, what an idea:-) Stay with me, i believe the logic around this field could make it quite useful. So user creates project. The 'project_wiki' field is blank so user can freely rename the project. When user clicks the wiki button on project for the first time the 'project_wiki' field gets filled with actual project name (transformed). From this time on no changes to project name should be reflected in 'project_wiki' field (simple logic "if not blank"). User should be able to edit this field right from the beginning (even when it's not filled yet) so the transformation function does not need to be perfect because user can fix it.
What do you think? It's not as simple as I thought in the beginning but nothing ever is. Never ever:-)
no, nu such thing as simple :-)
I was not thinking about replacing notes with wiki, just adding a filter on it to find wiki-links. Like "follow me":url syntax for hyperlinks, mailto and onenote links. Now I think of this, maybe a wiki handler: "Mountain Trip":wiki://mountain_trip could be transformed into "Mountain Trip":http://wiki.yourserver.com/mountain_trip. No need to transform project names to wiki names, we let the user do that (how's that for user friendliness :-) )
I was not thinking about replacing notes with wiki, just adding a filter on it to find wiki-links. Like "follow me":url syntax for hyperlinks, mailto and onenote links. Now I think of this, maybe a wiki handler: "Mountain Trip":wiki://mountain_trip could be transformed into "Mountain Trip":http://wiki.yourserver.com/mountain_trip. No need to transform project names to wiki names, we let the user do that (how's that for user friendliness :-) )
on 2011-12-06 16:38 *
By pavel.zupa
in fact I already use it like that. I simply put the link in project note - pretty simple, pretty straightforward. But it's just link in note it does not give me the feeling "this is THE project page". And of course the lazyness factor:-) And my memory, don't get me started on my memory ... "what was the link like? wiki.my.home/projects: or wiki.my.home/projects/" ... ok i'm exaggerating a little.
Of course I understand that it is quite some work maybe a little added value. But in my view project knowing it's own wikipage is better than project with some link in it's note. The wiki button can be e.g. shown in list of projects ... some clicking saved. And of course "wiki interation" looks nice in feature list:-)
The idea of special short links is not bad, solves the user memory problem but still it's just a link in note. And still I have to do something... I create project (fill it's name) then I open new note and fill the project name again and when I click on that link I will have to fill it again in the wiki as heading. I was looking for a way to save at least one of those.
Of course I understand that it is quite some work maybe a little added value. But in my view project knowing it's own wikipage is better than project with some link in it's note. The wiki button can be e.g. shown in list of projects ... some clicking saved. And of course "wiki interation" looks nice in feature list:-)
The idea of special short links is not bad, solves the user memory problem but still it's just a link in note. And still I have to do something... I create project (fill it's name) then I open new note and fill the project name again and when I click on that link I will have to fill it again in the wiki as heading. I was looking for a way to save at least one of those.
An easy change is just an edit field in the project edit form where you can enter the wiki page name for the project, perhaps with a one-time preference to set the server of the wiki with some template to place the page name. At project creation, you can prefill the project name with lowercase and underscores...
on 2011-12-06 19:20 *
By pavel.zupa
Ok. Having user editable field on project, config option for url template and some button or link to open the wiki seems like a good start. The more I'm thinking about this the more I'm tempted to learn at least RoR basics. Changing domain model seems like a little rough start. But i'm looking forward to trying to add some useful logic around this basic implementation. I just hope that "Someday/maybe" milestone is not too far:-)
Updating tickets (#17, #47, #49, #83, #91, #97, #103, #107, #117, #125, #126, #175, #177, #183, #188, #197, #206, #211, #236, #240, #276, #294, #295, #305, #309, #312, #317, #324, #355, #357, #358, #371, #373, #393, #434, #452, #478, #503, #507, #535, #564, #565, #568, #569, #571, #572, #636, #668, #682, #686, #692, #715, #736, #741, #759, #773, #782, #783, #800, #828, #837)
Migrated to GitHub issue #1484