Create new FAQ category - Revision history

Loci: unversioned

2019-07-21T17:28:28Z

unversioned

JubalHarshaw: cat

2008-12-29T19:14:32Z

cat

Juckto: Updated

2008-08-01T00:43:12Z

Updated

Juckto: /* Template Code */ updated code

2007-12-06T00:16:26Z

Template Code: updated code

Juckto: /* Template Code */

2007-11-27T02:10:30Z

Template Code

Juckto: New page: I used a fairly complex system to set up the FAQ page; involving templates, tables, and invisible headers. So this page is me providing an explanation of how it all works together, and the...

2007-11-27T01:56:54Z

New page: I used a fairly complex system to set up the FAQ page; involving templates, tables, and invisible headers. So this page is me providing an explanation of how it all works together, and the...

New page

I used a fairly complex system to set up the FAQ page; involving templates, tables, and invisible headers. So this page is me providing an explanation of how it all works together, and the basic code which you can copy-paste to create your own FAQ category.

[[User:Juckto|Juckto]] 20:56, 26 November 2007 (EST)

__TOC__

=Template=
A template is a wiki tool that acts kinda like a global "copy-paste" function. If you create a template page you can use it anywhere else on the wiki by simply using the <nowiki>{{ }}</nowiki> code.

 For example, if I created the page 
<nowiki>http://dwarf.lendemaindeveille.com/index.php/Template:Magma_FAQ</nowiki> 
I could insert it into any page by typing 
<nowiki>{{Magma FAQ}}</nowiki> 

