Media Wiki Editing: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
 
(2 intermediate revisions by the same user not shown)
Line 472: Line 472:
}
}
</syntaxhighlight>
</syntaxhighlight>
=Math=
{{External|https://en.wikipedia.org/wiki/Help:Displaying_a_formula}}
<math>1 + m + m^2 + m^3 + ... + m^{n-1} =  \dfrac{m^n-1}{m - 1}</math>

Latest revision as of 20:16, 24 July 2024

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.

The size of the font in the indented block can be controlled with:

In somewhat smaller font.

In-Line Code

The in-line code is marked using the <code> HTML tag. It looks like this: this is some code. For more details, including how to change the rendering, 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 Use:

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

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

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

https://www.mediawiki.org/wiki/Help:Tables

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

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

Headers

{|
! Header1
! Header2
! Header3
|-
| ...

A specific style to a header can be specified with:

{|
! style="text-align:left;"| Header1
...

Borders

{| class="wikitable" style="text-align: left;"
! Header1
! Header2
! Header3
|-
| . || . ||
|-
|}

List in a Table Cell

{| class="wikitable" style="text-align: left;"
| The next cell contains a list || 
* a
* b
* c
|-
|}
The next cell contains a list
  • a
  • b
  • c

Without bullets:

{| class="wikitable" style="text-align: left;"
| The next cell contains a list || 
line 1<br>
line 2<br>
line 3
|-
|}

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 behind and at the right of the image

[[Image:somefile.png|left|300px|caption]]
Fidelity Options Class
Options 3jd.png





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%;
}

Math

https://en.wikipedia.org/wiki/Help:Displaying_a_formula