How To Create An Article

This is the space for reference articles on all areas of water science, technology, management and development issues. Here you can share knowledge by creating your own article covering an issue in your area of expertise. All contributions major or minor are welcome across all areas of interest in water, wastewater and environmental related fields.

All Submissions must be in English.

Content Table

• How To Create An Article
  • Creating an Article
    • Getting Started
    • Article Title
    • Contents Table
    • Main Body of Article
    • Copy + Pasting text from Microsoft Word
    • Related Articles
    • References
    • External Links
  • Attaching Documents - PDFs, Presentations, etc
  • Formatting your Article
    • Headings
  • Creating Links
    • Linking to Another WaterWiki page
    • linking to an External Web Page
    • Linking an  Email Address to Your Article
  • Insert an Image or Table
    • Images
    • Tables
  • Macros: How to
    • Insert a Box around Provided Content
    • Insert a Footnote to Display at the End of the Page
    • Display a Mathematical Formula
    • Create a Table of Contents
  • Saving Your Article
    • Save and View Article
    • Tag Article
    • Add an Attribute to your article

Creating an Article

Getting Started

• Click on articles under the Browse menu on the home page
• Go to the Create Article box.
• Type in the chosen title of your article
• Click Create
• You will then be presented with an article template

Article Title

• Check that the correct article heading has pulled through to the blank document and is displayed in the title box at the top of the page.
• Under the main heading but before the contents table you might choose to write a brief summary paragraph outlining or defining the chosen topic of your article

Contents Table

• You do not need to input anything into the contents table
• The contents table will automatically update once the article is complete

Main Body of Article

• The body of the article is divided into a series of Sections and Sub-Sections
• Main subject areas should be presented under Sections, whilst other related areas should presented under Sub-sections

Copy + Pasting text from Microsoft Word

When completing your article, you might need to copy and paste large amounts of text from elsewhere. If you have written your article in Microsoft Word, for example, you can copy and paste the text straight into your article.

Microsoft Office documents often contain hidden coding which can cause your article to be displayed oddly if you just paste it straigh into the text editng window, so you will need to use the Office Import tool in the article text editor.

To import text:

• Place the cursor on the position on the page that you would like to copy your text to
• Click on the Import Office Content icon

• Copy and Paste the text from your office document into the box
• Tick Filter Styles - this will import formatting from your document, but not any unwanted coding.
• Click Import

Related Articles

• List any articles of interest related to your topic below this section
• Create links to the articles listed
• N.B See section on Creating Links

References

• Reference any material used to write the article below this section
•  When possible, create links to the references listed.
•  N.B See section on Creating Links

External Links

• List any related links to other websites below this section
• N.B See section on Creating Links

Attaching Documents - PDFs, Presentations, etc

You can attach a number of different items to your articles e.g. Documents, PDFs, PowerPoint presentations, Posters etc.

To attach an item to your article:

• Highlight the text you would like to attach the file to.
• Click 'Link' and select 'attached file'
• Click 'browse' and select the file from your computer
• Click 'attach'

Formatting your Article

Articles on WaterWiki should all follow the same format. This has already been set-up on WaterWiki so that all fonts, sizes, headings remain consistent.

Headings

You will notice on the tool bar that the headings and text are divided into several formatting categories (under Apply Style icon)

• Main Section headings are called Title 2
• Sub - Section headings are called Title 3
• For any additional divisions needed within a Section use Title 4, 5, and so on.
• All other text is called Plain Text

Creating Links

It is important when writing your article to create links to other relevant material. This allows users to visit other web pages, online journals and related WaterWiki articles, linking the content article to other useful information on the web.

Linking to Another WaterWiki page

• Highlight the text on the page that you would like to link to
• Click on the Link icon on the toolbar
•  Click Wiki page
•  Select relevant page/article you would like to link to
•   Click Create Link

linking to an External Web Page

•  Highlight the text on the page that you would like to link to
•  Click on the Link icon on the toolbar
•  Click Web Page
•  Type in the  web page you would like to link to
•  Click Create Link

Linking an  Email Address to Your Article

• Highlight the text on the page that you would like to link to
  
• Click on the Link icon on the toolbar
•  click Email Address
•  Type in the  Address you would like to link to
•  Click Create Link

Insert an Image or Table

Images

• Click on the Image icon on the toolbar and select 'attached image'
•  Insert Image by uploading it from your computer
•  Alter the size and alignment of your image by configuring the 'image settings'

Tables

• Click on the Table icon on the toolbar
• Choose no. of columns and rows for your table
• Choose page/pages for selected table

Macros: How to

There are a number of functions listed under the Macros icon on the toolbar. Some of these include: Box, Footnote, Formula and Toc.

Insert a Box around Provided Content

• Click Macro
•  Insert Macro
•  Select Box

Insert a Footnote to Display at the End of the Page

• Click Macro
•  Insert Macro
•  Select Footnote

Display a Mathematical Formula

• Click Macro
•  Insert Macro
•  Select Formula

Create a Table of Contents

• Click Macro
•  Insert Macro
•  Select ToC

Saving Your Article

Save and View Article

• Click Save and View to view your finished article
• To make any changes click Edit
• You may wish to click 'save and continue' to save your work as you go along. You should always do this before switching between HTML and WYSIWYG editors.

Tag Article

• Once you have clicked Save and View, you will see a copy of your article in full
• A message will appear next to it, on the right hand side of the page, signalling that it is 'untagged'.
• It is necessary to tag your article so that your article can be easily found on WaterWiki .
• To Tag your article go to the bottom of the article page and type in a tag from our list of existing list.
• There  is an auto-complete function so that as you type in the tag, WaterWiki will finish it for you.

Add an Attribute to your article

• It is sometimes useful to give your article an attribute such as ‘recently revised’ or ‘excessive length. This will flag your article to other users who may be able to help you revise or improve it.
• The list of attributes is located next to the Tag box at the bottom of the article
• Choose a suitable attribute from the drop-down list and click Change