]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blob - doc/users/jon.mdwn
Added description of mathjax plugin
[git.ikiwiki.info.git] / doc / users / jon.mdwn
1 [[!meta title="Jon Dowland"]][[!toc levels=2]]
3 ## intro
5 I'm looking at ikiwiki both for my personal site but also as a
6 team-documentation management system for a small-sized group of UNIX
7 sysadmins.
9 * my edits should appear either as 'Jon' (if I've used
10   [[tips/untrusted_git_push]]); 'jmtd.net', 'jmtd.livejournal.com', 
11   'jmtd' if I've forgotten to set my local git config properly,
12   or once upon a time 'alcopop.org/me/openid/' or 'jondowland'.
13 * My [homepage](http://jmtd.net/) is powered by ikiwiki
15 I gave a talk at the [UK UNIX User's Group](http://www.ukuug.org/) annual
16 [Linux conference](http://www.ukuug.org/events/linux2008/) in 2008 about
17 organising system administrator documentation. Roughly a third of this talk
18 was discussing IkiWiki in some technical detail and suggesting it as a good
19 piece of software for this task.
21  * slides at <http://www.staff.ncl.ac.uk/jon.dowland/unix/docs/>.
23 I am also working on some ikiwiki hacks:
25 * [[todo/allow site-wide meta definitions]]
26 * Improving the means by which you can migrate from mediawiki to
27   IkiWiki. See [[tips/convert mediawiki to ikiwiki]] and the
28   [[plugins/contrib/mediawiki]] plugin.
30 I am mostly interested in ikiwiki usability issues:
32  * [[bugs/the login page is unclear when multiple methods exist]]
33  * [[bugs/backlinks onhover thing can go weird]]
34  * [[todo/CSS classes for links]]
35  * [[todo/adjust commit message for rename, remove]]
37 The following I have been looking at, but are on the back-burner:
39 * an alternative approach to [[plugins/comments]] (see
40   [[todo/more flexible inline postform]] for one piece of the puzzle;
41   <http://dev.jmtd.net/comments/> for some investigation into making the post
42   form more integrated); possibly also [[todo/pagespec to disable ikiwiki directives]]
43 * a system for [[forum/managing_todo_lists]] (see also
44   [[todo/interactive todo lists]] and <http://dev.jmtd.net/outliner/> for the
45   current WIP).
46 * a `tag2` plugin, which does the same thing as [[plugins/tag]], but
47   does not sit on top of [[ikiwiki/wikilink]]s, so does not result in
48   bugs such as [[bugs/tagged() matching wikilinks]]. Code for this lives
49   in my github `tag2` branch: <http://github.com/jmtd/ikiwiki>
51 Penultimately, the following are merely half-formed thoughts:
53  * adding and removing tags to pages via the edit form by ticking and
54    unticking checkboxes next to a tag name (rather than entering the 
55    directive into the text of the page directly)
56  * perhaps the same for meta
57  * I'd like to make profiling ikiwiki in action very easy for newcomers.
58    Perhaps even a plugin that created a file /profile or similar on build.
60 ## backlinks
62 Finally, backlinks (since I have issues with the current backlinks
63 implementation, see [[bugs/backlinks onhover thing can go weird]]):
65 [[!map pages="link(users/Jon)"]]