Wiki Creation Walkthrough: Difference between revisions

From TowersWiki

No edit summary
No edit summary
 
(24 intermediate revisions by the same user not shown)
Line 1: Line 1:
Thanks to the generous assistance of [[User:Darc]], TowersWiki has the [[Template:LokiCharPage]] wiki construction kit available for use by our players. Of course, use of this template is not required: if you're good with MediaWiki and CSS, you're more than welcome to build your characters' pages from the ground up. For those who would prefer a slightly more plug and play experience, this page will show you step by step how to use the template to create a complete page.
Thanks to the generous assistance of [[User:Darc]], TowersWiki has the [[Template:LokiCharPage]] wiki construction kit available for use by our players. Of course, use of this template is not required: if you're good with MediaWiki and CSS, you're more than welcome to build your characters' pages from the ground up. For those who would prefer a slightly more plug and play experience, however, using the template is much easier. While the template itself provides some basic instruction, this page will show you the process step by step.


* For the purposes of this tutorial, we'll use [[Anne Bowesly]], the Ventrue Prince of London, as our sample character. You can refer to her page as we continue through the process.
* For the purposes of this tutorial, we'll use [[Anne Bowesly]], the Ventrue Prince of London, as our sample character. You can refer to her page as we continue through the process.
Line 5: Line 5:
* First, you'll need a wiki account. One will be automatically created for you upon character approval.
* First, you'll need a wiki account. One will be automatically created for you upon character approval.


* Once you have an account, log in (using the box in the upper right corner), and navigate to: https://towersmux.net/towerswiki/CharacterName -- in this case, https://towersmux.net/towerswiki/Anne_Bowesly. Use underscores (_) in place of spaces.
* Once you have an account, log in (using the box in the upper right corner), and navigate to: <nowiki>https://towersmux.net/towerswiki/CharacterName</nowiki> -- in this case, <nowiki>https://towersmux.net/towerswiki/Anne_Bowesly</nowiki>. Use underscores (_) in place of spaces. If there's nothing there, select the option to create the page. If there ''is'' already content there, then you may need to choose a different name for your character's wiki page. Alternatively, if it's a page for a character who has been retired, idled out, etc., please speak to someone on staff so they can move the old page out of the way.
 
* One way or another, you should now have a blank editbox.  Copy and paste the following:
 
<pre>
{{LokiCharPage
| fullname=Your Character's Name Here
}}
[[Category:Characters]]
</pre>
 
Alternatively, if you love everything about Anne's wiki page -- colors, layout, fonts, positioning, everything -- you can enter:
 
<pre>
{{LokiCharPage
| theme=queen
| full name=Anne Bowesly
| played by=Unknown
}}
[[Category:Characters]][[Category:NPCs]]
</pre>
 
The latter option means you don't ever need to edit the main page again, except perhaps to add the "<nowiki>{{Played by</nowiki>" section -- everything else will be automatically set as is shown below. Just fill in the red-linked pages as described below and you're done. If you want to do some additional customization, however, the former option might be a better choice.
 
Click "Save Changes", and you should see a very basic page with several red links. It probably looks very plain and empty right now, but not to worry: we'll fix that in the next few steps.
 
* Click the "CharacterName/Infobox" red link, or the "Edit" button in the "Overview" titlebar -- both will accomplish the same thing. Copy and paste the following, changing as appropriate for your character:
 
<pre>
{| align="center"
|-
| '''Name:'''
| Your character's full name
|-
| '''Appears In-Game As:'''
| Your in-game character name
|-
| '''Occupation:'''
| Your character's job
|-
| '''Apparent Age:'''
| How old your character looks
|-
| '''Demeanor:'''
| Your character's Demeanor
|-
| '''Eye Color:'''
| Your character's eye color
|-
| '''Hair Color:'''
| Your character's hair color
|-
| '''Date of Birth:'''
| Your character's date of birth
|}
</pre>
 
You don't need to use all of these entries if you don't want to, and you can add more of your own if you like: just follow the same basic format, i.e., each entry should look like this:
 
<pre>
|-
| '''A New Entry:'''
| Text of that entry
</pre>
 
When you're done, click "Save Changes", and then back out to the main character page. You'll probably need to refresh the page, but once you do, you should see the information you just entered displayed in the "Overview" box. It may be a little squished, but we'll fix that, too.
 
* Let's do the same for the 'CharacterName/Statistics' red link. This is meant to allow you to point out things that people will know or easily be able to find out about you, so you may not want to include things that aren't easy to find out. It's up to you, though!  Copy and paste the following, changing as appropriate to your character:
 
<pre>
'''Something Obvious:''' Some text describing it.
 
'''Something Else Obvious:''' Additional text describing that.
</pre>
 
