|
|
| Line 23: |
Line 23: |
| | |} | | |} |
| | | | |
| − | = Article Structure<br/> =
| |
| | | | |
| − | Good articles usually start with a short [[Guidelines to Make Good Articles#Overview|„Overview“]], followed by the [[Guidelines to Make Good Articles#Main_Part|main part]] including [[Guidelines to Make Good Articles#Further_Information|"Further Information"]] (if you have), and end with [[Guidelines to Make Good Articles#References|"References"]]. The content in the main part should be clustered into [[Guidelines to Make Good Articles#Paragraphs|Paragraphs]].
| + | = Article Structure<br/> = |
| | | | |
| | + | *Good articles usually start with a short [[Guidelines to Make Good Articles#Overview|„Overview“]], |
| | + | *followed by the '''[[Guidelines to Make Good Articles#Main Part|main part]]''' (content should be clustered into [http://help.energypedia.info/Guidelines to Make Good Articles#Paragraphs Paragraphs]) |
| | + | *including [[Guidelines to Make Good Articles#Further Information|"Further Information"]], |
| | + | *and end with [[Guidelines to Make Good Articles#References|"References"]]. |
| | | | |
| | + | <br/> |
| | | | |
| | == Overview<br/> == | | == Overview<br/> == |
| Line 33: |
Line 37: |
| | The “Overview” is a short text introducing the reader to the general topic of your article. This will help the reader to evaluate the article's relevance for him / her. Furthermore, by clearly explaining the subject, the reader will be better prepared for the following details. Background information can be given here as well as relevant definitions of important aspects. | | The “Overview” is a short text introducing the reader to the general topic of your article. This will help the reader to evaluate the article's relevance for him / her. Furthermore, by clearly explaining the subject, the reader will be better prepared for the following details. Background information can be given here as well as relevant definitions of important aspects. |
| | | | |
| − | | + | <br/> |
| | | | |
| | == Main Part<br/> == | | == Main Part<br/> == |
| Line 39: |
Line 43: |
| | The main part includes the specific paragraphs and subparagraphs and if you have also further information. | | The main part includes the specific paragraphs and subparagraphs and if you have also further information. |
| | | | |
| − | | + | <br/> |
| | | | |
| | === Paragraphs<br/> === | | === Paragraphs<br/> === |
| | | | |
| − | Paragraphs are used to structure texts and to make it easier for readers to follow the article's argumentation line. A paragraph compromises several sentences which focus on one idea, argument or aspects. | + | Paragraphs are used to structure texts and to make it easier for readers to follow the article's argumentation line. |
| | | | |
| | + | A paragraph compromises several sentences which focus on one idea, argument or aspects. |
| | *Overly long paragraphs can usually be divided into several, shorter subparagraphs, each dealing with different aspects. | | *Overly long paragraphs can usually be divided into several, shorter subparagraphs, each dealing with different aspects. |
| | | | |
| − | | + | <br/> |
| | | | |
| | === Headings<br/> === | | === Headings<br/> === |
| | | | |
| − | The headings automatically appear in the table of contents on top of each article (once there are at least 3 headings). | + | The headings automatically appear in the table of contents on top of each article (once there are at least 3 headings). |
| − | | + | |
| | *When it comes to choosing a headline always try to find a description that focuses on the key aspects of the following paragraph and make it short and significant. If you are using a expression with a common abbreviation you can always add it there. | | *When it comes to choosing a headline always try to find a description that focuses on the key aspects of the following paragraph and make it short and significant. If you are using a expression with a common abbreviation you can always add it there. |
| − | *When formatting always start with “Heading 1” and go hierarchically down for the subheadings. Subjects with the same hierarchy should have the same hierarchically heading format. | + | *When formatting always start with “Heading 1” and go hierarchically down for the subheadings. Subjects with the same hierarchy should have the same hierarchically heading format. |
| | *Before each heading please include a space line and use capital letters in the heading<span style="color:#ff0000"></span>. | | *Before each heading please include a space line and use capital letters in the heading<span style="color:#ff0000"></span>. |
| − |
| |
| | *Headings should not be a link at the same time - it is preferred if links are given in the section below the heading. | | *Headings should not be a link at the same time - it is preferred if links are given in the section below the heading. |
| | | | |
| | + | <br/> |
| | | | |
| − | | + | {| cellspacing="1" cellpadding="1" border="1" style="width: 100%" |
| − | {| style="width: 100%" cellpadding="1" cellspacing="1" border="1" | + | |
| | |- | | |- |
| − | | style="background-color: rgb(255, 255, 102)" | | + | | style="background-color: rgb(255, 255, 204)" | |
| | '''Example:''' | | '''Example:''' |
| | | | |
| Line 74: |
Line 77: |
| | <span class="tocnumber">4</span> <span class="toctext">Energy Resources</span> | | <span class="tocnumber">4</span> <span class="toctext">Energy Resources</span> |
| | | | |
| − | <span class="tocnumber"> 4.1</span> <span class="toctext">Biomass</span> | + | <span class="tocnumber">4.1</span> <span class="toctext">Biomass</span> |
| | | | |
| − | <span class="tocnumber"> 4.1.1</span> <span class="toctext">Biomass Potential and Distribution</span> | + | <span class="tocnumber">4.1.1</span> <span class="toctext">Biomass Potential and Distribution</span> |
| | | | |
| − | <span class="tocnumber"> 4.1.2</span> <span class="toctext">Biomass Stoves: Best Practice Case Study<span id="cke_bm_197E" style="display: none" data-cke-bookmark="1"> </span></span> | + | <span class="tocnumber">4.1.2</span> <span class="toctext">Biomass Stoves: Best Practice Case Study<span data-cke-bookmark="1" style="display: none" id="cke_bm_197E"></span></span> |
| | | | |
| | |} | | |} |
| | | | |
| − | | + | <br/> |
| | | | |
| | -> For help how to add a heading find more information [http://help.energypedia.info/index.php/Add_headlines here]. | | -> For help how to add a heading find more information [http://help.energypedia.info/index.php/Add_headlines here]. |
| | | | |
| − | | + | <br/> |
| | | | |
| | === Length<br/> === | | === Length<br/> === |
| Line 92: |
Line 95: |
| | <span style="color:#ff0000"></span>When articles grow fast they can easily become confusing. This may dount some reader, who are trying to find the wanted information. This is why sometimes it makes sense to create a main page for this headline and link the sub articles to it. The main page would give the general information about the topic and all the other articles can go much more into detail being self contained articles itself as each article on a subtopic should be written as a stand-alone article. <span style="color:#ff0000"></span> | | <span style="color:#ff0000"></span>When articles grow fast they can easily become confusing. This may dount some reader, who are trying to find the wanted information. This is why sometimes it makes sense to create a main page for this headline and link the sub articles to it. The main page would give the general information about the topic and all the other articles can go much more into detail being self contained articles itself as each article on a subtopic should be written as a stand-alone article. <span style="color:#ff0000"></span> |
| | | | |
| − | | + | <br/> |
| | | | |
| | == Further Information<br/> == | | == Further Information<br/> == |
| Line 98: |
Line 101: |
| | If you have any further information to the specific topic this paragraph is the place to list it. However energypedia should not become a link list. Whenever this information can be included into your article this is the better solution. | | If you have any further information to the specific topic this paragraph is the place to list it. However energypedia should not become a link list. Whenever this information can be included into your article this is the better solution. |
| | | | |
| − | | + | <br/> |
| | | | |
| | == References<br/> == | | == References<br/> == |
| Line 108: |
Line 111: |
| | In order to ensure a consistent quotation style we encourage you to use the [http://guides.is.uwa.edu.au/harvard Harvard Citation Style for reference lists]: | | In order to ensure a consistent quotation style we encourage you to use the [http://guides.is.uwa.edu.au/harvard Harvard Citation Style for reference lists]: |
| | | | |
| − | {| style="width: 100%" cellpadding="1" cellspacing="1" border="1" | + | {| cellspacing="1" cellpadding="1" border="1" style="width: 100%" |
| | |- | | |- |
| − | | style="background-color: rgb(255, 255, 102)" | | + | | style="background-color: rgb(255, 255, 204)" | |
| | '''Example''' | | '''Example''' |
| | | | |
| Line 117: |
Line 120: |
| | |} | | |} |
| | | | |
| − | | + | <br/> |
| | | | |
| | -> For help how to [http://help.energypedia.info/index.php/Insert_Footnotes_and_References insert], [http://help.energypedia.info/index.php/Edit_Footnotes edit], [http://help.energypedia.info/index.php/Link_Footnotes_and_References link] references please find more information in the help section "[http://help.energypedia.info/index.php/Category:Articles All about Articles]". | | -> For help how to [http://help.energypedia.info/index.php/Insert_Footnotes_and_References insert], [http://help.energypedia.info/index.php/Edit_Footnotes edit], [http://help.energypedia.info/index.php/Link_Footnotes_and_References link] references please find more information in the help section "[http://help.energypedia.info/index.php/Category:Articles All about Articles]". |
| | + | |
| | + | |
| | + | |
| | + | = Qustions? = |
| | + | |
| | + | [mailto:info@energypedia.info?Subject=energypedia feedback Simply send us an email]. |
| | | | |
| | | | |
The “Overview” is a short text introducing the reader to the general topic of your article. This will help the reader to evaluate the article's relevance for him / her. Furthermore, by clearly explaining the subject, the reader will be better prepared for the following details. Background information can be given here as well as relevant definitions of important aspects.
The main part includes the specific paragraphs and subparagraphs and if you have also further information.
Paragraphs are used to structure texts and to make it easier for readers to follow the article's argumentation line.
A paragraph compromises several sentences which focus on one idea, argument or aspects.
The headings automatically appear in the table of contents on top of each article (once there are at least 3 headings).
If you have any further information to the specific topic this paragraph is the place to list it. However energypedia should not become a link list. Whenever this information can be included into your article this is the better solution.
In order to ensure the quality, confirmability and trust in energypedia's articles we highly encourage all authors to make extensive use of references and footnotes if the quote from other sources directly or indirectly.
Furthermore you might use these footnotes to make minor comments that did not fit in the flow of the main text but are still worthwhile sharing.
Links are especially important for other users to get further information on the topic and it's a possibility to keep each article as short and precise as possible as you can "link" to the deeper level of your information instead of cramming it into one huge paragraph and repeating information that has been documented already somewhere else extensively.
Links also help to structure the wiki so that individual articles do not get lost. On energypedia we usualy distinguish between two different types of links:
