Tips and tricks: Difference between revisions
(→Markup) |
(→Markup) |
||
| Line 21: | Line 21: | ||
== Markup == | == Markup == | ||
Writing markup and especially about markup in markup is maddening. Use edit source to see how things are done and what's going on when in doubt. | |||
ma | |||
<code><nowiki><nowiki>...</nowiki></nowiki></code> | <code><nowiki><nowiki>...</nowiki></nowiki></code> | ||
| Line 28: | Line 31: | ||
<pre> | <pre> | ||
The pre tag ignores [[Wiki]] | The pre tag ignores [[Wiki]] ''markup''. It also doesn't reformat text. It still interprets special characters: → | ||
It also doesn't reformat | This example shows how the above markup reference is generated - | ||
<code><nowiki><code><nowiki><!-- popup [[File:Desired_Preview_Image.jpg]] --></nowiki></nowiki><nowiki></code></nowiki></code> | <code><nowiki><code><nowiki><!-- popup [[File:Desired_Preview_Image.jpg]] --></nowiki></nowiki><nowiki></code></nowiki></code> | ||
</pre> | </pre> | ||
End | End | ||
Revision as of 17:57, 6 November 2022
This page collects tips on how to create good content in spite the vagaries of the MediaWiki ecosystem. Things people struggled with or are byzantine to get to work should be documented here to reduce suffering. Available external help pages are linked to where possible.
Naming
File names
Page names
Note page names are case sensitive and capitalisation of headings and file names becomes an issue.
Navigation popups are nice feature, but all too easy to break or make ugly.
Text required at page head
Before any headers, a paragraph of body text is required for the popup to display correctly and not generate an error. This text should summarise the page in a couple of sentences which is what appears in the popup.
Images
To make Navigation_popups show an image (which is preferred), the image apparently needs to be included on the page and downloaded on page load -- if a gallery image, for instance, this is not the case.
Use this <!-- popup [[File:Desired_Preview_Image.jpg]] --> hint in source edit to use any particular image.
Markup
Writing markup and especially about markup in markup is maddening. Use edit source to see how things are done and what's going on when in doubt.
ma
<nowiki>...</nowiki>
<nowiki><nowiki>...</nowiki></nowiki>
<code><nowiki><!-- popup [[File:Desired_Preview_Image.jpg]] --></nowiki></code>
The pre tag ignores [[Wiki]] ''markup''. It also doesn't reformat text. It still interprets special characters: → This example shows how the above markup reference is generated - <code><code><nowiki><!-- popup [[File:Desired_Preview_Image.jpg]] --></nowiki></code></code>
End
