How To Create Pages

From Medieval Engineers Wiki
Revision as of 14:25, 15 October 2018 by CptTwinkie (talk | contribs) (Created page with "{{Draft}} Creating a wiki page can be rather simple or highly complex depending on what the page will contain and how it will connect to other pages. There is nothing difficul...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Pen.pngThis article is a draft. You can help Medieval Engineers Wiki by completing it. Click to edit this page


Creating a wiki page can be rather simple or highly complex depending on what the page will contain and how it will connect to other pages. There is nothing difficult about making a wiki page but sometimes finding out how to do it the way you want while keeping it consistent with the rest of the wiki can be a challenge. The goal of this page is to present a basic introduction to each aspect of creating a page. It should become obvious that this information is far from complete but it will serve to show the process and where to find the information you need.

How To Create A Page

New page box

The first step in creating a page is knowing when a page is needed. When new content is added to the game then pages may be needed. If you want to write a guide or how-to then a new page may be needed. If you want to document existing game content then it is unlikely that a page doesn't already exist. Perhaps the content is mentioned only briefly on a page. Expanding this content may or may not be within the context of the existing page. Try to consider related pages and how your information fits into the existing organization. Maybe you need a new page or maybe you don't.

Try searching for terms related to the content you wish to document. You may find an existing page. When you search for a topic that doesn't exactly match a page title you will get a search results page. At the top of this page, the wiki will provide a link to create a new page. Be careful using this link because it will create the page with the exact spelling and capitalization that you used for your search, the only exception being the first letter is always capital. It is easier to create a page by using the new page box on the Main Page. The Medieval Engineers wiki uses Title Case for page names.


How To Format A Page

Once you have decided to create a page the hurdle is how to format your information. Although information presented as plain text using plain speech is the best way to convey information, the main use of wikis is for quickly looking up information. Long paragraphs and "walls of text" are often skipped entirely by readers looking for quick information. It is better to break up your page, or article if you prefer that term, into sections and sub-sections that fit your content.


Top Of The Page

The top of each page is precious space and it is often shared by a number of page elements including the lead section, the table of contents, images, and information boxes. It is also shared with a number of templates including version numbers, page history, search engine optimization (SEO), notifications, and notes. Not all of these items are displayed to readers and your page may require few or none of the latter at all. Because the top of the page is so important you will want to consider your lead section carefully and keep it as concise and to the point as possible.


Lead Section

Although it is part of the top of the page, the lead section is the most important text in a wiki article as it provides an introduction or summary for the whole page. The Medieval Engineers wiki tends to not have much for lead sections in general but this is mainly due to a large amount of content and the far too little time of the developers. Well written lead sections are encouraged and desired for all pages.

The lead section should introduce the page by describing topic(s) being covered. It should also summarize the page or the page's purpose as appropriate. This can be challenging at times because lead sections should be very concise and not run on into multiple paragraphs. You can read a lot more about lead sections in wikipedia's lead section page. If you are feeling intimidated just start by saying what the page is about and briefly mentioning anything special that is covered in the page's content. You can always come back to this section later.


Table Of Contents

If your page grows to the point that it has more than three headings it will automatically create a table of contents that lists the headings. The table of contents is displayed before the first heading, placing it right after the lead section. This is noteworthy for a few reasons. The first is that readers may decide to skip to the section that interests them the most at this point. This is part of what makes the lead section so important as it's nearly the only text that every reader will encounter. It also means that you shouldn't include any summary information after your first heading.

Another significant factor of the placement of the table of contents is the prominence it will have in pages with many headings. If you have 100 headings your table of contents will be 100 lines long. There are ways around this including using HTML headings instead of wiki headings which are ignored by the table of contents, or hiding the wiki table of contents and instead creating your own using links. These are not recommended except in extreme cases.

Since the table of contents bridges the gap between the top of the page and the content it has some effect on placement. For example, version and history templates are preferably displayed next to the table of contents when one is present. Otherwise, they are displayed at the top of the page.


Sections

Sections are a simple and easy organizational tool to organize your page. Each section of your article should start with a heading. You can use the Heading drop down box in the editor to create headings or type them yourself. Headings work as a hierarchy and should always start at level two and increase from there for sub-sections, not skipping levels. Level one is the page title so should not be used for sections.

Level two headings are large and place a horizontal line across the page. These separate the page into logical divisions of the page topic. Sub-heading levels show only as slightly larger, bold text. The Medieval Engineers wiki uses doesn't have a standard capitalization case for sections headings. The general choice practice is to use Title Case until it becomes distracting in the table of contents. Long headings should be avoided as heading are not meant to be full sentences but rather a title for the section.


Templates

Much of the information displayed on pages in the Medieval Engineers wiki is the same as on other pages so it makes sense to use templates for easier formatting. As the wiki has grown the templates have become more numerous and elaborate until most of the content on many pages is almost entirely contained within templates. This is for two main reasons. Firstly, using templates in this fashion means that all pages with similar information can be updated simultaneously by changing the template. The second reason also has to do with making the pages easier to maintain. The developers at keen software house have developed an exporter using the game code that can export game data to pre-formatted text that can be pasted into the wiki. By eliminating much of the text in the templated regions of pages it makes it a great deal faster to export information when the game is updated. This is why adding non-template text in template regions of your page should be avoided. Content templates should be placed together at the end of the page.

See more about using templates below.


Categories

Categories can be added anywhere on the page. Because this makes it difficult to locate category links it is standard practice to place them at the very bottom of the page.

See more about using categories below.


How To Construct A Page

===Draft=== ===Write Lead Section=== ===Create Outline=== ===Add Content=== ===Stub=== ===Add Details And Refine=== ===Revise Lead Section=== Also Remove Stub

How To Use Links

https://www.mediawiki.org/wiki/Help:Links

How To Use Templates

Many of the templates add categories automatically however it is often necessary to add categories that are not provided by templates. An example of this is foods, which have to be added to the cooking category. The reason is that there is no template that is specific to foods and only foods. Other pages on the wiki, such as pages in Category:How To Play do not use content templates and are all categorized manually. Category:Templates Template Ordering Category:Templates/Formatting

How To Source Information

===From The Game=== ===From The Game Data=== Finding Source Information

How To Add Images

===Sourcing Images=== Category:Missing Images ===Uploading Images=== Quick Upload Upload File Page Description ===Using Images=== Using With Templates Placing Raw Images Https://Www.Mediawiki.Org/Wiki/Help:Images

How To Find More Information

https://www.mediawiki.org/wiki/Help:Contents Https://Www.Mediawiki.Org/Wiki/Help:Templates