I took full advantage of this to relate FAQ questions from the same category to each other. For obvious reasons, the code in each template is similiar, and [[FAQ addition#Template Code|below]] I provide the "blank slate" version which you can copy and alter accordingly.

'''Note:''' The only way to create a new template, that I know of, is to type it into the address bar (with the little Template: bit to differentiate from a normal page). It will, of course, come up as "No pages match" and you can edit it from there.

==Notation==
I consider it to be important to have a consistent naming system. All the template pages I created were of the form '''Category_FAQ''' (as opposed to "FAQ_Category").

 For example, 
<nowiki>http://dwarf.lendemaindeveille.com/index.php/Magma_FAQ</nowiki> 
Don't forget the underscore! (It becomes a 'space')

==Template Code==
This is the table I used in the templates, and the invisible comments I included to help anyone who wanted to add new questions to the template at a later date. Copy this entire section into your template page, and replace everything that is shown here in bold (note, some is off to the right).

On that note, I'm sorry about breaking the width on this page, but it has to be done otherwise this code breaks (badly) when you copy paste it.
<nowiki> 

{| align=center style="width: 80%; background: #DEDEDE; border: 1px solid #999; border-left-color:#CDCDCD; border-top-color:#CDCDCD; text-align: center"
|+ style="color: #fff; background: #bbb; border: 1px solid #999; border-left-color:#CDCDCD; border-top-color:#CDCDCD; padding: 0.2em 0.5em; text-align: center" | '''</nowiki> (Insert your category title here) <nowiki> FAQ'''
|-
| [[</nowiki> (Your first question) <nowiki>]]
|-
| [[</nowiki> (Your second question) <nowiki>]]
|-
| [[</nowiki> (Etcetera) <nowiki>]]

|-
|height="10"|
|-
| [http://dwarf.lendemaindeveille.com/index.php?title=Template:</nowiki>(Insert the category's address here - eg Magma_FAQ)<nowiki>&action=edit Add a question to the </nowiki>(Insert your category title here)<nowiki> FAQ]
|}
{| align=center
|This template has yet to be coloured in with pretty colours
|}

[[Category:FAQ]]
[[Category:FAQ - </nowiki>'''(Insert your category title here)'''<nowiki>]]</nowiki>

I want to stress that it is important that you get that category's address correct - that line is a web address that will take users to your template's editing options. It includes Javascript - or whatever it is (I'm no IT expert) - and so it's important you don't screw it up.

[http://dwarf.lendemaindeveille.com/index.php?title=Template:Magma_FAQ&action=edit An example of what the finished template code should look like]

=Invisible Headers=
Now for the final bit, adding your new category into the FAQ page. Just add the following code into the FAQ page.
When it came time to insert the templates into the overall FAQ page, I struck a problem. I wanted the page to have a Table of Contents (TOC), but there didn't seem much point in having them displayed throughout the page since every template was self-titled. Was there anyway I could supress them?

==Invisible Headers Code==
After a little fiddling around in a sandbox I came up the following solution:

<nowiki><h5></nowiki>(Title as you want it to appear in the TOC)<nowiki></h5>
{{</nowiki>(Name of your template)<nowiki>}}</nowiki>

It's not true invisibility, but makes the headers white, meaning they can't be seen on the white background. If you try highlighting the text on the FAQ, you will see them ;).

=Sub-categories=
To make your new category a sub-group of the overall FAQ category, simply click on the link at the bottom (it should be red), and copy the following code. Now your category is a sub-category of the FAQ category, and any new question added should be added to your category’s … category (doh).

==Sub-category code==
If you want to write an answer to somebody else’s posted question please try to keep the answer short and simple, and link to the in-depth explanations elsewhere in the wiki. Don't forget to include the template into your answer (copy the following code into your answer):

<nowiki>{{</nowiki>(Name of your template)<nowiki>}}</nowiki>

<nowiki>[[Category:FAQ]]</nowiki>

=Answers=
Don't forget to put the template in the answer page! Otherwise it renders the entire exercise pointless!

For example, if I was answering a question in the Magma section, I would add
<nowiki>{{Magma FAQ}}</nowiki>
at the bottom of my answer.

← Older revision		Revision as of 17:28, 21 July 2019
Line 71:		Line 71:

	[[Category:Wiki]]		[[Category:Wiki]]
		+	{{unversioned}}

← Older revision		Revision as of 19:14, 29 December 2008
Line 69:		Line 69:
	<nowiki>{{Magma FAQ}}</nowiki>		<nowiki>{{Magma FAQ}}</nowiki>
	at the bottom of my answer.		at the bottom of my answer.
		+
		+	[[Category:Wiki]]

@@ Line 1: / Line 1: @@
 =Template=
 A template is a wiki tool that acts kinda like a global "copy-paste" function. If you create a template page you can use it anywhere else on the wiki by simply using the <nowiki>{{ }}</nowiki> code.
@@ Line 32: / Line 24: @@
 This is the table I used in the templates, and the invisible comments I included to help anyone who wanted to add new questions to the template at a later date. Copy this entire section into your template page, and replace <u>everything</u> that is shown here in bold (note, some is off to the right).
-On that note, I'm sorry about breaking the width on this page, but it has to be done otherwise this code breaks (badly) when you copy-paste it.
+On that note, I'm sorry about breaking the width on this page, but it has to be done otherwise this code breaks (badly) when you copy-paste it. This code is for the Wood FAQ, but you can easily change the names to reflect your new category.
-  <nowiki> <!---To add a new question you need to scroll down to the bottom of this page and edit in TWO lines of code in the indicated spot.
+  <nowiki> <!---To add a new question, COPY the following two lines. ALL OF THEM. Yes I *DO* mean the |- stuff TOO. And PASTE them BETWEEN the ###### comments lower on this page.
- |-
+|-
- | [[Your question exactly as you want it to be read by others]]?
+| [[Your question exactly as you want it to be read by others]]
- Leave the question mark out of the link, as this wiki engine doesn't seem to cope well with creating %3F pages.
+LEAVE THE QUESTION MARK OUT, as this wiki engine doesn't cope well with creating %3F pages.
-The first line of code starts a new line of writing within the table, the second puts your question in and the [[ ]] make the question have it's own page for answering. Go ahead and scroll down now.--->
+<center>
- {| align=center style="width: 80%; background: #DEDEDE; border: 1px solid #999; border-left-color:#CDCDCD; border-top-color:#CDCDCD; text-align: center"
+<!--- ########### Insert any new questions above this line ########### --->
- |+ style="color: #fff; background: #bbb; border: 1px solid #999; border-left-color:#CDCDCD; border-top-color:#CDCDCD; padding: 0.2em 0.5em;  text-align: center" | '''</nowiki> <b>(Insert your category title here)</b> <nowiki> FAQ'''
+|-
- |-
+|height="10"|
- | [[</nowiki><b> (Your first question) </b><nowiki>]]
+|-
- |-
+| {{Edit|Template:Wood_FAQ|Add a question to the Wood FAQ}}
 |-
 | [[Frequently Asked Questions|Back to the Main FAQ]]
 |}
 </nowiki>
@@ Line 67: / Line 61: @@
 [http://dwarf.lendemaindeveille.com/index.php?title=Template:Magma_FAQ&action=edit An example of what the finished template code should look like]
 =Answers=

@@ Line 32: / Line 32: @@
 This is the table I used in the templates, and the invisible comments I included to help anyone who wanted to add new questions to the template at a later date. Copy this entire section into your template page, and replace <u>everything</u> that is shown here in bold (note, some is off to the right).
-On that note, I'm sorry about breaking the width on this page, but it has to be done otherwise this code breaks (badly) when you copy paste it.
+On that note, I'm sorry about breaking the width on this page, but it has to be done otherwise this code breaks (badly) when you copy-paste it.
   <nowiki> <!---To add a new question you need to scroll down to the bottom of this page and edit in TWO lines of code in the indicated spot.
   The 2 lines should be:
   |-
-  | [[Your question exactly as you want it to be read by others]]
+  | [[Your question exactly as you want it to be read by others]]?
-  Go ahead and scroll down now.--->
+  Leave the question mark out of the link, as this wiki engine doesn't seem to cope well with creating %3F pages.
   {| align=center style="width: 80%; background: #DEDEDE; border: 1px solid #999; border-left-color:#CDCDCD; border-top-color:#CDCDCD; text-align: center"
@@ Line 53: / Line 55: @@
   |height="10"|
   |-
-  | [http://dwarf.lendemaindeveille.com/index.php?title=Template:</nowiki><b>(Insert the category's <u>address</u> here - eg Magma_FAQ)</b><nowiki>&action=edit Add a question to the </nowiki><b>(Insert your category title here)</b><nowiki> FAQ]
+  | {{Edit|Template:</nowiki><b> (Insert the category's name here - eg Magma_FAQ) </b><nowiki>}} Add a question to the </nowiki><b>(Insert your category title here) </b><nowiki> FAQ]
   |}
 {| align=center
 |<small>This template has yet to be coloured in with pretty colours</small>
 |}
 </nowiki>
 I want to stress that it is important that you get that category's address correct - that line is a web address that will take users to your template's editing options. <br>It includes Javascript - or whatever it is (I'm no IT expert) - and so it's important you don't screw it up.

@@ Line 60: / Line 60: @@
- [[Category:FAQ]]
+  [[Category:FAQ - </nowiki>'''(Insert your category title here)'''<nowiki>]]</nowiki>
 I want to stress that it is important that you get that category's address correct - that line is a web address that will take users to your template's editing options. <br>It includes Javascript - or whatever it is (I'm no IT expert) - and so it's important you don't screw it up.
 [http://dwarf.lendemaindeveille.com/index.php?title=Template:Magma_FAQ&action=edit An example of what the finished template code should look like]
 =Invisible Headers=