History:Updating To MoinMoin 1.5: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(comments (Imported from MoinMoin))
 
 
(23 intermediate revisions by 6 users not shown)
Line 11: Line 11:
==Issues==
==Issues==


* There are/may be a number of issues with the new style layout in [[Moin Moin|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.
* '''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).
** List of known issues:
** Example: [[Wiki Wardening|WikiWardening]] / [http://newwiki.musicbrainz.org/WikiWardening http://newwiki.musicbrainz.org/WikiWardening]
*** there no longer exist an elegant way to have TOCs floating on the right of the screen (see [http://newwiki.musicbrainz.org/WikiWardening 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
** Possible solution: use [[MoinMoin:MoinMoinPatch/AlterTableOfContentsAppearanceWithStyleSheet|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... -- [[User:dmppanda|dmppanda]] 20:18, 02 May 2007 (UTC)
** 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 ([[User:dmppanda|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 [[Css Group|CssGroup]] can edit them

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


==TODO==
==TODO==
Line 20: Line 25:
* change icons for interwiki and external links
* change icons for interwiki and external links
* update the MusicBrainz skin
* update the MusicBrainz skin
** remove the display of the [[Wiki Page|WikiPage]] name to avoid recurrence with the page title (<code><nowiki>= Title =</nowiki></code>)

* update / clean [[Inter Wiki|InterWiki]] table
* update / clean [[Inter Wiki|InterWiki]] table
** check ticket [[Ticket:2705|2705]]: interwiki syntax for MB source repository
** check ticket [[Ticket:2625|2625]]: interwiki syntax for localized wikipedias

* check eventual regressions in transclusion of wikidocs
* check eventual regressions in transclusion of wikidocs
* check [[Template:WikiNavCard|Cards/WikiNavCard]] behaviour (and other cards behavior as well, especially the new syntax using parameters)
* fix the [[Wiki Spam Protection|WikiSpamProtection]] system
* check the address obfuscation system


==Low priority TODO==
==Interesting patches which may be applied==

* [[Ticket:1799|1799]] patch moin so it produces valid xhtml
* [[Ticket:2760|2760]] typo when unsubscribing (isn't this an upstream bug?)

==DONE==


* check the address obfuscation system [[Image:Checkmark.png]] working
[[MoinMoin:FeatureRequests/TableOfContentsMinDepth|FeatureRequests/TableOfContentsMinDepth]]: allow to specify a min depth with the TableOfContents macro.
* check cards behavior:
** old cards are working as far as I can tell
** I can't use the new syntax though. From [[MoinMoin:macro/CardMacro|macro/CardMacro]] I should be able to use parameters eg <code><nowiki>[[Card(Cards/WikiNavCard,test1)]]</nowiki></code>. See: [http://newwiki.musicbrainz.org/Cards/ArtistHeader http://newwiki.musicbrainz.org/Cards/ArtistHeader] for a non-working example. Am I missing something? -- [[User:dmppanda|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... - [[User:DaveEvans|DaveEvans]]
** WFM! -- [[User:dmppanda|dmppanda]] 23:13, 17 May 2007 (UTC)
** [[Image:Attention.png]] The cards are working but the arguments separator is different: in current wiki we use '|', the test wiki uses ','. If the macro used is this [[MoinMoin:macro/CardMacro|one]], the only thing to change is the parameter ''cardmacro_separator'' in ''wikiconfig.py''. However we started to use macro very recently and I don't think we've a lot of macro with multiple arguments, so we take advantage of the [[Moin Moin|MoinMoin]] update to decide to change the separator. -- [[User:murdos|murdos]] 20:42, 03 June 2007 (UTC)


* fixed the [[Wiki Spam Protection|WikiSpamProtection]] system
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.
* [[MoinMoin:FeatureRequests/TableOfContentsMinDepth|FeatureRequests/TableOfContentsMinDepth]] patch not needed: we should use ''#pragma section-numbers'' instead
* Or, change the theme(s) to re-include the page title in the familiar place. - [[User:DaveEvans|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. -- [[User:dmppanda|dmppanda]] 20:18, 02 May 2007 (UTC)


[[Category:To Be Reviewed]] [[Category:Wiki]] [[Category:To Do List]]
[[Category:Wiki]]

Latest revision as of 16:11, 25 October 2011

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
    • remove the display of the WikiPage name to avoid recurrence with the page title (= Title =)
  • update / clean InterWiki table
    • check ticket 2705: interwiki syntax for MB source repository
    • check ticket 2625: interwiki syntax for localized wikipedias
  • 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 Checkmark.png 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)
    • Attention.png The cards are working but the arguments separator is different: in current wiki we use '|', the test wiki uses ','. If the macro used is this one, the only thing to change is the parameter cardmacro_separator in wikiconfig.py. However we started to use macro very recently and I don't think we've a lot of macro with multiple arguments, so we take advantage of the MoinMoin update to decide to change the separator. -- murdos 20:42, 03 June 2007 (UTC)