WikiDocs Conversion: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(major update (Imported from MoinMoin))
(Original content from 2006 and dealed with the MoinMoin conversion process.)
 
(27 intermediate revisions by 7 users not shown)
Line 1: Line 1:
#REDIRECT [[WikiDocs]]
=WikiDocs Conversion Process=

The [[Wiki Web Service|WikiWebService]] is a part of the planned [[WikiDocs]] system This page should list all conversions that the web service has to do.

''Status:''' ''This starts to be up to date again.''


==Correct URLs==

There are a couple of URLs that will not work as expectet, when the content is transcluded through the [[Wiki Web Service|WikiWebService]]:
* Links to attachements of wiki pages do not work. This needs to be fixed. A correct URL would be <code><nowiki>[[Image:OfficialBio?action=AttachFile&do=get&target=DonRedmanPortrait.jpg]]</nowiki></code>. However, the page on Attachements says that this link is subject to change. See [[MoinMoin:HelpOnConfiguration/FileAttachments|HelpOnConfiguration/FileAttachments]] for details, security issues, and why they want to remove tht option in the future.
* Currently the [[Wiki Web Service|WikiWebService]] already does some minor link rewriting to fix problems with relative links. It seems that the the wiki returns some links like <code><nowiki>http:/page.html</nowiki></code> (relative links). These are rewritten to absolute links like <code><nowiki>http://www.musicbrainz.org/page.html</nowiki></code>.

==Remove the Link-to-Outside Icon==

''This only needs to be done on [[WikiDocs Page|WikiDocsPage]]<code><nowiki></nowiki></code>s, wiki pages do not need this.''

Liks to the outside world (of the wiki!) like [http://google.com this one] are rendered with a special icon in formt of the link. This icon signals that you will leave the wiki if you follow the link.

The problem is that links to [http://www.musicbrainz.org/ http://www.musicbrainz.org/] are ''external'' to the wiki. Therefore all links to static [[MusicBrainz]] pages will have this icon. The transclusion mechanism must therefore remove this icon. In a perfect world, it would only remove it for pages on musicbrain.org. But I suppose that this is too difficult and IMO it is ok if it just removes the icon alltogether.

A ''very simple'' solution would be this: Can the Theme (or the Formatter?) add a css class to this icon? In this case it could simply be removed with a css line like <pre>.ExtraWikiIcon {display: none}
</pre>

The [[MoinMoin:InterWiki|InterWiki]] icon can be kept, IMO.

==Differntiate Between Links to WikiDocs and Links to Wiki==

''This only needs to be done on [[WikiDocs Page|WikiDocsPage]]<code><nowiki></nowiki></code>s, wiki pages do not need this.''

When a user sees a [[WikiDocs]] page via the [[Wiki Web Service|WikiWebService]], those links that point to other [[WikiDocs]] pages should look like normal links, while those links that point to pages which only exist in the [[MusicBrainz Wiki|MusicBrainzWiki]] should look like links to somewhere else.

A simple formatting can just render inter-[[WikiDocs]] links bold and [[WikiDocs]]-to-wiki links plain. A fancy formatting could prepend a wiki-icon to [[WikiDocs]]-to-wiki links.

The following tabel summarizes, what conversion should be done in which case:
{| border="1"
|-
| Page in [[Title Index|TitleIndex]] of [[MusicBrainz Wiki|MusicBrainzWiki]] || Page in [[Moderated Revision Table|ModeratedRevisionTable]] || Action taken
|-
| Yes || Yes || Link is normal or bold
|-
| Yes || No || Link is thin or has wiki icon
|-
| No || Yes || [[Image:Alert.png]] Send a warning to admin. With [[Moin Moin|MoinMoin]] this means that someone has renamed the page, effectively moving the history to the new page name.
|-
| No || No || [[Wiki Name|WikiName]] should not be presented as a link at all
|}

==Remove Unofficial Content==

I am not at all sure, whether we need this. There might be some good way around this, like using discussion pages. However, should the need arise, then we could add our own "official" tag to the [[MusicBrainz]] wiki in an XML-style: <pre> <official>
bla bla
</official>
</pre>

The [[Moin Mion|MoinMion]] engine will of course ignore these tags. It will just display them. That is ok. Users will see the tags (when accessing the wiki via [[Moin Moin|MoinMoin]]) and it will have ''meaning'' to them.

When the [[Wiki Web Service|WikiWebService]] gets a page as a [[WikiDocs]] page, it will look for these tags, and ''if'' it finds such tags (in the text not in the html code!), it will remove everything outside the tags and then the tags tehmselves in the [[Shadow Wiki|ShadowWiki]] version of that page. This way the source of a wiki page can contain stuff that will not be visible when transcluded.

----initial author: [[User:DonRedman|DonRedman]]

[[Category:To Be Reviewed]] [[Category:Development]]

Latest revision as of 04:24, 25 October 2009

Redirect to: