Writing Articles

From Notepad++ Wiki
Jump to: navigation, search
Writing Articles


MediaWiki Markup Language

NpWiki++ is built on the MediaWiki platform. Articles are written in MediaWiki Markup Language which gets translated to HTML for display on the computer screen. The markup language specifies formatting such as headings, bullet and numbered points, and character styling.

References for markup language include:

How to edit existing articles

To edit an existing article, either:

  • Click on the 'Edit' hypertext link on the right side of a heading or,
  • Click on the 'Edit' tab at the top of the page. (if you can’t see these Edit links then you are not logged in or it is a page you are not allowed to edit.)

Next, use MediaWiki markup language to edit the page or section you have opened for editing.

Finally, click on Preview to see your changes, Save to save your changes or Cancel to cancel the changes.

Discussion pages, but also some regular pages, have an extra, narrow tab at the top with a "+" sign. When this is present, it can be used for an alternate, guided editing. Clicking on the tab displays a form that asks for two things:

  1. A new section name
  2. The contents of the section

Depending on the purpose of the page, regular edit may be disabled, discouraged or used for different kinds of input. It is the responsability of the page front matter to state the intended use of either edit mode.

How to create new articles

There are basically two ways to go about it:

Starting afresh

If you just got the idea that some new page was to be written, you can type the following URL:

https://sourceforge.net/apps/mediawiki/notepad-plus/index.php?title=My Wonderful Page&action=edit

Punctuation is allowed in titles, as SourceForge will obligingly translate them into proper coding. If you try something very weird, like encoding control characters in the title, that will be rejected.

You can leave the "&action=edit" part out: in that case, you'll be presented with a page telling you that the page does not exist - which you knew - and proposing you to edit it.

Then a blank page will open (see #Editing Toolbar), and everything now is about editing a page; it's just that it had no prior text.

Linking from another article

It is not uncommon to have the idea of some page as you read or write some existing text. As you will learn soon or already know, the syntax for linking to some Wiki page in the same wiki is [[Page name]] or [[Page name | Some more convenient text]]. Writing either, when previewing or saving your page, will result in a red link (regardless of your browser's settings) if the page does not exist. Sometimes it is because of a typo in the page name. Sometimes it is simply that you wish to create the page.

On clicking the link, another page will display, telling you you attempted to go to a page that does not exist. You then have a choice between searching for the text, editing (ie creating) the page or bailing out.

The editing toolbar

Here is what it looks like:

Wikibar.png

The buttons display tooltips when hovering on them with the mouse, which explain what they do:

  1. Turn selection into '''Bold text'''
  2. Turn selection into '''''Italic text'''''
  3. Turn selection into [[Link title]]
  4. Turn selection into [http://www.example.com link title]
  5. Turn selection into == Headline text == and insert a newline before
  6. Turn selection into [[Image:Example.jpg]]
  7. Turn selection into [[Media:Example.ogg]]
  8. Turn selection into <math>Insert formula here</math>
  9. Turn selection into <nowiki>Insert non-formatted text here</nowiki>
  10. Insert your signature: --~~~~
  11. Insert horizontal line: ----