History:Updating To MoinMoin 1.5

Updating to MoinMoin 1.5

Purpose

The MusicBrainzWiki is about to be updated to the current stable version of MoinMoin (1.5.x).
This page should track all issues that will be encountered in the migration, and discussion on the best way to fix them.

A testing instance of MoinMoin 1.5 is available at http://newwiki.musicbrainz.org.

The related ticket is 2320.

Issues

• There are/may be a number of issues with the new style layout in MoinMoin. Having to bug a developer each time we have such a (probably trivial!) issue with a css file is not really practical, and its quite likely that more issues and adjustments needed will raise once the MB theme will be patched to work with 1.5.
  • List of known issues:
    • there no longer exist an elegant way to have TOCs floating on the right of the screen (see http://newwiki.musicbrainz.org/WikiWardening). We want to contact the wiki community, think about a (new) general style for TOCs, and hack the stylesheet so it fits our wishes

• • Problem is: having to bug a developer each time we have an issue with something in a .css file is not really practical for anybody. While on the other hand, we are ready to take on us the burden to draw a consensus from the community on "css-style" questions, and hack the stylesheets ourselves (dmppanda is competent, possibly others). Here's a crazy suggestion (not sure if it's feasible or not):
    • symlink stylesheets to wiki pages
    • ACL the wikipages so only the CssGroup can edit them

• • Additional benefit of this suggestion is that we could actually help in migrating the old theme -- dmppanda 15:11, 18 May 2007 (UTC)

TODO

• change icons for interwiki and external links
• update the MusicBrainz skin
• update / clean InterWiki table
• check eventual regressions in transclusion of wikidocs

Low priority TODO

• 1799 patch moin so it produces valid xhtml
• 2760 typo when unsubscribing (isn't this an upstream bug?)

DONE

• check the address obfuscation system working
• check cards behavior:
  • old cards are working as far as I can tell
  • I can't use the new syntax though. From macro/CardMacro I should be able to use parameters eg [[Card(Cards/WikiNavCard,test1)]]. See: http://newwiki.musicbrainz.org/Cards/ArtistHeader for a non-working example. Am I missing something? -- dmppanda 20:31, 02 May 2007 (UTC)
  • There seem to be multiple, incompatible "Card" macro plugins around, with misleading docs. Check out the page now... - DaveEvans
  • WFM! -- dmppanda 23:13, 17 May 2007 (UTC)

• fixed the WikiSpamProtection system

Interesting patches which may be applied

FeatureRequests/TableOfContentsMinDepth: allow to specify a min depth with the TableOfContents macro.

With version 1.5, the page name is no longer automatically placed at the top as a title. So we'll have to use first-level headings to manually add a title. Problem is, that gets included in the TOC, which is not helpful.

• Or, change the theme(s) to re-include the page title in the familiar place. - DaveEvans
  • As with this hack the title won't appear anyway on the transcluded doc, I would really prefer the suggested patch to be applied (which gives much more flexibility to TOCs), of course if this is not too much an hassle. -- dmppanda 20:18, 02 May 2007 (UTC)
  • Check out the "modern2" theme, compared to the (default) "modern" one.
  • We need H1 for wikidocselt pages, so I would actually consider it a benefit, if the theme would not show the title, but only the page did --DonRedman
  • I don't know what "wikidocselt" is, but if you mean what I know as "wikidocs", Moin 1.5.7 is compatible with 1.3.5 in this respect - neither version includes the page name as part of the extracted content. - DaveEvans
  • Yes, wikidocselted WikiPages are WikiDocs. I think our point here is: we need H1s in WikiDocs - so, we need to add them in WikiPages anyway, whatever if the wiki theme adds an extra page title or not. Hence, it makes TOCs a bit ugly, and this patch could really be useful. Now, as I said, if adding this patch is too much of an hassle... we can live with that... -- dmppanda 11:48, 07 May 2007 (UTC)
  • I have to say I don't really understand. Maybe we'll catch up on IRC sometime. Mostly what I don't understand is: Why do you say "we need H1s"? What do you mean by that - that the H1 needs to be part of the page content, or that the H1 needs to precede the page? Neither 1.5.7 nor 1.3.5 include H1s as part of the page content. - DaveEvans
  • Ok... I'll try to make it clear: we need (and want) to have titles in the wiki page content, specified by hand, using the h1 wiki equivalent syntax = Title = - no matter if the wiki prepends (outside of the page content) an additional page title or not (actually, would be better without IMO). The reason for that is that once transcluded, we want pages to have a title (which is not prepended anymore by the wiki theme of course). Having to do so, we end-up with TOCs that don't really look good - unless we have that mindepth patch. In the hope this is a bit more clear... as for IRC, sure! I'll try to hang out there next week. -- dmppanda 18:11, 17 May 2007 (UTC)

• Another solution is to use #pragma section-numbers 2 in the header of the page. See here for an example. I've tested the patch provided in FeatureRequests/TableOfContentsMinDepth and I think that we should use the #pragma method. The patch works but its usage is confusing and its syntax really strict.-- murdos 23:36, 02 June 2007 (UTC)

• Ok for the pragma stance. Your investigation seems to suggest the patch is not worth it. If this is the case, I suggest you delete this whole discussion blurb, mark this point "fixed", and keep a note about pragma usage so we remind to add it somewhere in the docs after the migration. -- dmppanda 07:34, 03 June 2007 (UTC)