Help:Manual

From
Revision as of 13:51, 26 October 2020 by Alexander Zilliacus (talk | contribs) (β†’β€ŽπŸŒ± Creating new pages and categories)
Jump to: navigation, search

Welcome to the ENVRI wiki manual! This page contains instructions for navigating and contributing to the wiki.

New to wikis? Not to worry! The amount of menus and tabs can seem daunting at first, but once you get the hang of it, you'll find that this way of organising information can be quite powerful. You'll find all the basics below.

🧭 Navigation

At its core, every page of a wiki is a normal webpage, and you navigate by clicking links (which look like this). Pages contain regular web content: text, images, video, and so on. Here's an example:

A red link means that the page does not (yet) exist on the wiki. We'll talk more about this under "Contributing" below.

If you get lost, you can always return to the Main Page, either by using the first link in the navigation bar to the left side of your screen, or by clicking the logo to the top right. Also try using the search bar in the top right corner.

πŸ—ƒοΈ Categories

Pages have no particular order, so to help sort them they are organised into categories. Pages can belong to multiple categories, so there are many ways to sort a page. To find which categories a page belongs to, scroll down to the very bottom of that page. (However, note that this page doesn't belong to any category!) You'll find a category bar showing which categories the page balongs to:

Categories bar example.png

Clicking on any of the blue links will take you to a category page, which lists all the pages and/or sub-categories which belong to that category. These have the "Category:" prefix in their title. Here are a couple of different kinds of category pages:

  • Category:Page_Tree contains only other categories (in fact, the ones that appear in the navigation bar).
  • ENVRIplus contains both page content (text, images, and tables), sub-categories, and other pages.

Most pages belong to a sub-category of one or more top-level categories. The top-level categories are: document type, domain, keyword, project, and theme. You can always find these in the navigation bar to the left. Pages usually don't belong directly to top-level categories, but rather to a more specific sub-category. Click the little triangles next to the top-level categories to show their sub-categories. Remember that the Main Page contains a more complete listing of categories, and more space to fold them open!

Top-level categories example.gif

That's it! With this you should be able to find your way around the wiki. If you feel that you would like more help, don't hesitate to contact us at manager@envri.eu! This manual will also be expanded with time, including images and video material.

✏️ Contributing

So you've found an error, or you'd like to contribute some new knowledge to the wiki. Now what?

What makes a wiki different is that anyone can edit the pages – so the good news are that you can get started right away! You can edit the page you're on by using the "Edit" tab in the top right corner (next to the search bar). You can find all previous edits of a given page under the "View history" tab.

Search bar and edit controls example.png

⚠️ Be aware that anonymous edits may be revoked! If you want to contribute more, and in your own name, please contact us and get a permanent user name.

All content is written using so-called wikitext. For regular body text, simply write. For headings, surround your heading with '=' signs according to its hierarchical depth. =Level 1 heading=, ==Level 2 sub-heading==, ===Level 3 sub-heading===, and so on. Here are some basic text formatting options:

1️⃣ Writing this... 2️⃣ ...results in this.
For ''italic text'', use two single apostrophes. For italic text, use two single apostrophes.
For '''bolded text''', use triple apostrophes. For bolded text, use triple apostrophes.
Here's a link to the [[Main Page]]. Here's a mis-spelled link to the [[main page]]. Here's a link to the Main Page. Here's a mis-spelled link to the main page.
For external links, simply paste the URL: https://www.envri.eu/. For a custom link text, use only a single bracket containing [https://www.envri.eu/ the URL and desired link text]. For external links, simply paste the URL: https://www.envri.eu/. For a custom link text, use only a single bracket containing the URL and desired link text.
<ref>An (automatically numbered) in-text citation, which will appear in the "References" section.</ref> [1]
The "References" section appears wherever the... <References/> ...tag is placed on the page. The "References" section appears wherever the
  1. ↑ An (automatically numbered) in-text citation which will appear "References" section.
tag is placed on the page.

For more options, you can refer to MediaWiki's own manuals on Formatting and Links.

🏷️ (Re-)categorising pages

Do you think a page is missing from a category, or has been mis-categorised? Nice catch! You can re-categorise the page changing its category tags.

  1. Start by looking inside the top-level categories for a more suitable sub-category.
  2. Edit the page which you want to (re-)categorise, and look for the category tags. They are generally (but not always) found at the bottom of the page, and look something like this: [Category: Report] [Category: Solid Earth] [Category: ENVRIplus].
  3. Delete the wrong categories and add the rights ones. Save your edits.

🌱 Creating new pages and categories

So you want to create a completely new page, or perhaps even a completely new category?

  1. Write the title of your new page into the search bar. For a category, use the "Category:" prefix, so, eg. "Category:My new category".
  2. Click the bold, red link after "Create the page . . . on this wiki".
  3. Enter your content, add the correct category tags, and save your edits.
  4. Done!

Non-existing page search example.png

πŸ“Š Figures and tables

Coming soon.

🎨 Style guidelines

Whether you're just editing existing pages or creating new ones, it's good to try and keep the style consistent across the wiki.

βœ”οΈ Do's

  1. Edit proactively! Your expertise and input is valuable for keeping the wiki relevant for the whole community.
  2. Refer to the wiki in your own communications, and encourage others to contribute as well.
  3. Keep it simple! Try to organise the content mainly using headings, links, and lists. Too much formatting makes the text very hard to follow.
  4. Aim for clarity... Optimally, a first-time reader should be able to figure out what it is they are looking at.

❌ Don'ts

  1. ...but avoid repetition. Leave out generic background information, eg. concerning projects, which is available elsewhere on the wiki, and instead use links to point to that information!
  2. Avoid custom categories for collecting your own pages. Instead, try to fit your content into the existing content structure.
  3. Don't delete pages carelessly. If a page has become obsolete, consider instead adding some information explaining why (and where to get more up-to-date information).

☝️ Tips for advanced users

MediaWiki supports regular HTML and CSS markup, but use this sparingly! Avoid tags and inline CSS, and instead familiarize yourself with the classes available in MediaWiki:Common.css.

Here are some common classes that you may find useful:

mbox and mbox small

πŸ’‘ A simple, 100 % wide message box. Emojis are a useful addition to indicate the intent of the box. Mainly used to indicate temporary solutions or other things to notice on the page, so avoid mboxes as part of actual page content.
πŸ’‘ Same as above, but only 50 % wide.

figure and tablecaption

See previous section on figures. Edit these to change the look of figures and tables across the wiki.

navFrame and Infobox

See next section on templates. Edit these to change the look of navFrames and infoboxes across the wiki.

πŸ–‡οΈ Understanding templates

One of MediaWiki's most useful features is transclusion – moving the template Coming soon: what are templates? List of common templates in use on the ENVRI wiki, links to more resources.


Here are some commonly used templates on the ENVRI wiki:

InfoBox NavFrame

πŸ“– About this manual

⚠️ Temporary section, likely to be deleted!

Subpage structure:

  • Help:Manual: Navigation, Constributing, Contact
    • Help:Manual/lighthouses
    • Help:Manual/templates
    • Help:Manual/guidelines