EditingTips

From RadiWiki
Revision as of 12:42, 23 March 2020 by Jeru (talk | contribs) (Hiding automaticly generated sections)
Jump to: navigation, search

This page contains several tips and suggestions when editing pages on this RadiWiki website.

Internal MediaWiki links

When you are referring to another page within the RadiWiki website, it is best to use a short links.

The disadvantages of the long link are:

  • The writing of the text is more confusing
  • When the link to the website changes, the long links are not working anymore
  • An external link icon is shown behind the link
Not: [http://wiki.dare.nl/wiki/index.php/RadiMation_Application_Note_107   RadiMation Application Note 107]
But: [[RadiMation Application Note 107]]

will result in:

Not: RadiMation Application Note 107

But: RadiMation Application Note 107

RadiWiki Templates

The RadiWiki site provides a lot of usefull templates. A template can be included by using double-curly-braces. See some often used templates below.

RadiMation

The 'RadiMation' template will show RadiMation® correctly formatted. For example:

{{RadiMation}}

will result in:

RadiMation®

MailSupport

A linked URL to support@radimation.com can be included using the 'MailSupport' template. The advantage of this Template is that it also will also use the name of the RadiWiki page as the subject of the e-mail. For example:

{{MailSupport}}

will result in:

radimation-support@raditeq.com

Note

A note box with some text can be created using the 'Note' template. For example:

{{Note|Be aware that the 'Note' template is used!}}

will result in:

Information.png
Note: Be aware that the 'Note' template is used!


Menu

The menu-entries can be created using the 'Menu' template. For example:

{{Menu|Configuration|Configuration|Tab-name|Element}}

will result in:


   Menu.png Configuration
      Menu.png Configuration
         Menu.png Tab-name
            Menu.png Element

Hide the Table of Contents

On several pages it is not desired to also have the Table of Contents (TOC) being shown. The Table of Contents can be hidden on a page, by including the 'Magic keyword': __NOTOC__ on the first line of the Wiki-text.

This is a standard MediaWiki template, and not specific to the RadiWiki.

No article/page not found text

When a page is non existent wiki normally offers you to create a new page. We use this page to show general support information so the customer at least gets re-directed to support. There are two pages that are displayed when a article is not found. One for the users that have permission to edit and one fo users that don't.

Because our users can't edit the pages we need to change http://wiki.dare.nl/wiki/index.php/MediaWiki:Noarticletext-nopermission

When you change this text it will be displayed when a page does not exist.

Editing formula's

Formula's can be entered in a text notation, where they are rendered into the corresponding graphical notation. See displaying a formula for a detailed description.

For example:

<math>Z{t} = \frac{V{p}}{V{in}}</math> 

will result in:

Numbered lists

A numbered list can be created by placing "#" before each row which must be numbered.

For example:

  1. List entry 1
  2. List entry 2
  3. List entry 3
  4. List entry 4

Images within a numbered list

When for example a numbered list is used to communicate step by step instructions in which also images are used. The tag "< BR >"(without the spaces) can be used to add a new line within the numbered list on which the image can then be inserted.

For example:

  1. List entry 1
  2. List entry 2
  3. List entry 3
    NRX-AdvancedSettingsGPIB.PNG
  4. List entry 4

Hiding automaticly generated sections

An automaticly generated section on a page can be hidden from view by passing "|HideAutoData=1" to the macro which adds the generated text.

For example:


" The Rohde & Schwarz NRX device driver is a Power Meter which is supported by RadiMation®."

Using fixed width font to include formatted text

When adding formatted text such as code examples, the first character on a new line must be a whitespace. This shall keep the original formatting of the code from being changed.

For example:

int DeterminePaddingAmount(void) {
    int requiredAmountOfPadding = 0;
    requiredAmountOfPadding = (int)m_PreviousTextString.length() - (int)m_ReplacedTextString.length();
    return requiredAmountOfPadding;

Instead of:

int DeterminePaddingAmount(void) {

   int requiredAmountOfPadding = 0;
   requiredAmountOfPadding = (int)m_PreviousTextString.length() - (int)m_ReplacedTextString.length();
   return requiredAmountOfPadding;