Help:Contents
From Glfwiki
MediaWiki which is used to generate this website is a free software wiki package written in, originally for use on Wikipedia. And is now used by several other projects including this one.
Contents |
Getting Started
For better understanding of how this software works, one should know something about Hyperlinks,Browsers, HTML.
Also see
Editing the pages
Next thing to learn about the wiki is how to edit pages
Do not be afraid of this, it can be as easy as creating simple Word document
1. There is an edit tag at the top of each page When clicking on it, the page changes into a word processor style
2. You can type your text in the window Some formatting is available for you at the top of editing page (bold, italic, etc.)
3. When you are happy with the text you have edited at the bottom of the page there is a Save page, Show preview, Show changes buttons. This allows you to save your contribution, see preview of your page or see the changes you have made respectively
4. You can also see some icons at the top of editing page. Clicking them you can place code markers in the text sow the browser interprets them to allow basic formating (bold,italic), creats links, uploads images, etc.
5. Links appearing in the text can be blue or red.
Blue ones are the Internal MediaWiki pages that hold existing article (purple when you have already vistied the page), red ones are still empty (article diesn't exist) and needs to be written.
See the Editing pages
Creating Links
Links that can be embedded in the text can be Internal MediWiki pages or External pages (any web page outside of MediaWiki).
Links are signified in the text using square brackets
- Internal MediaWiki page links have double square brackets like [[Main Page]]
- External pages have single square brackets around the web page address you want to link to and a name of a link you want to appear in MediaWki text separted with a space. [http://www.webaddress.com name]
New MediaWiki pages are generated when putting double square brackets around the words (that will be a page name)
- E-mail links can be created using form [mailto:anyone@example.org address name] that results in address name
See the Links.
Generating new pages
There are several ways of starting a new page:
1. Creating Internal MediaWiki pages (see above)
Usually this is the best way to create a new page, because it means that right from the start, the page will be linked from at least one other place on the MediWiki.
When creating a new page without any link to it, you should ask yourself: Does this page really fit in with the topics already covered in the wiki? How are you expecting visitors to find this page? Usually there is no reason to create a page without first creating a red link to it.
2. Using URL
You can use the MediaWiki's URL for creating a new page. The usual URL to an article of the MediaWiki looks something like this: ''http://www.example.net/index.php/ARTICLE '' or ''http://www.example.net/wiki/ARTICLE''
If you replace the word ARTICLE in the URL with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet.
Then click the "Edit" page tab at the top of the page. Typing your text, and clicking save a new page by clicking Save page button at the bottom of the page.
3. Using Search box and Go button (on the left of the page)
If you search for a page that doesn't exist yet then you will be provided with a link to create the new page.
It doesn't work if you use search button instead of go
See the Starting a new page
4. List of Missing articles that are already linked to existing ones is located in Navigation bar on the left side of wiki page. One can create an article by clicking on the red link to the missing article.
Headings
- Headings organise your writing into sections. The Wiki software can automatically generate a table of contents from them.
==Headings==
- Subsection
===Subsection===
Using more equals signs creates a subsection.
- A smaller subsection
====Smaller subsection====
Don't skip levels, like from two to four equals signs.
!Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title!
Return to the Table of Contents
Use the Return to the Table of Content function after each heading or section. That allows a reader to get back to the Table of content. Especially helpful when pages are getting extensive.
Simply place
<font size=1>[[#toc|TOP]]</font size>
after the heading and insert an empty line before starting the text. That will generate TOP anchor that will take readed back to the Table of Content
Create a link to the heading (anchor)
Headers automatically become HTML anchors, which can be linked to in the wiki text.
Referencing anchors:
Inside a regular wikilink [[page#anchor_name|shown_up_as]], define a page name, include the hash sign (#) and the header name.
Example:
[[Help:Contents#Headings|Headings]] creates an anchor in the text Headings
Reference
Information provided in this site aims to be scientific and evidence based. Therefore we expect the editors to reference the information provided.
Creating a reference:
- The <ref> tag is that it inserts the text enclosed by the ref tags as a footnote in a designated section, which you indicate with the placeholder tag <references />.
!If you forget to include <references /> in the article, the footnotes will not appear, but a red error message will be displayed at the end of the page!
Example:
According to scientists, the Sun is pretty big.<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>
===Notes===
<references/>
will appear as
According to scientists, the Sun is pretty big.<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", Scientific American, 46 April 1978): 44-6.</ref>
Notes
<references/>
Tables
There are two ways to enbed tables in the wiki:
- Upload a table as an image. Used when table is taken out of some text and saved in typical file format as .jpeg, .gif, .png, etc (See Upload file)
- Create a desirable table in Microsoft Excel or similar programme. Convert it in wiki text when using free online tool. Copy the result and paste in desirable place in your wiki text.
Templates for editors
To help you- the editor and to keep a unified style of our wiki we would like to suggest using our templates when writing articles and creating your profile:
To use the Template a code is placed in the page that allows a substution of the code for the template text.
- In order to include Drug General Template in the text use function
{{subst: Drug General Template}}
- In order to include Disease General Template in the text use function
{{subst: Disease General Template}}
- Creating your Personal Profile insert
{{subst: Personal Profile}}
We do understand some of the fields may not be relevant to your article, so feel free to modify it.
To use the template:
- Create the new page in the normal way <a> Create pages</a>.
- Edit and insert one of the above functions at the top of the page.
- Save by clicking Save page button at the bottom of the page.
- Re-edit and fill the respective sections of the template with your content.
Formatting
- You have some basic formatting available in the editing mode as tags at the top of the page
- To create bullet points
- use star symbol (*) in front of the statements appearing in the new line
- use double (**) or triple(***), etc star symbols for under bulleting (as seen this this sentence)
- To create numbering
- use hash (#) in front of the statements appearing in the new line
- use double (##) or triple(###), etc hash symbols for under bulleting (as seen this this sentence)
- When using symbols that are used in MediaWiki syntax to appear in a normal text use the <nowiki>Insert non-formatted text or symbol here</nowiki> syntax. It is also available in your editing page among the other formatting tags
- Creating a 'warning box' like the one bellow
warning box
Simply leave a space in fornt of statement when starting a new line
- Keep breaking(empty) lines when you wnat to have statments appear in the new line
See the Formatting
Upload File
Images, pdf files and Flash presentations can be uploaded and embedded in the pages or hyperlinked - see Upload file link in the side menu and for more explanation there are details on an Upload File Page
- Upload File - how to load - files types - displaying
Categories
MediaWiki allows you to categorise pages and files by appending one or more Category tags to the content text. Adding these tags creates links at the bottom of the page that take you to the list of all pages in that category, which makes it easy to browse related articles.
List of main categories that are suggested to be used in Pharmahost.org project are listed on the Main Page as Index of Categories. We recommend adding categories at the top of the article you are writting (before the Introduction heading). One must add all the related Categories and subcategories to the article. (We suggest following index structure when adding them).
- Add a page to a Category, simply put the following in the page you are editing:
[[Category:Category]]
- Category is a special page that can be edited as any other wiki page. You can create a Category page in the same way as any other wiki page.
Just remember to add Category: before the name of the category.
- To create a link to a category, use a leading colon as in
[[:Category:Category]]
anywhere in wiki text. To display alternate text for the link, add that after a pipe as with other internal links
[[:Category:Category|Specific Category]]
Subcategories
To keep articles structured and have a hierarchy, we propose using sub-categories.
- Sub-category is created in the same way as category (see above)
- 'Higher' category is being added to the sub-category in the same maner as to the regular page.
Enjoy
We think you are ready to start contributing to this collaborative repository of knowledge.
As an editor you have to request a username and passowrd from Project administration team. Once you have your log in details, use log in section at the top right corner of the page. And enjoy!
If you still have some quetions or want to find more about the software you are about to use consult MediaWiki