Difference between revisions of "Help:How to edit an article"

From Coastal Wiki
Jump to: navigation, search
(Links and references)
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
 
This page guides you through the process of editing or writing an article. For information about basic editing and saving, setting up of an account or creating an article, see [[Basic setup, rules and guidelines]]. This page also provides information on the rules and guidelines of the Coastal Wiki and how an excellent article looks like. For some general information about the Coastal Wiki, see [[Coastal Wiki:Why, What and for Whom?]].  
 
This page guides you through the process of editing or writing an article. For information about basic editing and saving, setting up of an account or creating an article, see [[Basic setup, rules and guidelines]]. This page also provides information on the rules and guidelines of the Coastal Wiki and how an excellent article looks like. For some general information about the Coastal Wiki, see [[Coastal Wiki:Why, What and for Whom?]].  
  
Line 82: Line 83:
 
|<Pre>__NOTITLE__</pre>
 
|<Pre>__NOTITLE__</pre>
 
|Page has no auto generated title
 
|Page has no auto generated title
 +
|-
 +
|<Pre><span class="tochidden">Custom title</span> </pre>       
 +
|Use in combination with previous code to add a customized title
 
|}
 
|}
  
 
==Images and tables==
 
==Images and tables==
An article should contain illustrations, boxes and tables, if they are appropriate to the subject, with succinct captions and acceptable copyright status. Try to insert 1 image for every 500 words. When you click '''edit''' you can insert in image, using an image command. '''Save page''' and click on the link to the image in display mode. Upload your image from the list of images or browse and upload a file from you computer. You should see your image now (if not, check the spelling of the image command and if the command contains .jpg). Return to your article through the link at the bottom of the page. Always try to insert your image as a jpg-file.  
+
An article should contain illustrations, boxes and tables, if they are appropriate to the subject, with succinct captions and acceptable copyright status. Try to insert 1 image for every 500 words. When you click '''edit''' you can insert an image, using an image command. '''Save page''' and click on the link to the image in display mode. Upload your image from the list of images or browse and upload a file from you computer. You should see your image now (if not, check the spelling of the image command and if the command contains .jpg). Return to your article through the link at the bottom of the page. Always try to insert your image as a jpg-file.  
  
 
Inserting an image (image command):  
 
Inserting an image (image command):  
Line 176: Line 180:
  
  
===VLIZ Fotogalery (images and movies)===
+
===VLIZ Photo gallery (images and movies)===
  
 
*To add an image or a movie type:
 
*To add an image or a movie type:
Line 200: Line 204:
 
</div></pre>
 
</div></pre>
  
===Semantic Maps===
 
  
The semantic maps plugin enables the creation of complex maps.
 
  
For more info read [[Help:Semanitic maps]]
+
==Links and references==
 +
Important claims or statements need to be substantiated; adding an authoritative reference (or a link to authoritative Internet source) is often better than providing proof in the paper. Important background documents (not subject to copyright) serving as reference material and not available from existing stable websites can be uploaded as separate files (see below).
  
==Links and references==
+
Include references in your text using:
Important claims or statements need to be substantiated; adding an authoritative reference (or a link to authoritative Internet source) is often better than providing proof in the paper. It is recommended to upload important background documents serving as reference material in the CoastWeb Archive (CoastWeb link on the portal). Include references in your text using:
 
 
<pre> Statement (Authorname, year<ref>insert entire reference here</ref>).</pre>  
 
<pre> Statement (Authorname, year<ref>insert entire reference here</ref>).</pre>  
  
To refer to the same reference multiple times, use: <nowiki> Statement (Authorname, year<ref name="name"> ... </ref>)</nowiki>. And to refer to the same references next times: <nowiki> Statement (Authorname, year<ref name="name"/>) </nowiki>  
+
To refer to the same reference multiple times, use: <pre> Statement (Authorname, year<ref name="name"> ... </ref>).</pre> And to refer to the same references next times: <pre> Statement (Authorname, year<ref name="name"/>) .</pre>  
  
To create a list of cited references, type <nowiki><references/></nowiki> in the "References" section. The same procedure can also be used to insert notes at the end of a page.  
+
To create a list of cited references, type <pre><references/></pre> in the "References" section. The same procedure can also be used to insert notes at the end of a page.  
  
