Difference between pages "Help:Authoring" and "Help:AutoTables"

From 3kWiki
(Difference between pages)
Jump to navigation Jump to search
imported>Shadowspawn
 
imported>Spellbound
 
Line 1: Line 1:
=3KWiki Specific help=
+
=How to Add pages to an automatically generated table=
  
A quick walkthrough of using the templates on our pages [[Help:AutoTables|can be found here]].  
+
So you've looked at a page like [[Smithing]], and found a moulding that needs to be added.
 +
You tried to edit the page and just saw:
  
General Wiki editing is covered below.  Enjoy yourself, and thanks for helping someone else's time on 3K more enjoyable.
+
<tt><pre><nowiki>
  
=Converters=
+
<dpl>
 +
  uses = Template:Mould
 +
  notcategory= Minor Gems
 +
  notcategory= Standard Gems
 +
  notcategory= Major Gems
 +
  include = {Mould}:Min, {Mould}.ptbl, {Mould}:Triv:Bars:Jewels:Frags
 +
  table = class=sortable border = 5 id=0,-,Minimum,Name,Trivial,Bars,Jewels,Fragments
 +
  tablesortcol=1
 +
</dpl>
 +
</nowiki></pre></tt>
  
[[Converting documents to mediawiki markup|Converting documents from Word,Excel,HTML,etc to wiki format]]
+
==Making a New Page==
  
=Categories=
+
It's actually really easy.  
Please use appropriate category tags to tag your pages.
 
Simply include something like the following to your page.
 
<nowiki>[[Category:XYZCategory]]</nowiki>
 
  
=Ultra Short Wiki Tutorial=
+
The easiest way it to just type in an unused address into your webbrowser. ''http://3kwiki.info/wiki/index.php/Whatever You Want''
For the more technically inclined, you may find the [[Help:Ultra Short Wiki Tutorial|ultra short wiki tutorial]] a good overview.
 
  
=Headings=
+
Or type the article name on the box on the main page of the wiki.
''same as headlines/chapters/sections''
 
  
First, second and third level headings
+
==Using a Template==
=New section=
 
 
==Subsection==
 
 
===Sub-subsection===
 
  
A first level heading is for example the "Word formatting" heading on this page.
+
Templates do most of the work for you. You'll see on each moulding page a little table at the top with stats. That table, and all those stats, are done by using a template. The Autotable generator looks for all pages that use that template, and there ya go...  
The "Bullet lists" heading on this page is an example of a 2rd level heading.
 
  
The "Table of contents" box you see at the top of this page will appear automatically when you have used 4 or more headings.
+
For an example, let's use the 1-handed Silver Sword page...  
First level headings are shown as x, 2rd level as x.x and so on.
+
<tt><pre><nowiki>
 +
{{Mould
 +
|Type= 1-Handed Silver Sword
 +
|Min= 35
 +
|Triv= 39
 +
|Frags=
 +
1 [[Fragment of Knowledge]]
  
 +
1 [[:category:Minor Gems|minor gem]]
 +
|Bars=
 +
3 silver bar
  
=Internal linking=
+
|Jewels=
<nowiki>[[Main Page]]</nowiki>
+
1 beryl dust
Becomes a link to the [[Main Page]] of this Wiki.
 
  
 +
1 steel shards
  
<nowiki>[[Information|Infos!]]</nowiki>
+
}}
Becomes a link to the Information page but Infos! is written instead like this: [[Information|Infos!]]
+
[[category:Weapons]]
 +
</nowiki></pre></tt>
  
 +
A template in Wikicode is <code><nowiki>{{TemplateName }}</nowiki></code>; A template name inside a pair of braces (curly brackets).  Parameters in the template are preceded with a '''|'''. 
 +
* <nowiki>{{Mould |Type= Sword Name}} </nowiki>
  
=Word formatting=
+
Linking to other pages are done by simply putting the page name in '''<nowiki> [[ ]]</nowiki>''' square brackets.
; Emphasize
+
This is how we build the lists of "what uses this fragment" on their pages; by making a list of what links to that page, so please link the fragments.
  <nowiki>''Emphasize'', '''strongly''', '''''very strongly'''''</nowiki>
+
* <nowiki>1 [[Fragment of Knowledge]]</nowiki>
''Emphasize'', '''strongly''', '''''very strongly'''''
 
  
 +
Information on a wiki is only as good as how easy it is to find, so please add a category tag to the article. <code><nowiki>[[category: ]]</nowiki></code>. The Mould template in our example already includes a category:Moulds tag in it, so half the work's done for you. The C in category isn't case sensitive, but the Category name, after the :, is Case sensitive.
 +
* <nowiki>[[Category:Weapons]]</nowiki>
  
; HTML tags you can use
+
Links '''[[ ]]''' also change the displayed text for a page, [[Smithing]], [[Smithing | blacksmithing]], [[Smithing|making stuff]] all go to the same page. The | inside of a '''[[ ]]''' tag separates the Destination from the display.
 +
If you actually want to link to a category page, put a : before category in the tag.
 +
