Grouse

EditingGuide: Difference between revisions

From Grouse House Wiki

No edit summary
No edit summary
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
== General Editing Guide and Templates ==
This page contains important editing information, tips, and tricks for creating and managing wiki pages.


=== Templates and Styles Available for Use ===
'''Crowdsourcing Notice'''
{{Crowdsourcing}}
<pre>{{Crowdsourcing}}</pre>


'''Single column list box like [[Lunar_Event#Schedule|here]]'''
<pre><html><table class="TB-basic-list">
<th style="text-align:center;">List Title</th>
<tr style="background-color: gray; text-align: center; font-weight: bold;"><td>List Subtitle</td></tr>
<tr><td>List Content</td></tr>
</table></html></pre>


'''Basic Responsive Image Grid'''<br>
<h2 class="h-static">Important Information</h2>
Used on the Main page-this format is best for larger images.
Grousehouse.wiki is hosted on a small server and large processes can overload the server, causing the site to go down. When editing very large pages, please edit only by section (the edit links that appear next to headers), rather than by the whole page, in order to prevent issues. If you notice that the site has gone down or experience any other major issues, please ping Maddie in the Discord.


<pre><div class="imagegrid">
 
<div class="gridimage">[[File: IMAGE SOURCE]]</div>
<h2 class="h-static">General Information</h2>
<div class="gridimage">[[File: IMAGE SOURCE]]</div>
Wiki pages can be edited using HTML or Wikitext markup. Documentation for both languages are linked below.
<div class="gridimage">[[File: IMAGE SOURCE]]</div>
 
<div class="gridimage">[[File: IMAGE SOURCE]]</div>
 
