JC: This page relocated from www.equi4.com/wikit ... most of this is by Christophe Muller.
CM (18/06/03): I have completed the port of all features I had running using pre-starkit versions of Wikit and will soon update this page with new status. New features ported to wikit.kit are (need not all to be adopted, they were develop for our internal needs): local references, external URL labels, many uses of HTML title properties, sections and subsections, a configurable page header set in Web Settings. I will soon send all this to JC for review.
What is below is out-of-date and needs to be updates ---> soon!
News
(July 9th 02)
Well, everything is pretty new here, because this page has just been created from contents found in the link above.. :-). I have been updating the "already implemented" list with details on each feature (see below). Also the "map" feature is now working in local mode (one must copy to the local partition not only the image but also a .map file that has been generated by gimp or other tools, then the wiki engine will automatically see there is a map description and include it). I have somewhat abandoned the java applet figure editor for now.. and also the LaTeX generation (we just wrote an article proposition and we have cut-and-pasted from the wiki page, it works quite well enough.. :-). The index generator works but I would like to get a nicer result...
What I would like is some feedbacks on what features would need to be ported first to the new wikit structure. My first guess would be the HTML tags, CSS tags with a sample of CSS, and the generation of headers. Maybe also the title information for brackets links. Any thoughts?
(Same day -jcw)
Please be sure to visit the new starkit site [L1 ]. It's a name change, but also has some technical implications. Very very new, though the plans to do this were born several months ago.
Well, first of all, by now the new wikit is a fact, it's a starkit, it drives the Tcl'ers Wiki, and it seems to hold out. I've made a few changes since you first set up this page - I sure hope they simplify your future work on wikit:
Ideas for Wikit enhancements
In this wiki, wikit enhancements ideas are gathered into the Suggested changes page. Below are described a couple of ideas that I have been experimenting with, unfortunately on the previous sources, and they have not been applied to the new wikit source yet. However, everything is available on request for adventurous persons! :-)
I first describe the principles in which I believe, from a GUI-guy point of view, you might disagree of course.. debate is always welcome. See also in the "Biblio" section below a link to Dr. Nielsen's illuminating harangue :-). Then I (too shortly) describe the ideas one by one, and precise if they have been implemented already, if the developments are in progress, or if they are just vaporware..
Rationale
The question one might ask is Why are you not using a Perl or PHP wiki that is already much more developed than wikit?
And my answer is that I'm very much concerned by the usability issue. I see other wikis with embedded HTML, %variables%, keywords, plugins, etc. and IMHO, they have many advantages but they also have a big drawback- their learning curve is slowly becoming as steep as HTML or LaTeX or even worse (Word!). Actually, I even find the rendered HTML pages difficult to read (and so difficult to use!) with many links, tables, etc. KISS is a good principle in UI (still IMHO). See, in the links below, Dr. Nielsen's site.
So yes, I would like more powerful features in wikit, and also a better looking CSS-ized HTML code with a few nice looking features, but no, I don't want Word at all. For this reason, I prefer to slowly modify wikit in a way that suits this philosophy rather than switch to Twiki, PHPWiki, or you-name-it-wiki.
A good example of this is the "Generation of headers" feature (see below) in wikit without any new markup!
Roadmap
Already implemented features are:
Plus the integration of two patches:
Brian is the author of tkoutline. For seeing its new feature in action, click to see the last diffs of its own wiki - Home Page: [L2 ]). BTW, I find it very nice the way Brian gave access to the diff (i.e., the footer's Update on ... becomes a link).
My roadmap is:
Still in progress are:
Other Suggestions (see also Suggestions for Wikit):
LV with regards to the editor comment - perhaps there is a way to write something in Word (VisualBasic for Apps, etc.) that would convert a document formatted for Word into an equivalent Wikit formatted document... of course, it would be a 'downgraded' format. Note also that one requirement for wikits are that all features are accessible via the lynx text html browser. So a things like a Java component needs to have equivalent text access.
Wow... - After seeing all this, I'm now bent more than ever on placing nwikit into CVS. It will, as with MetaKit and TclKit, be essentially a reado-only setup. But in this case with eager interest in helping to consolidate things. There seem to be, right now, three people working on wikit improvements - not to ignore several who have helped in the past. The CVS setup is not intended to prevent anyone from going their own way and doing whatever they like with the wikit codebase - just an option for those who wish to see things come back full circle.
One last comment, *please* consider joining the TclersWiki discussion group on Yahoo. It's been dormant lately, but I suspect that'll change soon. I'll announce my nwikit progress there asap.
Anyway, great to see all these ideas... -JCW
PS. One of these day's I'll move my notes to the WiKit or Suggestions for Wikit page, or perhaps create a new page do discuss progress.
CM Thanks for your fast comment! I also agree that for three developers, a full-featured sourceforge site is really not worth the time to set it up!.. but a CVS with all the versions would be nice. I will try to finish the features that I am currently developing asap, in order to reach a stable state (hopefully). Then I will send a version to you and Brian, so that you can play with it, then I'll try to apply my patches to your new version (CVS might help me there.. :-). BTW, I am subscribed to the TclersWiki mailing-list (Larry "LV" put me in :-)
BTW, I am not sure that everything listed above will be desirable for the official version, even if some features are very necessary for us internally (I'm thinking about the export mechanism for instance), I'll leave it to you to decide what to integrate...
JCW Ah, but see, that's one of the things I'd like to refine a bit: the presence of packages will trigger functionality, i.e. plugins - in the nicest possible way I hope.
Info about Obtaining Wikit from CVS has been moved to a separate page -jcw
KPV I like it when you search for a page, the resulting list has the date the page was last changed. I'd like that also when clicking on a reference. That's the page you get when you click on another page's title, or by going to, say "[http://mini.net/tcl/1683!] ". mmmm, how do I get the "!" to be part of the URL?
12nov02 jcw - Date is now listed on back-ref ("bang!") pages. As for getting it into an URL wikit will accept, try this: http://mini.net/tcl/1683%21
DKF If you're going to refer to local resources, couldn't you use a file: URL?
Also, the most painful part about going from something based on ISO 8859-1, or even ASCII, to (La)TeX is the fact that TeX uses a completely different encoding, but which is similar in enough places for you to think you've done enough when just doing simple tests.
Biblio
A few interesting links for people working on Wiki engines (there are so many! ;-)