* <nowiki>1 [[:category:Minor Gems | minor gem]]</nowiki>
  
Typewriter font for technical terms
+
The 2 lines between beryl dust and steel shards is to ensure that they're on separate lines in our table. Without a blank line, the 2nd and 3rd jewel ends up on the same line. I preferred to put a blank line bewteen the 1st and 2nd so it's consistent.
<nowiki><tt>monospace text</tt></nowiki>
 
<tt>monospace text</tt>
 
  
 
+
Knowing what parameters a template expects is easily figured out. Check out an existing page that uses the template, and edit it. At the bottom of the page you'll see each template listed, you can click the link to see the templates page, where you can look at the source if need be, or most likely, any template you are likely to ues will have usage information on that page.
Small text
 
<nowiki><small>small text</small></nowiki>
 
<small>small text</small>
 
 
 
 
 
Strikethru text
 
<nowiki><s>strike out deleted material</s></nowiki>
 
<s>strike out deleted material</s>
 
 
 
=External linking=
 
Remember to start with "<nowiki>http://</nowiki>".
 
 
 
 
 
; Bare URL
 
<nowiki>http://www.3k.org/</nowiki>
 
Becomes http://www.3k.org/
 
 
 
 
 
; Named link
 
<nowiki>[http://www.3k.org/ 3k Mud]</nowiki>
 
Becomes [http://www.3k.org/ 3k Mud]
 
 
 
=Lists=
 
 
 
==Bullet lists==
 
You can make bullet lists with "*".
 
<nowiki>* First level list object</nowiki>
 
<nowiki>** Second level list object</nowiki>
 
<nowiki>*** Third level list object</nowiki>
 
<nowiki>* Another first level list object</nowiki>
 
 
 
* First level list object
 
** Second level list object
 
*** Third level list object
 
* Another first level list object
 
 
 
 
 
==Numbered lists==
 
You can make numbered lists with "#".
 
<nowiki># First level list object</nowiki>
 
<nowiki>## Second level list object</nowiki>
 
<nowiki>### Third level list object</nowiki>
 
<nowiki># Another first level list object</nowiki>
 
 
 
# First level list object
 
## Second level list object
 
### Third level list object
 
# Another first level list object
 
 
 
 
 
==Mixed lists==
 
You can even make mixed lists like this.
 
* You can even do mixed lists
 
*# and nest them
 
*#* like this
 
 
 
* You can even do mixed lists
 
*# and nest them
 
*#* like this
 
 
 
 
 
==Definition lists==
 
;item
 
: the item's definition
 
;item
 
: the item's definition
 
 
 
 
 
=Images=
 
You can insert images using the syntax:
 
<nowiki>[[Image:filename|options|caption text]]</nowiki>
 
The last item added will always be considered the caption text.
 
 
 
 
 
==Image without alt-text==
 
<nowiki>[[Image:mediawiki.png]]</nowiki>
 
[[Image:mediawiki.png]]
 
 
 
 
 
==Image with alt-text==
 
You add "|caption text" after the image link. This is the text most browsers will show when you hover over the image with the mouse.
 
<nowiki>[[Image:mediawiki.png|The MediaWiki logo]]</nowiki>
 
[[Image:mediawiki.png|The MediaWiki logo]]
 
 
 
==Image options==
 
 
 
[[Image:mediawiki.png|thumb|The MediaWiki logo]]
 
; thumbnail, thumb
 
: Generates an automatically resized thumbnail image (either reduced or enlarged).
 
: Caption text is displayed directly underneath. An "enlarge"-icon is added.
 
: If you do not specify where the image should be place it will be places to the right.
 
: Example to the right (in this example the image is enlarged because it is small):
 
<nowiki>[[Image:mediawiki.png|thumb|The MediaWiki logo]]</nowiki>
 
 
 
 
 
; right
 
: Makes the image right-aligned.
 
 
 
 
 
; left
 
: Same as above, but left aligned.
 
 
 
 
 
; center
 
: Same as above, but centered.
 
 
 
 
 
; none
 
: The image will be rendered inline, even if the thumbnail-option is set.
 
 
 
 
 
[[Image:mediawiki.png|frame|The MediaWiki logo]]
 
; frame
 
: The image will have a frame, regardless of whether it is a thumb, and the caption text will be included as a visible caption.
 
: Example to the right:
 
 
 
 
 
; ''size''px
 
: Renders a version of the image that's ''[size]'' pixels wide (e.g. '150px').
 
: Height is computed to keep the aspect ratio (i.e. the shape of the image).
 
: This allows both size reduction and enlargement.
 
 
 
 
 
; Combining options
 
: You can combine the options as you like. Example (as you see below resizing is often not very good):
 
<nowiki>[[Image:mediawiki.png|50px|left|none|The MediaWiki logo]]</nowiki>
 
[[Image:mediawiki.png|50px|left|none|The HA logo]]
 
 
 
 
 
<nowiki>[[Image:mediawiki.png|none|frame|The MediaWiki logo]]</nowiki>
 
[[Image:mediawiki.png|none|frame|The MediaWiki logo]]
 
 
 
=Tables=
 
<nowiki>{| border="1" cellpadding="5" cellspacing="3"</nowiki>
 
<nowiki>| 1 || 2</nowiki>
 
<nowiki>|-</nowiki>
 
<nowiki>| 3 || 4</nowiki>
 
<nowiki>|-</nowiki>
 
<nowiki>| 5 || 6</nowiki>
 
<nowiki>|}</nowiki>
 
{| border="1" cellpadding="5" cellspacing="3"
 
| 1 || 2
 
|-
 
| 3 || 4
 
|-
 
| 5 || 6
 
|}
 
 
 
See also [http://meta.wikimedia.org/wiki/Help:Table WikiMedia table guide]
 
 
 
Our sortable tables have some custom javascript to specify which column is initially sorted. Set "id=" in the table open row to the number of the column you want sorted; the first column is 0.
 
 
 
<code><nowiki>{|</nowiki> border="1" cellpadding="5" cellspacing="3" '''class="sortable" id="1"'''</code>
 
<code><nowiki>!First!!Second!!Third
 
|-
 
| 1 || 2 || 7
 
|-
 
| 3 || 4 || 8
 
|-
 
| 5 || 6 || 9
 
|}</nowiki></code>
 
{| border="1" cellpadding="5" cellspacing="3" class="sortable" id="1"
 
!First!!Second!!Third
 
|-
 
| 1 || 2 || 7
 
|-
 
| 3 || 4 || 8
 
|-
 
| 5 || 6 || 9
 
|}
 
 
 
 
 
[[Help:AutoTables | Here is a walkthrough of adding to our automatically generated tables]]
 
 
 
=Additional hints=
 
You can avoid that the wiki system proccessing the text (to avoid unwanted formatting) by putting <nowiki><nowiki></nowiki></nowiki> around the text you want to parse directly.
 
 
 
=Official Guides=
 
* [http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page Quick Guide]
 
* [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide WikiMedia User's Guide]
 
* [http://meta.wikimedia.org/wiki/Help:Editing MediaWiki editing help].
 

Revision as of 01:39, 6 April 2009

How to Add pages to an automatically generated table

So you've looked at a page like Smithing, and found a moulding that needs to be added. You tried to edit the page and just saw:


<dpl>
  uses = Template:Mould
  notcategory= Minor Gems 
  notcategory= Standard Gems 
  notcategory= Major Gems
  include = {Mould}:Min, {Mould}.ptbl, {Mould}:Triv:Bars:Jewels:Frags
  table = class=sortable border = 5 id=0,-,Minimum,Name,Trivial,Bars,Jewels,Fragments
  tablesortcol=1
</dpl>

Making a New Page

It's actually really easy.

The easiest way it to just type in an unused address into your webbrowser. http://3kwiki.info/wiki/index.php/Whatever You Want

Or type the article name on the box on the main page of the wiki.

Using a Template

Templates do most of the work for you. You'll see on each moulding page a little table at the top with stats. That table, and all those stats, are done by using a template. The Autotable generator looks for all pages that use that template, and there ya go...

For an example, let's use the 1-handed Silver Sword page...

{{Mould
|Type= 1-Handed Silver Sword
|Min= 35
|Triv= 39
|Frags=
1 [[Fragment of Knowledge]]

1 [[:category:Minor Gems|minor gem]]
|Bars=
3 silver bar

|Jewels=
1 beryl dust

1 steel shards

}}
[[category:Weapons]]

A template in Wikicode is {{TemplateName }}; A template name inside a pair of braces (curly brackets). Parameters in the template are preceded with a |.

  • {{Mould |Type= Sword Name}}

Linking to other pages are done by simply putting the page name in [[ ]] square brackets. This is how we build the lists of "what uses this fragment" on their pages; by making a list of what links to that page, so please link the fragments.

  • 1 [[Fragment of Knowledge]]

Information on a wiki is only as good as how easy it is to find, so please add a category tag to the article. [[category: ]]. The Mould template in our example already includes a category:Moulds tag in it, so half the work's done for you. The C in category isn't case sensitive, but the Category name, after the :, is Case sensitive.

  • [[Category:Weapons]]

Links [[ ]] also change the displayed text for a page, Smithing, blacksmithing, making stuff all go to the same page. The | inside of a [[ ]] tag separates the Destination from the display. If you actually want to link to a category page, put a : before category in the tag.

  • 1 [[:category:Minor Gems | minor gem]]

The 2 lines between beryl dust and steel shards is to ensure that they're on separate lines in our table. Without a blank line, the 2nd and 3rd jewel ends up on the same line. I preferred to put a blank line bewteen the 1st and 2nd so it's consistent.

Knowing what parameters a template expects is easily figured out. Check out an existing page that uses the template, and edit it. At the bottom of the page you'll see each template listed, you can click the link to see the templates page, where you can look at the source if need be, or most likely, any template you are likely to ues will have usage information on that page.