[https://en.wikipedia.org/wiki/Help:Wikitext Wikitext help page]
 
[https://developer.mozilla.org/en-US/docs/Web/HTML HTML documentation]
 
 
If you would like to use HTML in an article, you must surround it with < html> < /html> tags. There are a few exceptions to this: Mediawiki can parse all of the HTML tags listed [https://www.mediawiki.org/wiki/Help:HTML_in_wikitext here], so surrounding these tags is not necessary.
 
 
Formatting is also available for editors to manage using CSS. There are two pages for editing site CSS. The [https://grousehouse.wiki/MediaWiki:Common.css Common.css] file is for formatting of in-article elements like tables. The [https://grousehouse.wiki/MediaWiki:Foreground.css Foreground.css] file is for formatting of site-wide elements- this page should be edited with caution. Both formatting pages are managed by Maddie, so please let me know if you need any help with them.
 
 
If you're wanting to make an interactive element or something similar, JavaScript can be added to the site. Functions can be added on the [https://grousehouse.wiki/MediaWiki:Foreground.js Foreground.js] page.
 
If you would like to experiment with CSS or JavaScript without changes being visible to wiki viewers, you can edit group-specific pages. Editing [https://grousehouse.wiki/MediaWiki:Group-Grouse.css Group-Grouse.css] or [https://grousehouse.wiki/MediaWiki:Group-Grouse.js Group-Grouse.js] will make it so that your changes are only visible to logged-in users.
 
<h2 class="h-static">Uploading Images</h2>
Images can be uploaded on the [http://grousehouse.wiki/Special:Upload Upload File] page or using the menu bar when you're editing an article. If you're uploading multiple images at once, you can drag all of them into the upload menu on an article.
 
'''Please follow naming conventions when uploading images.''' If you're unsure how an image should be named, Maddie will be able to tell you.
 
Here are a few rules to follow when uploading images.
* When uploading item thumbnails, the name should remain exactly how it is on Wolvden (ie. the file for Arctic White is called "_butt_arcticwhite" on Wolvden so the file should be uploaded as "_butt_arcticwhite")
* Previews of decors should include the exact name of the decor followed by the stage that it is a preview of (ie. the preview of Arctic White on the Motherly pose would be uploaded as "_butt_arcticwhite_motherly")
 
<h2 class="h-static">Adding Images to an Article</h2>
 
Images can be added to articles in two different ways. Through wikitext, you can type <html>[[File:name]]</html>, with name being the file name and extension of the image you are added. Through HTML, images must be added using their links with <img src="link">. You will be able to find the link to an image by opening it in a new tab. You do not need to include grousehouse.wiki in the link, just /images/path. For example, the link to the Spring icon would be "/images/0/04/Icon-season-spring.png".
 
<h2 class="h-static">Color Guide</h2>
Here are some hex codes for some common colors used across the site.
 
 
<table style="width: 100%;">
<tr>
<td style="background-color: #252525; width: 10%;"></td><td style="padding-left: 1em; width: 20%;">#252525</td><td>Dark gray on header</td>
</tr><tr>
<td style="background-color: #5388a0; width: 10%;"></td><td style="padding-left: 1em;">#5388a0</td><td>Blue used on links and buttons</td>
</tr><tr>
<td style="background-color: #007095; width: 10%;"></td><td style="padding-left: 1em;">#007095</td><td>Dark blue used on hovers and some links</td>
</tr><tr>
<td style="background-color: #3a5f70; width: 10%;"></td><td style="padding-left: 1em;">#3a5f70</td><td>Dark blue used in table headers</td>
</tr><tr>
<td style="background-color: #648a9b; width: 10%;"></td><td style="padding-left: 1em;">#648a9b</td><td>Light blue used in table sub-headers</td>
</tr><tr>
<td style="background-color: #b0b0b0; width: 10%;"></td><td style="padding-left: 1em;">#b0b0b0</td><td>Header dark gray</td>
</tr><tr>
<td style="background-color: #bcbcbc; width: 10%;"></td><td style="padding-left: 1em;">#bcbcbc</td><td>Subheader mid gray</td>
</tr><tr>
<td style="background-color: #d4d4d4; width: 10%;"></td><td style="padding-left: 1em;">#d4d4d4</td><td>Sidebar mid gray</td>
</tr><tr>
<td style="background-color: #d33; width: 10%;"></td><td style="padding-left: 1em;">#d33</td><td>Warning red</td>
</tr>
</table>
 
<h2 class="h-static">Basic Page Setup</h2>
<h3 class="h-static">Headers and Sections</h3>
Headers define how a section is presented in the article. Sections can be collapsible - either collapsed by default or open by default - or static/noncollapsible. The header of each section must be defined by three elements: a header with a specific class, a div to start the collapsed content (if applicable), and a second header use to get around Mediawiki editing constraints. Headers entered without using a class will not appear on the page!
 
 
Right now, the use of these classes are only required for H2 and H3 headers - if you're using any header smaller than that, feel free to use equal signs instead!
 
 
===='''Collapsible Headers'''====
When using collapsible headers, each section must begin with a header class and collapsible content div, and end with a
<pre style="margin:0;"></div></pre>
For the section to include a working edit button, you must also add a second header to get around Mediawiki constraints.
 
 
In order to define the top of the collapsible content section, you can add this text. You will change the display style depending on whether or not the content is collapsed by default.
<pre><div class="c-content" style="display: block;"></pre>
 
 
For example, a section might appear like this if it is collapsible and open by default.
<pre><h2 class="c-header active">Header</h2>
<div class="c-content" style="display: block;">
== Header ==
Section content.
</div></pre>
</div></pre>


'''Small Image Grid'''<br>
This grid format is best used for lists of items like [[[[Lunar_Event#Event-Specific_Trophies|here]].


In this template, Fields 1 and 2 can be used to share any text, like the item's obtention or cost.
'''Open by Default'''
<pre>{{ItemGrid}}
 
{{ItemGridItem|[[File: IMAGE SOURCE]]|ITEM NAME|FIELD 1|FIELD 2}}
To create a section that's open by default, add the following class to your header tag and change the collapsible div display style to "block".
{{EndItemGrid}}</pre>


'''Lunar Explore Encounters'''<br>
Explore encounter tables follow a simple format. These templates do not have time of day indicators like other explore encounters would need.


Image and text
'''Main Header'''
<pre><html><table class="explore_encounter"><tr><td colspan=3 style="background:white;">[[File: IMAGE SOURCE.png]]</td></tr>
<pre><h2 class="c-header active">Header</h2>
<tr><td colspan=3>ENCOUNTER TEXT</td></tr></pre>
<div class="c-content" style="display: block;"></pre>


Multiple choice options
'''Sub Header'''
<pre><tr class="encounter_options">
<pre><h3 class="c-header active">Header</h3>
<td style="width: 20%;">OPTION 1</td>
<div class="c-content" style="display: block;"></pre>
<td style="width: 50%;">RESULT 1</td>
<td style="width: 30%;">REWARD 1</td></tr>
<tr class="encounter_options">
<td style="width: 20%;">OPTION 2</td>
<td style="width: 50%;">RESULT 2</td>
<td style="width: 30%;">REWARD 2</td></tr></pre>


If an option has multiple results, you can use a rowspan.
<pre><tr class="encounter_options">
<td style="width: 20%;" rowspan=2>OPTION 1</td>
<td style="width: 50%;">RESULT 1a</td>
<td style="width: 30%;">REWARD 1a</td></tr>
<tr class="encounter_options">
<td style="width: 50%;">RESULT 1b</td>
<td style="width: 30%;">REWARD 1b</td></tr></pre>


Be sure to close the table when you're done!
'''Closed by Default'''
<pre></table></html></pre>


'''Shopkeeper Table'''<br>
To create a section that's open by default, add the following class to your header tag and change the collapsible div display style to "none".
This table is used at the top of any shops to share the shopkeeper's image and text.


<pre><table class="shopkeeper" style="background-color:#dedede;border:1px solid black;">
<tr style="border: 1px solid black;">
<td style="background-color:#c7c7c7;"><b>SHOPKEEPER NAME</b></td><td style="text-align:right;background-color:#c7c7c7;"></td></tr>
<tr><td><img src="IMAGE SOURCE"></td>
<td>SHOPKEEPER TEXT</td></tr>
</table></html></pre>


'''Main Header'''
<pre><h2 class="c-header hidden">Header</h2>
<div class="c-content" style="display: none;"></pre>


'''Shop Content'''<br>
'''Sub Header'''
Shop content templates are separated by shop to make updating easier.
<pre><h3 class="c-header hidden">Header</h3>
<div class="c-content" style="display: none;"></pre>


Lunar Shop Content
<pre>{{ShopContent}}
{{LunarShopItem||ITEM NAME|[[File: IMAGE THUMB SOURCE]]|COST (DIGIT ONLY)|ADDITIONAL REQUIREMENTS|[[FILE: PREVIEW IMAGE SOURCE]]}}
{{EndShopContent}}</pre>


'''Static/Noncollapsible'''


'''Lunar Event Applicators'''<br>
<p style="margin:0;">To create a section that's static/non-collapsible, add the following class to your header tag. When using a static section, you do not need to use include <pre><div class="c-content"></pre> or <pre></div></pre> at the end of the section.</p>
Monthly lunar event applicators.


Base month
<pre><table class="lunar_applicators">
<tr style="border: 1px solid black;">
<td style="background-color:#c7c7c7;" colspan=4><b>MONTH YEAR</b></td>
</tr><tr style="border: 1px solid black;">
<td colspan=4>[[File: PREVIEW IMAGE SOURCE|class="img_appmonth"]]</td>
</tr><tr style="border: 1px solid black;">
<td style="width: 25%;">[[File: BASE ICON SOURCE]]<br>'''Base Applicator [NAME]'''<br>[[File:Icon-lunartear.png]] 500 LT</td>
<td style="width: 25%;">[[File: CLAW ICON SOURCE.png]]<br>'''Claw Applicator [NAME]'''<br>[[File:Icon-lunartear.png]] 80 LT</td>
<td style="width: 25%;">[[File: NOSE ICON SOURCE.png]]<br>'''Nose Applicator [NAME]'''<br>[[File:Icon-lunartear.png]] 80 LT</td>
<td style="width: 25%;">[[File: SKIN ICON SOURCE.png]]<br>'''Skin Applicator [NAME]'''<br>[[File:Icon-lunartear.png]] 80 LT</td>
</tr><tr style="border: 1px solid black;">
<td>[[File: EYES ICON SOURCE.png]]<br>'''Eye Applicator [NAME]'''<br>[[File:Icon-lunartear.png]] 200 LT</td>
<td></td><td></td><td></td></tr></table></pre>


Markings month
'''Main Header'''
<pre><table class="lunar_applicators">
<pre><h2 class="h-static">Header</h2></pre>
<tr style="border: 1px solid black;">
 
<td style="background-color:#c7c7c7;" colspan=4><b>MONTH YEAR</b></td>
'''Sub Header'''
</tr><tr style="border: 1px solid black;">
<pre><h3 class="h-static">Header</h3></pre>
<td colspan=4>[[File: PREVIEW IMAGE SOURCE.png|class="img_appmonth"]]</td>
</tr><tr style="border: 1px solid black;">
<td style="width: 25%;"></td>
<td style="width: 25%;">[[File: MARKINGS ICON SOURCE.png]]<br>'''Markings Applicator [NAME]'''<br>[[File:Icon-lunartear.png]] 250 LT</td><td style="width: 25%;">[[File: EYES ICON SOURCE.png]]<br>'''Eye Applicator [NAME]'''<br>[[File:Icon-lunartear.png]] 200 LT</td><td style="width: 25%;"></td></tr></table></pre>


Special event with eye applicator
<pre><table class="lunar_applicators">
<tr style="border: 1px solid black;">
<td style="background-color:#c7c7c7;" colspan=4><b>MONTH YEAR</b></td>
</tr><tr>
<td colspan=3>During this Special Lunar Event, every previous applicator returned, so only an eye applicator was introduced.</td>
</tr><tr style="border: 1px solid black;">
<td colspan=3>[[File: PREVIEW IMAGE SOURCE.png]]</td>
</tr><tr style="border: 1px solid black;">
<td style="width: 33%;"></td>
<td style="width: 33%;">[[File: EYES ICON SOURCE.png]]<br>'''Eye Applicator [NAME]'''<br>[[File:Icon-lunartear.png]] 200 LT</td>
<td style="width: 33%;"></td></tr></table></pre>


Special event with no new applicators
'''Examples'''
<pre><table class="lunar_applicators">
<tr style="border: 1px solid black;">
<td style="background-color:#c7c7c7;" colspan=4><b>MONTH YEAR</b></td>
</tr><tr>
<td colspan=3>No new applicators were released during this Special Lunar Event.</td>
</tr></table></pre>


'''Crafting Recipe'''
Here are some of the common headers used across the site as examples you can copy and paste.


<pre>{{CraftingRecipe
|RECIPE NAME
|[[File: RECIPE THUMB SOURCE]]
|INGREDIENTS - with images and separated by breaks (example below)
|OBTENTION METHOD
|[[File: PREVIEW IMAGE SOURCE]]
}}</pre>


Ingredients formatting example
'''H2 Collapsed by Default (used on every long page)'''
<pre>
<pre><h2 class="c-header hidden">Header</h2>
{{CraftingRecipe
<div class="c-content" style="display: none;">
|RECIPE NAME
== Header ==
|[[File: RECIPE THUMB SOURCE]]
Section content.
|[[File:chargedcore.png]] x1 Charged Core<br>[[File:charged_eyeball.png]] x2 Charged Eyeball<br>[[File:essence-covered-furclump.png]] x10 Essence-Covered Fur Clump<br>[[File:glowing_spores.png]] x15 Glowing Spores
</div></pre>
|OBTENTION METHOD
|[[File: PREVIEW IMAGE SOURCE]]
}}</pre>


=== Tips and Tricks ===
'''Making a section collapsible'''<br><br>


Article sections are not collapsible by default on the desktop version of the wiki. In order to make a caption collapse, the header must be an h2 header, and the content in the section must be surrounded by a classed div.<
'''H3 Collapsed by Default'''
<pre>== HEADER ==
<pre><h3 class="c-header hidden">Header</h3>
<div class="c-content">
<div class="c-content" style="display: none;">
CONTENT
=== Header ===
Section content.
</div></pre>
</div></pre>


'''Adding a caption to an image'''<br><br>


Mediawiki's built-in Frame format helps you add a caption to an image. By default, the framed image will be off to the side of the page, but adding a "center" parameter will move it to the center.
'''H2 Static/Noncollapsible'''
<pre>[[File: IMAGE SOURCE|frame|CAPTION]]
<pre><h2 class="h-static">Header</h2>
[[File: IMAGE SOURCE|center|frame|CAPTION]]</pre>
== Header ==</pre>

Latest revision as of 16:46, 25 March 2024

This page contains important editing information, tips, and tricks for creating and managing wiki pages.


Important Information

Grousehouse.wiki is hosted on a small server and large processes can overload the server, causing the site to go down. When editing very large pages, please edit only by section (the edit links that appear next to headers), rather than by the whole page, in order to prevent issues. If you notice that the site has gone down or experience any other major issues, please ping Maddie in the Discord.


General Information

Wiki pages can be edited using HTML or Wikitext markup. Documentation for both languages are linked below.


Wikitext help page

HTML documentation


If you would like to use HTML in an article, you must surround it with < html> < /html> tags. There are a few exceptions to this: Mediawiki can parse all of the HTML tags listed here, so surrounding these tags is not necessary.


Formatting is also available for editors to manage using CSS. There are two pages for editing site CSS. The Common.css file is for formatting of in-article elements like tables. The Foreground.css file is for formatting of site-wide elements- this page should be edited with caution. Both formatting pages are managed by Maddie, so please let me know if you need any help with them.


If you're wanting to make an interactive element or something similar, JavaScript can be added to the site. Functions can be added on the Foreground.js page.

If you would like to experiment with CSS or JavaScript without changes being visible to wiki viewers, you can edit group-specific pages. Editing Group-Grouse.css or Group-Grouse.js will make it so that your changes are only visible to logged-in users.

Uploading Images

Images can be uploaded on the Upload File page or using the menu bar when you're editing an article. If you're uploading multiple images at once, you can drag all of them into the upload menu on an article.

Please follow naming conventions when uploading images. If you're unsure how an image should be named, Maddie will be able to tell you.

Here are a few rules to follow when uploading images.

  • When uploading item thumbnails, the name should remain exactly how it is on Wolvden (ie. the file for Arctic White is called "_butt_arcticwhite" on Wolvden so the file should be uploaded as "_butt_arcticwhite")
  • Previews of decors should include the exact name of the decor followed by the stage that it is a preview of (ie. the preview of Arctic White on the Motherly pose would be uploaded as "_butt_arcticwhite_motherly")

Adding Images to an Article

Images can be added to articles in two different ways. Through wikitext, you can type [[File:name]], with name being the file name and extension of the image you are added. Through HTML, images must be added using their links with <img src="link">. You will be able to find the link to an image by opening it in a new tab. You do not need to include grousehouse.wiki in the link, just /images/path. For example, the link to the Spring icon would be "/images/0/04/Icon-season-spring.png".

Color Guide

Here are some hex codes for some common colors used across the site.


#252525Dark gray on header
#5388a0Blue used on links and buttons
#007095Dark blue used on hovers and some links
#3a5f70Dark blue used in table headers
#648a9bLight blue used in table sub-headers
#b0b0b0Header dark gray
#bcbcbcSubheader mid gray
#d4d4d4Sidebar mid gray
#d33Warning red

Basic Page Setup

Headers and Sections

Headers define how a section is presented in the article. Sections can be collapsible - either collapsed by default or open by default - or static/noncollapsible. The header of each section must be defined by three elements: a header with a specific class, a div to start the collapsed content (if applicable), and a second header use to get around Mediawiki editing constraints. Headers entered without using a class will not appear on the page!


Right now, the use of these classes are only required for H2 and H3 headers - if you're using any header smaller than that, feel free to use equal signs instead!


Collapsible Headers

When using collapsible headers, each section must begin with a header class and collapsible content div, and end with a

</div>

For the section to include a working edit button, you must also add a second header to get around Mediawiki constraints.


In order to define the top of the collapsible content section, you can add this text. You will change the display style depending on whether or not the content is collapsed by default.

<div class="c-content" style="display: block;">


For example, a section might appear like this if it is collapsible and open by default.

<h2 class="c-header active">Header</h2>
<div class="c-content" style="display: block;">
== Header ==
Section content.
</div>


Open by Default

To create a section that's open by default, add the following class to your header tag and change the collapsible div display style to "block".


Main Header

<h2 class="c-header active">Header</h2>
<div class="c-content" style="display: block;">

Sub Header

<h3 class="c-header active">Header</h3>
<div class="c-content" style="display: block;">


Closed by Default

To create a section that's open by default, add the following class to your header tag and change the collapsible div display style to "none".


Main Header

<h2 class="c-header hidden">Header</h2>
<div class="c-content" style="display: none;">

Sub Header

<h3 class="c-header hidden">Header</h3>
<div class="c-content" style="display: none;">


Static/Noncollapsible

To create a section that's static/non-collapsible, add the following class to your header tag. When using a static section, you do not need to use include

<div class="c-content">

or

</div>

at the end of the section.


Main Header

<h2 class="h-static">Header</h2>

Sub Header

<h3 class="h-static">Header</h3>


Examples

Here are some of the common headers used across the site as examples you can copy and paste.


H2 Collapsed by Default (used on every long page)

<h2 class="c-header hidden">Header</h2>
<div class="c-content" style="display: none;">
== Header ==
Section content.
</div>


H3 Collapsed by Default

<h3 class="c-header hidden">Header</h3>
<div class="c-content" style="display: none;">
=== Header ===
Section content.
</div>


H2 Static/Noncollapsible

<h2 class="h-static">Header</h2>
== Header ==