13,212
edits
Help:Your first article: Difference between revisions
Jump to navigation
Jump to search
+ Categories, wikilinks and disposition
(A humble beginning based on the current text) |
(+ Categories, wikilinks and disposition) |
||
| Line 11: | Line 11: | ||
== Editing the wiki markup == | == Editing the wiki markup == | ||
{{main article|Help:editing}} | |||
Writing and editing with Mediawiki wiki markup (currently using MediaWiki v. {{CURRENTVERSION}}) can take some getting used depending on your background, because unlike most word processors you can see and type software code used for formatting and linking. | Writing and editing with Mediawiki wiki markup (currently using MediaWiki v. {{CURRENTVERSION}}) can take some getting used depending on your background, because unlike most word processors you can see and type software code used for formatting and linking. | ||
If you already know HTML or a programming language then what are you doing reading this! If you have just used [[Open Office]], then it is still easy to get started, as you can begin using the buttons above the edit box to format your text. | If you already know HTML or a programming language then what are you doing reading this! If you have just used [[Open Office]], then it is still easy to get started, as you can begin using the buttons above the edit box to format your text. | ||
== Linking your article to other articles == | |||
Linking your article to other articles will make your article more useful to the reader. There is mainly three way to do this, by adding one or more category, by adding wiki links and by adding navboxes. | |||
=== Categories === | |||
{{main article|Help:Categories}} | |||
The categories is connecting the articles, images, and templates in a partly tree-like partly web-like structure. By linking together similar content it will be easier to get a grasp on how your article is related to other articles. | |||
Have a look in the category structure and try find a suitable category or maybe one or two more. Adding a category that is as narrow as possible to your article will help find it for a reader browsing through the categories looking for something. | |||
Categories are added like this <code><nowiki>[[Category:Some category]]</nowiki></code> at the very bottom of the page. Sometimes it is desirable to add a category in a way that the article will be sorted differently than by it's name. This can be done like this <code><nowiki>[[Category:Some category|Sort key]]</nowiki></code>, where the sort key is what it should be sorted as instead of the article name. | |||
=== Wikilinks === | |||
{{main article|Help:Editing#Links to other wiki pages}} | |||
Wikilinks are links to other articles. You should preferably not link to other articles in the first section or in section headings and you should only link to other articles the first time a concept is used unless the article is very long. Filling the article with links will not make it easier to read it. | |||
Wikilinks can be used in a few different ways. | |||
<nowiki>Here is some example links: [[Aircraft speed]], [[altitude]]s and [[Modeling - Getting Started#Finding, Creating, or Using Textures|textures]].</nowiki> | |||
Here is some example links: [[Aircraft speed]], [[altitude]]s and [[Modeling - Getting Started#Finding, Creating, or Using Textures|textures]]. | |||
== Typical article disposition == | |||
<nowiki>{{Some messagebox}} | |||
{{Some infobox or navbox}} | |||
A '''generic article disposition''' would look something like this. | |||
== Heading == | |||
Some text... | |||
== | == Related content == | ||
* [[Some page]] | |||
== External links == | |||
* [Some link] Some description | |||
{{Some navbox}} | |||
[[en:Some language link]] | |||
[[Category:Some category]]</nowiki> | |||
;Messageboxes | |||
:One or more ''messageboxes'' could sometimes begin typical article page. The messageboxes would tell a reader or editor something about the article, like for example that it is outdated due to new developments. | |||
;Infobox or navbox | |||
:Often an ''infobox'' or ''navbox'' will follow. An ''infobox'' will contain more detailed information about a piece of software, an aircraft, an airport etc. that is the topic of the article and a ''navbox'' could help the reader find his way around a series of or similar articles. | |||
;First section | |||
:The ''first section'' of an article should be a ''short summary'' of the article or an ingress. Preferably the '''page title in bold''' should be within the first sentence or the first section. | |||
:This short summary of the article would help a reader to quickly figure out if he found the page he was looking for, as well as help a him grasp the main concepts of an article a bit faster. | |||
;Article text | |||
:The article text that follows is preferably broken up in not too long, but not too short ''sections''. Often it would help the reader if there are images and tables to help understand the article text. Sometimes it is a good thing to mark more some important words differently. | |||
;Links to related content | |||
:''Links'' to related content, like other articles forum topics etc. can be put in the end, though in general having the internal wikilinks within the article text is preferable. | |||
;Links to external resources | |||
:Links to external resources should be put at the very end of the article. | |||
;Navbox | |||
:Many pages end with a ''navbox'' with for example other aircraft by the same manufacturer. | |||
;Language links and categories | |||
:All articles should end with one or more ''categories''. They are preceded by ''language links'', if there is any translations of that page. | |||