Jump to navigation Jump to search
m (fix FN)
m (rm abxy link)
Line 1: Line 1:
{{enforced}}
{{enforced}}
{{Header Nav|game=StrategyWiki:Guide}}
{{Header Nav|game=StrategyWiki:Guide}}


Line 6: Line 5:
A well–laid-out article will flow properly, with no awkward whitespace (blank areas), and equally no "piling up" of items such as images and boxes. In some cases – especially when the article contains a lot of content – this is hard to achieve, but by sticking to a few simple rules, it should all work fine. However, before an article can be written, you have to [[StrategyWiki:Guide/Table of contents|make sure to put it in the right place]].
A well–laid-out article will flow properly, with no awkward whitespace (blank areas), and equally no "piling up" of items such as images and boxes. In some cases – especially when the article contains a lot of content – this is hard to achieve, but by sticking to a few simple rules, it should all work fine. However, before an article can be written, you have to [[StrategyWiki:Guide/Table of contents|make sure to put it in the right place]].


If you have any questions or suggestions regarding layout, bring them up on [http://forums.abxy.org/viewforum.php?f=19 the forums].
If you have any questions or suggestions regarding layout, bring them up on [[StrategyWiki:Discord|Discord]].


== Text ==
== Text ==
The text will form the main part of the article, and so it is important that it is laid-out properly. In this respect, good authorship comes into play, with well-written guides being more interesting and engaging to read, and thus being more useful. If you aren't too competent with words, however, don't worry. Just try your best, lay out the article properly, and put <nowiki>{{cleanup}}</nowiki> at the top of the article to signify that it needs cleaning up.
The text will form the main part of the article, and so it is important that it is laid-out properly. In this respect, good authorship comes into play, with well-written guides being more interesting and engaging to read, and thus being more useful. If you aren't too competent with words, however, don't worry. Just try your best, lay out the article properly, and put <nowiki>{{cleanup}}</nowiki> at the top of the article to signify that it needs cleaning up.
One of the key points of laying out text well is the effective use of paragraphs. Separate each idea out, and put them in different paragraphs by splitting them with a double-line-break (i.e. press enter twice after the first paragraph, then write the second). Note that a single line-break won't work: it ''has'' to be a double one. Note also that the splitting of paragraphs doesn't just work for text: other items separated by a double-line-break will also become separate paragraphs, which is sometimes less than desirable, and something to look out for.
One of the key points of laying out text well is the effective use of paragraphs. Separate each idea out, and put them in different paragraphs by splitting them with a double-line-break (i.e. press enter twice after the first paragraph, then write the second). Note that a single line-break won't work: it ''has'' to be a double one. Note also that the splitting of paragraphs doesn't just work for text: other items separated by a double-line-break will also become separate paragraphs, which is sometimes less than desirable, and something to look out for.
Line 19: Line 17:


=== Headings ===
=== Headings ===
Another important part of writing good article text is splitting it up into useful headings. These allow the user to quickly navigate to places in the document using the table of contents automatically generated by MediaWiki, and also provide separation between sections.
Another important part of writing good article text is splitting it up into useful headings. These allow the user to quickly navigate to places in the document using the table of contents automatically generated by MediaWiki, and also provide separation between sections.


Line 31: Line 28:


== Images ==
== Images ==
When including images in a guide, you must always make sure they are presented properly. After [[StrategyWiki:Images|uploading them properly]], they should be included in the page with (usually) the following wikimarkup: <nowiki>[[File:image_name.png|thumb|left|Image caption goes here.]]</nowiki> (note that Image: works, but since it takes 1 extra character we prefer File:). Note that the caption is a complete sentence, including a period at the end. The caption should convey the meaning of the image, or describe what's happening in a succinct manner.
When including images in a guide, you must always make sure they are presented properly. After [[StrategyWiki:Images|uploading them properly]], they should be included in the page with (usually) the following wikimarkup: <nowiki>[[File:image_name.png|thumb|left|Image caption goes here.]]</nowiki> (note that Image: works, but since it takes 1 extra character we prefer File:). Note that the caption is a complete sentence, including a period at the end. The caption should convey the meaning of the image, or describe what's happening in a succinct manner.


Line 44: Line 40:
If many images are required for one section of a guide, a <nowiki><gallery></nowiki> tag is more appropriate than many floating thumbnails. This should be (most likely) placed at the bottom of the section, but any other placement between paragraphs is acceptable. It uses the following syntax:
If many images are required for one section of a guide, a <nowiki><gallery></nowiki> tag is more appropriate than many floating thumbnails. This should be (most likely) placed at the bottom of the section, but any other placement between paragraphs is acceptable. It uses the following syntax:
<pre><gallery>
<pre><gallery>
File:image_name.png|Image caption goes here.
File:image name.png|Image caption goes here.
File:image_name2.png|Second image caption goes here.
File:image name2.png|Second image caption goes here.
File:image_name3.png|Third image caption goes here.
File:image name3.png|Third image caption goes here.
</gallery></pre>
</gallery></pre>


{{Footer Nav|game=StrategyWiki:Guide|prevpage=File uploads|nextpage=License}}
{{Footer Nav|game=StrategyWiki:Guide|prevpage=File uploads|nextpage=License}}