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

• TOCs are now embedded in a table: you can't have any more a floating TOC on the right of the page (in fact you can but you must embed the TOC table in another table, but this looks ugly).
  • Example: WikiWardening / http://newwiki.musicbrainz.org/WikiWardening
  • Possible solution: use MoinMoinPatch/AlterTableOfContentsAppearanceWithStyleSheet (it should be in the official release now) to set a global style to TOCs
    • The suggested hack doesn't necessarily "look" ugly if the containing external table is styleless-ed, though I agree this is a ugly hack :-) . Note that it won't be the first time we use table-style hack to have things rendering as we want them... -- dmppanda 20:18, 02 May 2007 (UTC)
      • see http://newwiki.musicbrainz.org/murdos: the external table has the minimum style (float:right;), but it still ugly because of the style used for the TOC itself. I'm all for a general style for all pages, so that we would just have to call anywhere the TOC macro without hack ... -- murdos

TODO

• change icons for interwiki and external links
• update the MusicBrainz skin
• update / clean InterWiki table
• check eventual regressions in transclusion of wikidocs
• 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

• fix the WikiSpamProtection system
• check the address obfuscation system working

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)