There are other ways to format this information, using dot graphics to visually represent levels of stats rather than using numbers, and so on -- this is just the basics! And, as with all of these entries, you can add as many more as you think are justified. Once you're done, click "Save Changes" and then go back to the main character page and refresh.
 
* You're probably noticing, at this point, that the text in the "Statistics" box is awfully close up against the box boundaries. If you're happy with that, you can skip the next step. To change it, however, edit the main character page again, and at the top, above the "{{LokiCharPage" entry, add the following:
 
<pre>
{{#css:
.header {
  background-color:#34282C;
  color:#FFFFFF;
  text-align:center;
}
.container {
  background-color:#FFFFFF;
  text-align:left;
  vertical-align:top;
  padding:10px;
  margin-bottom:0.5em
}
}}
</pre>
 
Then, under the "| fullname=" line, add the following: 
 
<pre>
| introduction container class = container
| hooks container class = container
| portrait container class = container
| overview container class = container
| disclaimer container class = container
| statistics container class = container
| soundtrack container class = container
| contacts container class = container
| gallery container class = container
| introduction header class = header
| hooks header class = header
| portrait header class = header
| overview header class = header
| disclaimer header class = header
| statistics header class = header
| soundtrack header class = header
| contacts header class = header
| gallery header class = header
</pre>
 
This tells the wiki to apply the ".header" formatting instructions to the header for each of the cited boxes, and the ".container" formatting instructions to each of the boxes themselves. If you add additional boxes using the instructions in the Template page, you'll have to add similar entries for them, if you want these formatting instructions to apply to them also.
 
Save changes and refresh. That should look a little less crowded. If you feel like it's too much space, just lower the "padding" number until it looks right to you. And of course you can also change the "background-color" and "color" entries to suit your taste.
 
* Possibly by now you have an idea of what your character looks like. Maybe you have a drawing or painting, a piece of AI-generated art, a photograph of someone who resembles them -- something along those lines. If you don't, you can skip this step and come back to it later. If you do, go ahead and click the "CharacterName/Portrait" red link, and enter the following, modified for your character and for whatever format the image you have is in:
 
<pre>
[[File:CharName1.jpg|300px]]
</pre>
 
Click "Save Changes".  You should now see a red link that looks like "File:CharName1.jpg".  Click that link, and, on the "Upload File" page, click "Choose File" under "Source File".  Navigate to your local copy of the image file, select it, and click "OK"; then click "Upload File". You should see the image and a smaller thumbnail of it. If all looks good, go ahead and back out to the main character page, which should now feature a (probably resized) version of the image in the character box. If it looks too big or too small, you can increase or decrease "300px" until it's right -- although bear in mind that not everyone will be viewing the page on the same screen you are.  300 pixels is usually a good middle ground.
 
* By now the right side of the page should be looking pretty good, but the right side is a little lonely. Let's demonstrate how to relocate sections of the page by moving the "Soundtrack" section to the right side.  Edit the main page, and, under "| fullname=", add:
 
<pre>
| soundtrack position=left
</pre>
 