Besides references, Coastal Wiki articles should also contain [[links]] to other articles. To refer to another Wiki-article, type: <nowiki>[[ArticleName]] </nowiki>. To refer to a section of a certain article, type: <nowiki> [[ArticleName#SectionName]]</nowiki>. To view another text, than  the naming of an article, type:  <nowiki>[[Articlename|Text you want to appear]]</nowiki>.
+
Besides references, Coastal Wiki articles should also contain [[links]] to other articles. To refer to another Wiki-article, type: <pre>[[ArticleName]] .</pre> To refer to a section of a certain article, type: <pre> [[ArticleName#SectionName]].</pre> To view another text, than  the naming of an article, type:  <pre>[[Articlename|Text you want to appear]].</pre>
  
 
Refer to another website by typing:
 
Refer to another website by typing:
<nowiki> [http://weblink Name of the Website] </nowiki>.
+
<pre> [http://weblink Name of the Website]. </pre>
  
It is also possible to upload documents at the [http://library.coastweb.info/ CoastWeb Library]. Each uploaded document has a specific web address, which can be inserted as an external link in your article.
+
You can upload important reference documents (beware of copyright!) with the link 'Upload file' in the left row of the page (under Tools). Save your edit first. Upload your file (filename.pdf) from your computer. Return to your article through the link at the bottom of the Upload file page. Insert your document at the right place in the text with the command <pre>[[media:filename.pdf|text you want to appear]],</pre> where text you want to appear is a word or a  word string of your choice that will appear in blue and through which the uploaded document will appear.
  
 
To hide a link behind a picture, you may choose to add the #REDIRECT statement ([[Help:How_to_edit_an_article#Basic_Wiki-formatting|see above]]) in the picture page. Alternatively one may use the sitemap statement:
 
To hide a link behind a picture, you may choose to add the #REDIRECT statement ([[Help:How_to_edit_an_article#Basic_Wiki-formatting|see above]]) in the picture page. Alternatively one may use the sitemap statement:

Latest revision as of 17:57, 1 December 2018

This page guides you through the process of editing or writing an article. For information about basic editing and saving, setting up of an account or creating an article, see Basic setup, rules and guidelines. This page also provides information on the rules and guidelines of the Coastal Wiki and how an excellent article looks like. For some general information about the Coastal Wiki, see Coastal Wiki:Why, What and for Whom?.

Basic Wiki-formatting

The table below explains how to do some basic editing at the Coastal Wiki, using the Wiki markup. For more information you can also take a look at the help-pages of the Wikipedia, see Editing tips and tricks, How to edit a page and Cheetsheat with quick references to common formatting. Note that some templates used at the Wikipedia are not available at the Coastal Wiki.

what you type what you see
''italic''
italic
'''bold'''
bold
'''''bold and italic'''''
bold and italic
<u>underline</u>
underline
X<sup>superscript</sup>
Y<sub>subscript</sub>
Xsuperscript

Ysubscript

[[Main Page]] 
[[Main Page|Link to main page]]
Main Page (Internal link to the main page)

Link to main page

[http://www.vliz.be/projects/encora Encora website]
Encora website

(External link to the Encora website)

<span class="plainlinks"> 
[http://www.vliz.be/projects/encora Encora website]</span> 
Encora website

(External link posing as an internal one)

 
==heading==
===level 2=== 
(Creates hedings and generates a table of contents)
alinea<br/>new alinea
alinea
new alinea

(Starts a new alinea)

:left indent
::larger indent
left indent
larger indent
*bullet one
*bullet two
**bullet three
  • bullet one
  • bullet two
    • bullet three
# list one
# list two
## list three
  1. list one
  2. list two
    1. list three
#REDIRECT[[Other article]]
(redirect to another article)
<span style="color:#FFFFFF">text </span> 
Puts the text in white, for other colors

Page has no auto generated title
<span class="tochidden">Custom title</span> 
Use in combination with previous code to add a customized title

Images and tables

An article should contain illustrations, boxes and tables, if they are appropriate to the subject, with succinct captions and acceptable copyright status. Try to insert 1 image for every 500 words. When you click edit you can insert an image, using an image command. Save page and click on the link to the image in display mode. Upload your image from the list of images or browse and upload a file from you computer. You should see your image now (if not, check the spelling of the image command and if the command contains .jpg). Return to your article through the link at the bottom of the page. Always try to insert your image as a jpg-file.

Inserting an image (image command):

 [[Image:filename.jpg|thumb|right|250px|Figure 1: CaptionText]]

This means that a thumbnail of the image is inserted at righthand side, with a size of 250px, with a caption. Instead of placing images at righthand side of the text it is also possible to place them at the lefthand side (“left”) in the centre (“centre”). It is also possible to align no text to the pictures by using “none”.

 [[Image:filename.jpg|thumb|left|250px|Figure 1]]
 [[Image:filename.jpg|thumb|none|250px|Figure 2]]

When you want to align two images horizontally, align the first image “left” and the other image “none”. To prevent subsequent text from being places alongside the images, include the line

 <br style="clear:both;"/> 

If you want to align more than two images, it may be useful to place them in a table. To create a table with more than two pictures, use:

 {|
 | [[Image:File.jpg|thumb|250px|Figure 1]]
 | [[Image:File.jpg|thumb|250px|Figure 2]]
 | [[Image:File.jpg|thumb|250px|Figure 3]]
 |}

To create a basic table in the Coastal Wiki, type:

 {| border="1" cellspacing="0" width="600px"
 |+ Add the text of your caption here
 ! Header 1
 ! Header 2
 |-
 | row 1, cell 1
 | row 1, cell 2
 |- 
 | row 2, cell 1
 | row 2, cell 2
 |}

This creates:

Add the text of your caption here
Header 1 Header 2
row 1, cell 1 row 1, cell 2
row 2, cell 1 row 2, cell 2

You can adjust the width and the style of your table, see e.g. Help Wikipedia tables. Note, not all styles (e.g. prettytable) used at the Wikipedia are available at the Coastal Wiki.

If you want to emphasize a formula, a sentence or something else, you may create a box. Do this by using an interspace at the beginning of a new line.

A box looks like this :-)

To create a single frame around a text use following statement:

<div> insert text here </div>

This frame is undefined. To define your frame:

add:

style ="width=XXpt;border=XXpx solid #00C4C7;background-color:#00C4C7;padding:0.5em 0.5em 0.5em 0.5em;font-size:100%;Float: left"

  • The width can be defined as a fixed with . Or as percentage: Just replace XXpt by XX%. (Make sure to replace XX the chosen frame width)
  • Border thickens can be defined in number of pixels. (usually 1px is sufficient). The border color can be chanced by replacing #00C4C7 by a color code of choice.
  • Padding defines the distance of the frame to other objects: The first em number defines the distance (of everything outside the frame) to the top of the frame, the second from the left, the third from the bottom and the forth from the right side of the frame.
  • Font-size: can be defined as a percentage from the "normal" fond size.
  • Float: you can make your frame float left or right, or you can choose to center the frame. Choose the appropriate option.
what you type what you see
 <div style="border:1px solid #00C4C7;float: right;
padding:0.5em 0.5em 0.5em 0.5em; font-size:150%">
Insert text </div>
Insert text

By creating a frame within a frame, by adding another <div> </div> statement you can manipulate the exact position of the text (including color and sizes) within the frame.

Formulas

You can either use html format or Wiki Math format to insert symbols, formulas or special characters. A good example of an article in which formulas are used is Currents and turbulence by acoustic methods. More information can be found on the following pages


VLIZ Photo gallery (images and movies)

  • To add an image or a movie type:
 <vliz_photo_gallery pic="99011" share="1"></vliz_photo_gallery> 

Where 99011 (of pic="99011") is the id of the image or movie or in the photo gallery. Parameter "share" is default enabled if set to 0 no social share buttons will be added.

Javascript (only for modern browser)

  • Their are a couple of javascripts that can be used to improve the way a page looks:

Hide empty table rows of tables generated with sematic wiki form:

<js_loader filename="hide_empty_tr"></js_loader>
<div class="hide_empty_tr">
...
</div>

Collapse a tree structured unordered list

<js_loader filename="accord"></js_loader>
<div class="accord"> 
...
</div>


Links and references

Important claims or statements need to be substantiated; adding an authoritative reference (or a link to authoritative Internet source) is often better than providing proof in the paper. Important background documents (not subject to copyright) serving as reference material and not available from existing stable websites can be uploaded as separate files (see below).

Include references in your text using:

 Statement (Authorname, year<ref>insert entire reference here</ref>).
To refer to the same reference multiple times, use:
 Statement (Authorname, year<ref name="name"> ... </ref>).
And to refer to the same references next times:
 Statement (Authorname, year<ref name="name"/>) .
To create a list of cited references, type
<references/>
in the "References" section. The same procedure can also be used to insert notes at the end of a page. Besides references, Coastal Wiki articles should also contain links to other articles. To refer to another Wiki-article, type:
[[ArticleName]] .
To refer to a section of a certain article, type:
 [[ArticleName#SectionName]].
To view another text, than the naming of an article, type:
[[Articlename|Text you want to appear]].

Refer to another website by typing:

 [http://weblink Name of the Website]. 
You can upload important reference documents (beware of copyright!) with the link 'Upload file' in the left row of the page (under Tools). Save your edit first. Upload your file (filename.pdf) from your computer. Return to your article through the link at the bottom of the Upload file page. Insert your document at the right place in the text with the command
[[media:filename.pdf|text you want to appear]],
where text you want to appear is a word or a word string of your choice that will appear in blue and through which the uploaded document will appear.

To hide a link behind a picture, you may choose to add the #REDIRECT statement (see above) in the picture page. Alternatively one may use the sitemap statement:

 <imagemap>
Image:image name.jpg|XXpx
default 
[insert internal or external link here]
</imagemap>

Definitions

To explain the meaning of scientific jargon, a linkage should be created to a separate, individual definition page. The creation of individual definition pages enables users to view a glossary with an overview of all articles. To maintain this glossary-function, it is important not to name definitions as "definition of...", not to add add categories and not to combine a definition and an article in one page (this approach differs from Wikipedia)!

Create a definition to a term like this. Type the [[name of definition page]] between brackets in an article. This will create a new page. Save the article click on the link in the text to enter the newly created definition page. Add a definition to this page, using:

{{ Definition|title= name of definition page
 | definition = content of definition}} 

If you want to complement the definition with information, create a short "notes" section. Make sure that you refer to related Coastal Wiki articles, in a "see also" section. Also add a reference to external citations to improve the credibility of the definition. Create a "references" section and add <references/>.

Credit the author

Another important difference between the [http;//wikipedia.org Wikipedia] and the Coastal Wiki is that anonymous will be precluded from the Coastal Wiki. To credit yourself as the main author of an article, type:

 {{author 
 |AuthorID=UserID (e.g. 1234)
 |AuthorFullName= Surname, First name
 |AuthorName=Username}} 

You can find your AuthorName at "my preferences" (at the right-hand side at the top of every page). Your authorname is the same name as your User name. You find you AuthorID in the Contact Database. Search yourself and click on the details of you institute. Select your own name from the list. You will see your authorID at the end of the URL-code (the end is something like persid=1234, use this persid number). If you edit an article, the main author of the article remains the same. Therefore, it is important to inform the main author if you want to make major adjustments.

Categorization

Every article should be categorized by topic. The Coastal Wiki contains 6 main topic-categories, which are each divided into several sub-categories. You find the six main categories at the Main Page. Click on one of the six categories to view the sub-categories. Try to categorize an article at the lowest possible level. E.g. within the category "Coastal and marine environment" you will find Coastal habitats and ecosystems in transitional waters in which you will find Sediment shorelines. Categorize an article about erosion of sediment shorelines in the lowest level "sediment shorelines". You can also categorize this article as e.g. "coastal erosion" and "coastal erosion management". Try to add a minimum of three categories in order to make it easier to be found by different types of users.

To add a category, type:

[[Category:Name of the category]]

Check if the spelling is correct! Categories are sensitive to capital-letters.

New categories can be made simply by adding a non-existing category to a page. You can link a newly created category to a preexisting one simply by adding
[[Category:Name of the preexisting category]]
to the newly created one.

By doing so all categories will be linked in a tree like fashion. You can summon a tree starting at any category to by typing:

{{#categorytree:Name of the category|mode=pages|
style=border:1px solid #23297A; padding:0.7ex; background-color:#f5faff;}}

The first line provides the tree, the second line provides a frame and background in a given color. To change the color of the frame simply change the number.

Alternatively you can try:

 <categorytree mode=pages onlyroot=on>Name of the category</categorietree> 

See also

Add the section "See also" at the end of your article and include the subsections "Internal links", "External links" and "Further reading" if necessary.

Internal links

You may insert internal links in this section.

Go back to the Main Page.

For more information about writing and editing, see Basic setup, rules and guidelines.

External links

You may insert external links in this section.

Some links to the help-pages of the Wikipedia:

Not all help-information from the Wikipedia also applies to the Coastal Wiki!

References

Add the section "references" at the end of your article and create a list of cited references here, by typing <references/> . This creates an overview of all references (and notes) for which this citation is used: <ref>...</ref>

Close the article, by crediting the author and add categories.