Gswiki:Style guide/Logs: Difference between revisions

The official GemStone IV encyclopedia.
< Gswiki:Style guide
Jump to navigation Jump to search
m (Updated casing in categories per https://gswiki.play.net/Help:Storyline_guidelines)
m (GS4-XERAPHINA moved page Help:Logs to Gswiki:Style guide/Logs: moving to subpage to Gswiki:Style guide)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
'''Log pages''' are articles that mainly consist of text copied from the game instance depicting real events that happened in game which may be lightly or heavily edited. The format of these articles is specified in the [[Help:Style/Formatting_special_articles#Logs|Style Guide]].
'''Log pages''' are articles that mainly consist of text copied from the game instance depicting real events that happened in-game which may be lightly or heavily edited. The format of these articles is specified in the [[Help:Style/Formatting_special_articles#Logs|Style Guide]].


==Style Guide Excerpt==
==Style Guide Excerpt==
<div style="background:#f3f3f9;border-style:solid;border-width:1px">{{#section:Help:Style/Formatting_special_articles|logs}}
<div style="background:#f3f3f9;border-style:solid;border-width:1px">{{#section-h:Help:Style/Formatting_special_articles|logs}}
</div>
</div>


==Article Title==
==Article Title==


Log pages (also referred to as an [https://en.wikipedia.org/wiki/Wikipedia:What_is_an_article%3F article]) can be placed directly in the mainspace. The mainspace is any article placed immediately after <nowiki>https://gswiki.play.net/</nowiki> without being placed into a category or other [https://www.mediawiki.org/wiki/Help:Namespaces namespace]. Other namespaces can be viewed when an article starts with something such as 'Category:', 'Help:', or 'Template:' such as this article, which is in the help namespace.
Log pages (also referred to as an [https://en.wikipedia.org/wiki/Wikipedia:What_is_an_article%3F article]) will either be placed directly in the mainspace or will be subpaged off a storyline page. The mainspace is any article placed immediately after <nowiki>https://gswiki.play.net/</nowiki> without being placed into a category or other [https://www.mediawiki.org/wiki/Help:Namespaces namespace]. Other namespaces can be viewed when an article starts with something such as 'Category:', 'Help:', or 'Template:' such as this article, which is in the help namespace.


When you are titling your log page, you will want it to follow the style guide so that it is formatted according to the type of log it is such as:
When you are titling your log page, you will want it to follow the style guide so that it is formatted like '[Storyline or Event Title, if applicable] - [Date] - [Title of Log, if applicable] (log)'. This means that one way you can create the page is by typing a URL into the address/search bar of your browser such as <nowiki>https://gswiki.play.net/Blood_Son_-_2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log)</nowiki>. In order to create spaces in the URL, if you are using this method to create the page, use an underscore (_). Once you hit enter, you will be brought to a new page that says there is no text created on the page and you can click the Create button on the top right.
* '''Storyline Log''': <code><nowiki>Storyline redirect page name (storyline)/[Date] - [Title of Log, if applicable] (log)</nowiki></code>
* '''OOC Meeting Log''': <code><nowiki>[Date] - [Town Name or Subscription Type] - [Title of Log, if applicable] (log)</nowiki></code>
* '''Other Log''': <code><nowiki>[Event Title, if applicable] - [Date] - [Title of Log, if applicable] (log)</nowiki></code>

This means that one way you can create the page is by typing a URL into the address/search bar of your browser such as <code><nowiki>https://gswiki.play.net/Mist_Harbor_Library_Lectures_-_2022-01-30_-_Ivas_Provides_(log)</nowiki></code> or <code><nowiki>https://gswiki.play.net/Blood_Son_(storyline)/2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log)</nowiki></code>. In order to create spaces in the URL, if you are using this method to create the page, use an underscore (_). Once you hit enter, you will be brought to a new page that says there is no text created on the page and you can click the Create button on the top right.


The rationale for this method of titling logs is that:
The rationale for this method of titling logs is that:


* by having the storyline or event first, it will group all similar logs from the same storyline in category pages and sortable lists, which makes it easier for people to find logs from the same storyline or event,
* by having the storyline page or event name first, it will group all similar logs from the same storyline in category pages and sortable lists, which makes it easier for people to find logs from the same storyline or event, (''Note: OOC meeting logs are organized differently at the Event APM's request.'')
* by having the date next in the format of YYYY-MM-DD, it will chronologically order all logs from the same storyline or event in category pages and sortable lists,
* by having the date next in the format of YYYY-MM-DD, it will chronologically order all logs from the same storyline or event in category pages and sortable lists,
* by having the title of the log next, people will be able to see what the log is about from the category page or sortable list, and
* by having the title of the log next, people will be able to see what the log is about from the category page or sortable list, and
* by having (log) at the end, people know that it denotes actual events that happened in game.
* by having (log) at the end, people know that it denotes actual events that happened in-game.


The preference is to use the real date in log article titles and not the Elanthian date. When there is a mix of both kinds of dates, they do not properly group in chronologically order inside of category pages and sortable lists.
The preference is to use the real date in log article titles, not the Elanthian date. When there is a mix of both kinds of dates, they do not properly group in chronological order inside category pages and sortable lists.


==Introduction==
==Introduction==
Line 24: Line 29:
All log pages should start with 'This log is from the {storyline/event (page linked if applicable)} on {date} from the viewpoint of {character}.' This consistency helps people to find the information to place the log into context and immediately directs them where to go to find more information about the storyline or event. For example:
All log pages should start with 'This log is from the {storyline/event (page linked if applicable)} on {date} from the viewpoint of {character}.' This consistency helps people to find the information to place the log into context and immediately directs them where to go to find more information about the storyline or event. For example:


:This log is from [[Blood Son]] on 01/01/2020 from the viewpoint of [[User:MOD-GSMOTTE|Motte]].
:<code><nowiki>This log is from [[:Category:Blood Son|the Blood Son storyline]] on 01/01/2020 from the viewpoint of [[User:MOD-GSMOTTE|Motte]].</nowiki></code>


Remember that if you are directing people to a category page, you will want to make sure you put the colon at the front of the link and then add a pipe (|) and the text you want for your link. For example: <nowiki>[[:Category:Blood Son|Blood Son]]</nowiki>. This is only necessary for category pages. The colon makes it so that instead of adding the article to the category, you link to the category.
Remember that if you are directing people to a category page, you will want to make sure you put the colon at the front of the link and then add a pipe (|) and the text you want for your link. For example: <code><nowiki>[[:Category:Blood Son|Blood Son]]</nowiki></code>. This is only necessary for category pages. The colon makes it so that instead of adding the article to the category, you link to the category.


==Content==
==Content==


Below the introduction is the main content space. The bulk of the log article can be formatted however the editor prefers. Editors can use headers to break up the length of the log and to create a Table of Contents. Please remember that all headers on wiki pages should start with the level two header, which means they start with two equal signs on either side of the header. Example: <nowiki>==Summary==</nowiki>. Another example would be: <nowiki>===Blood Son Gets Bloody===</nowiki>. These headers can also be used to create links to direct people to content. For example: <nowiki>https://gswiki.play.net/Blood_Son_-_2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log)#Blood_Son_Gets_Bloody</nowiki> would take you directly to that section of the log.
Below the introduction is the main content space. The bulk of the log article can be formatted however the editor prefers. Editors can use headers to break up the length of the log and to create a Table of Contents. Please remember that all headers on wiki pages should start with the level two header, which means they start with two equal signs on either side of the header. Example: <code><nowiki>==Summary==</nowiki></code>. Another example would be: <code><nowiki>===Blood Son Gets Bloody===</nowiki></code>. These headers can also be used to create links to direct people to content. For example: <code><nowiki>https://gswiki.play.net/Blood_Son_(storyline)/2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log)#Blood_Son_Gets_Bloody</nowiki></code> would take you directly to that section of the log.


People may want to add additional headers so that their log has a summary, notes characters in attendance or their appearance, or some other valuable or interesting information. An example could look like:
People may want to add additional headers so that their log has a summary, notes characters in attendance or their appearance, or some other valuable or interesting information. An example could look like:
Line 52: Line 57:


Log pages should have the following categories placed at the bottom of the page:
Log pages should have the following categories placed at the bottom of the page:
* <nowiki>[[Category:Logs]]</nowiki>
* <code><nowiki>[[Category:Logs]]</nowiki></code>
* Storyline or event category, if applicable, such as: <nowiki>[[Category:Blood Son]]</nowiki>
* Storyline, OOC meetings, or event category, if applicable, such as: <code><nowiki>[[Category:Blood Son]]</nowiki></code>, <code><nowiki>[[Category:OOC meetings]]</nowiki></code>, or <code><nowiki>[[Category:Mist Harbor Library Lectures]]</nowiki></code>.


Storyline logs should not be categorized into the town storylines or dated storylines categories. Instead, the storyline category page itself should be placed into both of those. So for example, this log would not be in [[:Category:Wehnimer's Landing storylines]] or [[:Category:2020 storylines]]. Instead, [[:Category:Blood Son]] will be placed into both of those. This cuts down on clutter inside of the town storylines and dated storylines categories so that people can easily find the storyline they want without having to wade through pages of logs.
Storyline logs should not be categorized into the town storylines or dated storylines categories. Instead, the storyline category page itself should be placed into both of those. So for example, a log from the Blood Sons storyline would not be in [[:Category:Wehnimer's Landing storylines]] or [[:Category:2020 storylines]]. Instead, [[:Category:Blood Son]] will be placed into both of those. This cuts down on clutter inside of the town storylines and dated storylines categories so that people can easily find the storyline they want without having to wade through pages of logs.


==Example, All Together==
==Example, All Together==


The article title for this example would be: <nowiki>https://gswiki.play.net/Blood_Son_-_2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log)</nowiki>
The article title for this example would be: <code><nowiki>https://gswiki.play.net/Blood_Son_(storyline)/2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log)</nowiki></code>


The formatting of the log for this example could look like:
The formatting of the log for this example could look like:


This log is from [[Blood Son]] on 01/01/2020 from the viewpoint of [[User:MOD-GSMOTTE|Motte]].
This log is from [[:Category:Blood Son|the Blood Son storyline]] on 01/01/2020 from the viewpoint of [[User:MOD-GSMOTTE|Motte]].
<nowiki>==Summary==</nowiki>
<nowiki>==Summary==</nowiki>
In this log, the Blood Son proselytized to his followers and suggested that there would be some Big Bad Event happening later in the week.
In this log, the Blood Son proselytized to his followers and suggested that there would be some Big Bad Event happening later in the week.
Line 75: Line 80:
<nowiki>[[Category:Logs]]</nowiki>
<nowiki>[[Category:Logs]]</nowiki>
<nowiki>[[Category:Blood Son]]</nowiki>
<nowiki>[[Category:Blood Son]]</nowiki>

==See Also==

* [[Help:Style/Formatting_special_articles#Logs|Style Guide - Logs]]
* [[Help:Storyline_guidelines|Storyline guidelines]]


==Questions?==
==Questions?==

Latest revision as of 14:19, 9 October 2023

Log pages are articles that mainly consist of text copied from the game instance depicting real events that happened in-game which may be lightly or heavily edited. The format of these articles is specified in the Style Guide.

Style Guide Excerpt

Logs is the shorthand term for files containing a record of in-game events seen through the viewpoint of characters.

  • All log page titles should use the real year, not the Elanthian year, to help reduce confusion for other players. The content of log pages can reference either the real year or the Elanthian year.
  • All log page title dates should be in the format YYYY-MM-DD.
  • All log pages should begin with: This log is from the {storyline/event (page linked if applicable)} on {date} from the viewpoint of {character}.
  • Log page content can use headers to break up the length, have summaries, note characters involved, and otherwise be formatted however the poster would like. They can use the following code for consistency and ease of reading: <pre{{log2|border=none|font=arial}}> PASTE LOG HERE </pre> .
  • All logs should be categorized in [[Category: Logs]].

There are currently three different categories of logs with special rules for mainspace/subpage placement, categories, and article titles for the purposes of documenting events on the wiki: storyline logs, OOC meeting logs, and other logs.

Storyline Logs

Storyline logs should be tied to the storyline first by name, then by date. This mirrors standards in place for handling other logs, except that these should be set up as subpages to the storyline redirect page. Page naming standard should be as follows: Storyline redirect page name (storyline)/[Date] - [Title of Log, if applicable] (log)

It is on the contributor uploading the log to ensure the log is linked on the storyline catalog article space, and if done so, it must be under the Logs subheader. The storyline's category, as well as the log category, should be added to the log.

Storyline logs should additionally be categorized within the category or categories created specifically for that storyline. Only the storyline category, not the log, should be categorized into its relevant town storylines category (i.e. Wehnimer's Landing storylines), its relevant year (i.e. 2016 Storylines), and the [[Category: {Storyline}]] category.

OOC Meeting Logs

Page naming standard should be as follows:: [Date] - [Town Name or Subscription Type] - [Title of Log, if applicable] (log)

Other Logs

Other log page titles should be formatted like this: [Event Title, if applicable] - [Date] - [Title of Log, if applicable] (log). For example: Mist Harbor Library Lectures - 2022-01-30 - Ivas Provides (log)

Article Title

Log pages (also referred to as an article) will either be placed directly in the mainspace or will be subpaged off a storyline page. The mainspace is any article placed immediately after https://gswiki.play.net/ without being placed into a category or other namespace. Other namespaces can be viewed when an article starts with something such as 'Category:', 'Help:', or 'Template:' such as this article, which is in the help namespace.

When you are titling your log page, you will want it to follow the style guide so that it is formatted according to the type of log it is such as:

  • Storyline Log: Storyline redirect page name (storyline)/[Date] - [Title of Log, if applicable] (log)
  • OOC Meeting Log: [Date] - [Town Name or Subscription Type] - [Title of Log, if applicable] (log)
  • Other Log: [Event Title, if applicable] - [Date] - [Title of Log, if applicable] (log)

This means that one way you can create the page is by typing a URL into the address/search bar of your browser such as https://gswiki.play.net/Mist_Harbor_Library_Lectures_-_2022-01-30_-_Ivas_Provides_(log) or https://gswiki.play.net/Blood_Son_(storyline)/2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log). In order to create spaces in the URL, if you are using this method to create the page, use an underscore (_). Once you hit enter, you will be brought to a new page that says there is no text created on the page and you can click the Create button on the top right.

The rationale for this method of titling logs is that:

  • by having the storyline page or event name first, it will group all similar logs from the same storyline in category pages and sortable lists, which makes it easier for people to find logs from the same storyline or event, (Note: OOC meeting logs are organized differently at the Event APM's request.)
  • by having the date next in the format of YYYY-MM-DD, it will chronologically order all logs from the same storyline or event in category pages and sortable lists,
  • by having the title of the log next, people will be able to see what the log is about from the category page or sortable list, and
  • by having (log) at the end, people know that it denotes actual events that happened in-game.

The preference is to use the real date in log article titles, not the Elanthian date. When there is a mix of both kinds of dates, they do not properly group in chronological order inside category pages and sortable lists.

Introduction

All log pages should start with 'This log is from the {storyline/event (page linked if applicable)} on {date} from the viewpoint of {character}.' This consistency helps people to find the information to place the log into context and immediately directs them where to go to find more information about the storyline or event. For example:

This log is from [[:Category:Blood Son|the Blood Son storyline]] on 01/01/2020 from the viewpoint of [[User:MOD-GSMOTTE|Motte]].

Remember that if you are directing people to a category page, you will want to make sure you put the colon at the front of the link and then add a pipe (|) and the text you want for your link. For example: [[:Category:Blood Son|Blood Son]]. This is only necessary for category pages. The colon makes it so that instead of adding the article to the category, you link to the category.

Content

Below the introduction is the main content space. The bulk of the log article can be formatted however the editor prefers. Editors can use headers to break up the length of the log and to create a Table of Contents. Please remember that all headers on wiki pages should start with the level two header, which means they start with two equal signs on either side of the header. Example: ==Summary==. Another example would be: ===Blood Son Gets Bloody===. These headers can also be used to create links to direct people to content. For example: https://gswiki.play.net/Blood_Son_(storyline)/2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log)#Blood_Son_Gets_Bloody would take you directly to that section of the log.

People may want to add additional headers so that their log has a summary, notes characters in attendance or their appearance, or some other valuable or interesting information. An example could look like:

==Summary==
In this log, the Blood Son proselytized to his followers and suggested that there would be some Big Bad Event happening later in the week.
==Characters in Attendance==
List of characters linked to their pages using the formatting shown in Help:Character_pages.
==Log==
===The Blood Son Proselytized===
<pre{{log2|border=none|font=arial}}>PASTE LOG HERE</pre>
===The Blood Son Gets Bloody===
<pre{{log2|border=none|font=arial}}>PASTE LOG HERE</pre>

While not required, using the log2 template provides consistency to readers that what they're reading inside of that visual block is text that came directly from the game. It also eliminates the need for people to place line break (<br/>) tags at the end of single-spaced game text such as room descriptions or character descriptions as the template will automatically ensure that it is formatted correctly.

Categories

Log pages should have the following categories placed at the bottom of the page:

  • [[Category:Logs]]
  • Storyline, OOC meetings, or event category, if applicable, such as: [[Category:Blood Son]], [[Category:OOC meetings]], or [[Category:Mist Harbor Library Lectures]].

Storyline logs should not be categorized into the town storylines or dated storylines categories. Instead, the storyline category page itself should be placed into both of those. So for example, a log from the Blood Sons storyline would not be in Category:Wehnimer's Landing storylines or Category:2020 storylines. Instead, Category:Blood Son will be placed into both of those. This cuts down on clutter inside of the town storylines and dated storylines categories so that people can easily find the storyline they want without having to wade through pages of logs.

Example, All Together

The article title for this example would be: https://gswiki.play.net/Blood_Son_(storyline)/2020-01-01_-_Excitement_in_Wehnimer's_Landing_(log)

The formatting of the log for this example could look like:

This log is from the Blood Son storyline on 01/01/2020 from the viewpoint of Motte.
==Summary==
In this log, the Blood Son proselytized to his followers and suggested that there would be some Big Bad Event happening later in the week.
==Characters in Attendance==
List of characters linked to their pages using the formatting shown in Help:Character_pages.
==Log==
===The Blood Son Proselytized===
<pre{{log2|border=none|font=arial}}>PASTE LOG HERE</pre>
===The Blood Son Gets Bloody===
<pre{{log2|border=none|font=arial}}>PASTE LOG HERE</pre>
[[Category:Logs]]
[[Category:Blood Son]]

See Also

Questions?

If you have any questions, please leave them on the discussion/talk page.