You can replace "left" with "right", "top", "bottom", or "off" (don't display the section at all) depending on your preferences.
While you're there, if you have a specific person whose image you used in the previous step, you might want to add:
 
<pre>
| played by=Name of Person
</pre>
 
You might also wish to add, above the "{{LokiCharPage" section:
 
<pre>
{{Played by
|Character name = character's name (if not specified, the page name is used)
|Model name    = Played-by's name
|Sample          = file name of image to show (e.g., CharName1.jpg)
}}
</pre>
 
This will cause your character to show up on the [[Template:Played_by]] page.
 
Click "Save Changes" and refresh.
 
* By now you probably have a pretty good idea how this is supposed to work, so go ahead and fill in the Introduction, Hooks, Contacts, and Soundtrack sections, too. If you want to link to someone else's entry on TowersWiki, you can do so like this:
 
<pre>
[[Anne Bowesly]]
</pre>
 
Or, to display something other than the name of the target page:
 
<pre>
[[Anne Bowesly|The Prince]]
</pre>
 
On the other hand, if you want to link to something off the wiki (like a music video on YouTube, say), use the following format:
 
<pre>
<span class="plainlinks">[https://url/to/visit/ Text of link]</span>
</pre>
 
You can omit the <nowiki>"<span class="plainlinks">" and "</span>"</nowiki>, although doing so will leave an external link icon that may bleed over onto your text. We're looking into ways to fix that particular issue.
 
* Adding images to the "Gallery" section is much like adding a portrait:
 
<pre>
[[File:CharName1.jpg|300px]] [[File:CharName2.jpg|300px]] [[File:CharName3.jpg|300px]]
</pre>
 
As with the portrait section, you can vary the size at which the images are displayed by changing the "300px" tags.
 
* Finally, let's do a little customization of various colors. Edit the main character page, and:
 
In the .header section, add:
 
<pre>
  background-color:#800020;
  color:#C0C0C0;
</pre>
 
This will make the headers a rich deep burgundy with silver text, just right for a distinguished elder vampire.
 
In the .container section, add:
 
<pre>
  background-color:#FFFFF0;
</pre>
 
This turns the background of the boxes ivory.
 
Finally, under "| fullname=", add:
 
<pre>
| page color=#800020
</pre>
 
This makes sure that the borders of the page *outside* the boxes is the same burgundy color as the box headers.
 
* The above walkthrough barely scratches the surface of the things you can do with MediaWiki in general and with the [[Template:LokiCharPage|LokiCharPage]] template in specific.  Be sure to read through the template page itself for more in-depth discussion of its possibilities.

Latest revision as of 03:25, 15 May 2024

Thanks to the generous assistance of User:Darc, TowersWiki has the Template:LokiCharPage wiki construction kit available for use by our players. Of course, use of this template is not required: if you're good with MediaWiki and CSS, you're more than welcome to build your characters' pages from the ground up. For those who would prefer a slightly more plug and play experience, however, using the template is much easier. While the template itself provides some basic instruction, this page will show you the process step by step.

  • For the purposes of this tutorial, we'll use Anne Bowesly, the Ventrue Prince of London, as our sample character. You can refer to her page as we continue through the process.
  • First, you'll need a wiki account. One will be automatically created for you upon character approval.
  • Once you have an account, log in (using the box in the upper right corner), and navigate to: https://towersmux.net/towerswiki/CharacterName -- in this case, https://towersmux.net/towerswiki/Anne_Bowesly. Use underscores (_) in place of spaces. If there's nothing there, select the option to create the page. If there is already content there, then you may need to choose a different name for your character's wiki page. Alternatively, if it's a page for a character who has been retired, idled out, etc., please speak to someone on staff so they can move the old page out of the way.
  • One way or another, you should now have a blank editbox. Copy and paste the following:
{{LokiCharPage 
| fullname=Your Character's Name Here
}}
[[Category:Characters]]

Alternatively, if you love everything about Anne's wiki page -- colors, layout, fonts, positioning, everything -- you can enter:

{{LokiCharPage 
| theme=queen
| full name=Anne Bowesly
| played by=Unknown
}}
[[Category:Characters]][[Category:NPCs]]

The latter option means you don't ever need to edit the main page again, except perhaps to add the "{{Played by" section -- everything else will be automatically set as is shown below. Just fill in the red-linked pages as described below and you're done. If you want to do some additional customization, however, the former option might be a better choice.

Click "Save Changes", and you should see a very basic page with several red links. It probably looks very plain and empty right now, but not to worry: we'll fix that in the next few steps.

  • Click the "CharacterName/Infobox" red link, or the "Edit" button in the "Overview" titlebar -- both will accomplish the same thing. Copy and paste the following, changing as appropriate for your character:
{| align="center"
|-
| '''Name:'''
| Your character's full name
|-
| '''Appears In-Game As:'''
| Your in-game character name 
|-
| '''Occupation:'''
| Your character's job
|-
| '''Apparent Age:'''
| How old your character looks
|-
| '''Demeanor:'''
| Your character's Demeanor
|-
| '''Eye Color:'''
| Your character's eye color
|-
| '''Hair Color:'''
| Your character's hair color
|-
| '''Date of Birth:'''
| Your character's date of birth
|}

You don't need to use all of these entries if you don't want to, and you can add more of your own if you like: just follow the same basic format, i.e., each entry should look like this:

|-
| '''A New Entry:'''
| Text of that entry

When you're done, click "Save Changes", and then back out to the main character page. You'll probably need to refresh the page, but once you do, you should see the information you just entered displayed in the "Overview" box. It may be a little squished, but we'll fix that, too.

  • Let's do the same for the 'CharacterName/Statistics' red link. This is meant to allow you to point out things that people will know or easily be able to find out about you, so you may not want to include things that aren't easy to find out. It's up to you, though! Copy and paste the following, changing as appropriate to your character:
'''Something Obvious:''' Some text describing it.

'''Something Else Obvious:''' Additional text describing that.

There are other ways to format this information, using dot graphics to visually represent levels of stats rather than using numbers, and so on -- this is just the basics! And, as with all of these entries, you can add as many more as you think are justified. Once you're done, click "Save Changes" and then go back to the main character page and refresh.

  • You're probably noticing, at this point, that the text in the "Statistics" box is awfully close up against the box boundaries. If you're happy with that, you can skip the next step. To change it, however, edit the main character page again, and at the top, above the "{{LokiCharPage" entry, add the following:
{{#css:
.header {
  background-color:#34282C; 
  color:#FFFFFF;
  text-align:center;
}
.container {
  background-color:#FFFFFF;
  text-align:left; 
  vertical-align:top; 
  padding:10px;
  margin-bottom:0.5em
}
}}

Then, under the "| fullname=" line, add the following:

| introduction container class = container
| hooks container class = container
| portrait container class = container
| overview container class = container
| disclaimer container class = container
| statistics container class = container
| soundtrack container class = container
| contacts container class = container
| gallery container class = container
| introduction header class = header
| hooks header class = header
| portrait header class = header
| overview header class = header
| disclaimer header class = header
| statistics header class = header
| soundtrack header class = header
| contacts header class = header
| gallery header class = header

This tells the wiki to apply the ".header" formatting instructions to the header for each of the cited boxes, and the ".container" formatting instructions to each of the boxes themselves. If you add additional boxes using the instructions in the Template page, you'll have to add similar entries for them, if you want these formatting instructions to apply to them also.

Save changes and refresh. That should look a little less crowded. If you feel like it's too much space, just lower the "padding" number until it looks right to you. And of course you can also change the "background-color" and "color" entries to suit your taste.

  • Possibly by now you have an idea of what your character looks like. Maybe you have a drawing or painting, a piece of AI-generated art, a photograph of someone who resembles them -- something along those lines. If you don't, you can skip this step and come back to it later. If you do, go ahead and click the "CharacterName/Portrait" red link, and enter the following, modified for your character and for whatever format the image you have is in:
[[File:CharName1.jpg|300px]]

Click "Save Changes". You should now see a red link that looks like "File:CharName1.jpg". Click that link, and, on the "Upload File" page, click "Choose File" under "Source File". Navigate to your local copy of the image file, select it, and click "OK"; then click "Upload File". You should see the image and a smaller thumbnail of it. If all looks good, go ahead and back out to the main character page, which should now feature a (probably resized) version of the image in the character box. If it looks too big or too small, you can increase or decrease "300px" until it's right -- although bear in mind that not everyone will be viewing the page on the same screen you are. 300 pixels is usually a good middle ground.

  • By now the right side of the page should be looking pretty good, but the right side is a little lonely. Let's demonstrate how to relocate sections of the page by moving the "Soundtrack" section to the right side. Edit the main page, and, under "| fullname=", add:
| soundtrack position=left

You can replace "left" with "right", "top", "bottom", or "off" (don't display the section at all) depending on your preferences. While you're there, if you have a specific person whose image you used in the previous step, you might want to add:

| played by=Name of Person

You might also wish to add, above the "{{LokiCharPage" section:

{{Played by
|Character name = character's name (if not specified, the page name is used)
|Model name     = Played-by's name
|Sample          = file name of image to show (e.g., CharName1.jpg)
}}

This will cause your character to show up on the Template:Played_by page.

Click "Save Changes" and refresh.

  • By now you probably have a pretty good idea how this is supposed to work, so go ahead and fill in the Introduction, Hooks, Contacts, and Soundtrack sections, too. If you want to link to someone else's entry on TowersWiki, you can do so like this:
[[Anne Bowesly]]

Or, to display something other than the name of the target page:

[[Anne Bowesly|The Prince]]

On the other hand, if you want to link to something off the wiki (like a music video on YouTube, say), use the following format:

<span class="plainlinks">[https://url/to/visit/ Text of link]</span>

You can omit the "<span class="plainlinks">" and "</span>", although doing so will leave an external link icon that may bleed over onto your text. We're looking into ways to fix that particular issue.

  • Adding images to the "Gallery" section is much like adding a portrait:
[[File:CharName1.jpg|300px]] [[File:CharName2.jpg|300px]] [[File:CharName3.jpg|300px]]

As with the portrait section, you can vary the size at which the images are displayed by changing the "300px" tags.

  • Finally, let's do a little customization of various colors. Edit the main character page, and:

In the .header section, add:

 
  background-color:#800020; 
  color:#C0C0C0;

This will make the headers a rich deep burgundy with silver text, just right for a distinguished elder vampire.

In the .container section, add:

  background-color:#FFFFF0;

This turns the background of the boxes ivory.

Finally, under "| fullname=", add:

| page color=#800020

This makes sure that the borders of the page *outside* the boxes is the same burgundy color as the box headers.

  • The above walkthrough barely scratches the surface of the things you can do with MediaWiki in general and with the LokiCharPage template in specific. Be sure to read through the template page itself for more in-depth discussion of its possibilities.