Media Wiki Editing

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

External

Internal

Overview

Links

Internal Links

[[ThisIsALink]]

Internal links that get a label:

[[ThisIsTheLink|This is the label that shows up in text]]

External Links

External links that are rendered verbatim

http://cnn.com

External links that get a label

[http://something.com/something/else Local Label]

Note that "http:" can be omitted:

[//something.com/something/else Local Label]

If you want to avoid a text with an external link syntax to be automatically turned into a link, use <nowiki>:

<nowiki>http://cnn.com</nowiki>

Lists

* List item

Italics

''italics''

Bold

'''bold'''

Code and Fixed Typed Fonts

Code Section in a Box


 <pre>...</pre>

Indented Block

The alternative is to indent the block:

This is
an indented
block

Note that when using this method, MediaWiki is sensitive to the presence of '<source>' element. If you need to use it, use &lt immediately followed by ; to start the element.

However, this method is more flexible, as we can format the text:

This is
a block that contains bold sections and 
RED sections
End.

In-Line Code

This is some code that shows in highlighted rectangle. Also see:

Media Wiki Concepts | <code>

In-Line no-formatting

<nowiki>...</nowiki>

Fixed Type Fonts

<tt> ... </tt>

Alternative highlight for Code

for i in "a b c"; do echo ${i}; done for i in "a b c"; do echo ${i}; done

Use:

<font face='menlo' color='lightslategray' size='-1'>

Paragraph Indentation


:One indent
::Two indents
:::Three indents
:::::: Multiple indent

Anchors and Linking to Anchors

An anchor is a in-page link target - it allows incoming links to target locations on the page other than section headings.

The anchors are automatically generated in case of the section headings. For example, a section named "Section One" generates a Section_One anchor, and the heading can be linked to by prepending "#Section_One" to the usual wiki #Links. In case of multiple sections with identical headings, the anchor names have a "_2", "_3", etc appended starting from the second occurrence.

Manual anchors can be also inserted and used in links:

<span id="anchor_name">text to anchor to</span>

or

<span id="anchor_name"></span>

Do not use:

<span id="anchor_name"/>

it won't work.

Anchor Names

Heading Name Anchor
Test #Test
Section One #Section_One
Capitalization does Matter Capitalization_does_Matter

Special Anchors

#toc links to the table of contents.

Preserving Old Anchors when a Heading Changes

If you want to change a heading to a more appropriate name, but want keep all existing links working, use the old anchor in a span inside the new heading, as follows:

=<span id='Old_Heading'></span>New Heading=

More Details on Anchors

https://meta.wikimedia.org/wiki/Help:Link#Anchors

Tables


{|
| topleft || topmiddle || topright
|-
| middleleft || middlemiddle || middleright
|-
| bottomleft || bottommiddle || bottomright
|}

{|
| . || . || . || . || .
|-
|  . || . || . || . || .
|-
| . || . || . || . || .
|}

More about tables: https://meta.wikimedia.org/wiki/Help:Table

Blockquote

Internal Link

Use this as a border for in-wiki links

<blockquote style="background-color: #f9f9f9; border: solid thin lightgrey;">
:[[SomeLink]]
</blockquote>
SomeLink

Internal Link Template

Alternatively, use this parameterized template: Template:Internal. The first parameter is the target wiki page name, optionally followed by # an the anchor. The second parameter is the name of the link, as it will be rendered in the page.

Example: {{Internal|WildFly Concepts|Concepts}}

External Link

Use this as a border for an external link (on blueish background).

<blockquote style="background-color: AliceBlue; border: solid thin LightSteelBlue;">
:some_external_link<br>
</blockquote>
http://example.com

External Link Template

Alternatively, use this parameterized templates: Template:External and Template:External2.

For External, the first and only parameter is the external link, or text and link:

{{External|http://example.com}}

{{External|something, something else: http://example.com}}

External2 allows for two stacked links.

If the link is to be hidden and exposed as a label:

{{ExternalLabel|http://example.com|example}}

Important Note or Observation, Warning

Use this as a border for important notes and observations on gold background.

<blockquote style="background-color: Gold; border: solid thin Goldenrod;">
:<br>Some content on gold<br><br>
</blockquote>

Some content on gold

Important Note, Observation, Warning Template

Alternatively, use this parameterized template: Template:Warn. The first and only parameter is the warning text.

Example: {{Warn|something to warn about}}

Error

<blockquote style="background-color: Tomato; border: solid thin red;">
:<br>Some content on red<br><br>
</blockquote>

Some content on red

Error Template

Alternatively, use this parameterized template: Template:Error. The first and only parameter is the warning text.

Example: {{Error|some error}}

Images and Media

Default

[[Image:somefile.png]]

Framed Full Size

[[Image:somefile.png|left|frame|caption]]
[[Image:somefile.png|center|frame|caption]]

Image at a Certain Size

[[Image:somefile.png|200px]]

Thumbnail

[[Image:somefile.png|thumb|center]]

Others

text floating:

[[Image:somefile.png|thumb|left|300px|caption]]

To Export Wiki-Ready PNG

Export Wiki-Ready PNG in OpenOffice

PDF

[[Media:filename.pdf|PDF]]
[[File:filename.pdf|PDF]]

There are cases when the above syntax does not result in a link to "PDF". This seems to fix it - note leading colon:

[[:File:filename.pdf|PDF]]

Video

[[Media:video.asf|Video]]

Table of Contents

By default shows up after three headers. If you want to force, use:

__FORCETOC__

Templates

See:

Media Wiki Concepts - Templates

Syntax Highlighting

<syntaxhighlight lang="bash" line='line'>
...
</syntaxhighlight>
function test() {
  echo "this is a function"
}

where lang can be:

  • bash
  • java
  • xml

If the font size is too big, it can be corrected by putting the following CSS code fragment in MediaWiki:Common.css page. The page can be edited on-line at: https://kb.novaordis.com/index.php/MediaWiki:Common.css

/* CSS placed here will be applied to all skins */
.mw-highlight pre {
	font-size: 90%;
}