×
Create a new article
Write your page title here:
We currently have 3,174 articles on YumeWiki. Type your article name above or click on one of the titles below and start writing!



YumeWiki
3,174Articles
in:

User:Selva/Sandbox: Difference between revisions

No edit summary
No edit summary
Line 234: Line 234:
In general, ''do '''not''''' state opinions or contested assertions as facts, or facts as opinions.
In general, ''do '''not''''' state opinions or contested assertions as facts, or facts as opinions.


=== 3.2 Slang ===
=== 3.2 Professionalism ===
''Do '''not''''' use slang, memes, or other informal language in article bodies. The words "kinda", "ain't", "sorta", etc. should not appear in articles. In other words, the same linguistic standards that apply to writing a professional email or academic essay apply here as well.


=== 3.3 Humor ===
==== 3.2.1 Slang ====
''Do '''not''''' use slang, memes, or other informal language in article bodies. The words "kinda", "ain't", "sorta", etc. should '''''not''''' appear in articles. ''Do '''not''''' use obscenities or profanity unless its inclusion is absolutely necessary in an article.
 
In other words, the same linguistic standards that apply to writing a professional email or academic essay apply here as well.
 
==== 3.2.2 Humor ====
Contain any jokes to the captions on images. ''Do'' '''''not''''' write jokes into the body of an article for any reason. This includes the use of editorial irony, dry humor, and Internet memes.  
Contain any jokes to the captions on images. ''Do'' '''''not''''' write jokes into the body of an article for any reason. This includes the use of editorial irony, dry humor, and Internet memes.  


Captions on images should be in good taste and should not denigrate the subject for any reason. If useful information can be provided in a caption (such as labeling a map connection), skip the joke and provide information instead. Captions may be removed by moderators for any reason.
Captions on images should be in good taste and should '''''not''''' belittle the subject for any reason. If useful information can be provided in a caption (such as labeling a map connection), skip the joke and provide information instead.  
 
Captions may be removed by moderators for any reason.
 
=== 3.3 Clarity ===
Write using clear, plain, concise language. Choose vocabulary and phrases that can be understood by a broad general audience familiar with English. Be ''specific and precise'' in your descriptions, but ''avoid'' bloating descriptions with flowery language or unnecessary detail. '''The purpose of the wiki is communication.'''
 
In general, ''avoid'' the following:
 
* Clichés and idioms. For example, "bear fruit", "elephant in the room", "by any stretch of the imagination", and phrases like these are at once vague, overused, and possibly confusing to speakers of English as a second language.
* Euphemisms, such as "passed away" or "croaked". These pose the same issues as idioms.
* Relative time references, such as "recently", "not long ago", or "soon". These are both imprecise and lose their meaning as time passes from the time of writing.
* Neologisms, unless they're directly related to terminology used in-game.
* Jargon and technical terminology where a simple description will do.
* Flowery, poetic descriptions using words mainly found in literary fiction, or worse, have gone extinct entirely.
* Excessively detailed descriptions of characters or objects, especially if there is a picture on the page of the thing being described.
* Using easily confused words incorrectly, such as using "exaggerate" to mean "exacerbate", or "infer" to mean "imply". There are a number of lists available online clarifying these terms. When in doubt, consult the dictionary or rewrite.
* Long sentences with multiple subclauses or heavily nested descriptions. These are often difficult to parse even for native English speakers. If you're not sure if a sentence is easy to understand, try reading it out loud. If it sounds awkward or you need to keep pausing to catch your breath, it probably needs to be rewritten.
* Any of the numerous and unnecessary synonyms for "said".
 
Group ideas together in paragraphs. Sentences within paragraphs should logically flow together.
 
If events occur in sequence, describe them in chronological order. For example, "If Madotsuki attacks Toriningen with the Knife effect, they will become hostile and chase her." is a better sentence than "Toriningen become hostile and chase Madotsuki if she attacks them with the Knife effect.", because the first sentence describes events in chronological order.
 
=== 3.4 Precision ===
Be specific in your descriptions, especially for descriptions involving player actions or unlock conditions. ''Avoid'' being vague.
 
Precise figures for time are preferable to "a while", "some time", "a long time", etc.
 
Similarly, precision when describing random chance is preferable to "sometimes", "rarely", "occasionally", etc. If it is known ''when'' a random variable is generated (for example, upon entering a room, upon interacting with an object, upon going to sleep, every second the protagonist remains in a location, etc.), include this information as well.
 
For example, instead of writing "By waiting a long time, the map's event will begin.", write "By waiting in the exterior without leaving for six uninterrupted minutes, the Figure in the Flames event will begin."
 
=== 4.5 Directness ===
Be direct in your language. Avoid unnecessary clauses or qualifiers wherever possible.
 
''Do'' '''''not''''' use qualifiers like "seemingly", "appears to be...", "could possibly be...", etc., unless it is ''genuinely uncertain'' what the object being described is. For example, ''do '''not''''' write "The room has what appears to be two beds and some sort of table." if the furniture in the room is obviously two beds and a table, even if those objects are strange or otherworldly in appearance (for example, being a strange color or made out of an unusual material, etc.).
 
''Do '''not''''' use the medium of the player's or the protagonist's senses for description, such as by writing "the player can see that...", "...is visible", "will hear the sound of...", etc. Write the description directly. For example, write "This room contains two NPCs.", ''not'' "The player will see two NPCs after entering the room." or "There are two NPCs visible in the room."


==4. Links==
==4. Links==

Revision as of 03:03, 21 February 2025

Style Guide Draft

BEGIN QUOTED TEXT:

The Style Guide is the descriptive standard for Yume Wiki's style and formatting conventions to ensure users edit consistently.

If you have questions, concerns, or suggestions about these guidelines, please use the talk page.

Although following the guide is highly encouraged, most (but not all) questions of style are usually left "to the discretion of the editor," as long as it is consistent within an article.

1. Spelling and Typography

1.1 General Guidelines

In order to maintain minimum quality standards, we expect articles published on Yume Wiki [something about how the articles need to represent "good English". We don't want people throwing up articles that need extensive copyediting. You'd think this should go without saying, but...]

1.2 Variations in Standard English

It is up to your discretion whether to use American, British, or other English spelling, grammatical, or mechanical conventions. This guideline includes mechanical variations such as the Oxford comma. Do not edit articles to exchange one variety of English for another.

Keep spelling, grammatical, and mechanical conventions consistent across an article. For example, do not mix British and American spellings within the same article.

Where possible, use vocabulary common to all varieties of English over regional vocabulary. For example, use "200,000" over "two lakh" (Indian English).

If there are multiple possible acceptable ways to spell a word, use the most common spelling. For example, while "coöperate" is technically a valid spelling, it is archaic and is almost obsolete. Use "cooperate" instead.

Avoid slang, unless related to general gaming, RPG Maker, or Yume Nikki Fangames.

1.3 Capitalization

1.3.1 The

Do not capitalize "the" midsentence, unless it is part of a title of a work. For example, write "Minnatsuki can enter the Nexus.", not "Minnatsuki can enter The Nexus."

1.3.2 Emphasis

Do not use capitalization for emphasis. This includes the use of all-caps and initial capitalization. For example, do not write, "Effects CANNOT be used here."

1.3.x Effect Names

For effect names, capitalize the name of the effect, but not the word effect. For example, "Wolf effect".

If the name of the effect contains the word "and", do not capitalize "and". For example, "Hat and Scarf effect".

1.3.x Location Names

For location names, capitalize the name of the location in the same manner it is capitalized in the lead paragraph of its respective article. For example, capitalize RED DREAD DEATH in exactly this manner in all content pages referring to it.

1.4 Ligatures

If the word is from a language where the use of ligatures is standard (such as French), use ligatures. Otherwise, do not use ligatures. For example, write "aether", not "æther".

1.5 Abbreviations

Avoid using abbreviations wherever possible, unless the abbreviation is part of a proper name. For example, FC Fields. Common abbreviations such as "DNA", "CPU", "PDF", etc. are exempt from this rule.

If an abbreviation must be used, introduce it by writing out the entire expression followed by the abbreviation in parentheses. For example, "The RPGMaker 2003 run time package (RTP)". Do not capitalize each word of the initialism.

Do not use periods or any other punctuation in between the letters of initialisms. For example, "RTP", not "R.T.P.". Do not use apostrophes to form plurals.

Do not use abbreviations for Latin phrases, such as "i.e.", "e.g.", "viz.", and so on, unless they are used in the title of a work. For example, write out "versus" for "vs.", and "for example" for "e.g."

The exception is "etc.", short for et cetera, which may be used at the end of non-exhaustive lists. Do not spell this as "ect."

1.6 Ampersands (&)

Do not use ampersands unless they are part of a proper name.

1.7 Italics and Other Emphasis

1.7.1 Emphasis

When emphasizing text, use italics. Do not use bold, underline, or all-caps to emphasize. However, if the emphasis occurs in quoted text, retain the original emphasis.

Do not italicize punctuation surrounding emphasized text.

1.7.2 Frequency

Be careful not to overuse italics, as the effect diminishes over time.

Avoid italicizing large blocks of text, because it can be difficult to read.

1.7.3 Foreign words

If the foreign word is in a Latin script, italicize the foreign word. Otherwise, do not italicize the word. [example?]

1.7.4 Titles

When referring to the title of a work, italicize the name of the title, even if the text is written in non-Latin characters. For example, "Minnatsuki is the protagonist of Collective Unconscious."

1.8 Quotations

[Essentially describe the principle of minimal change here and say that many rules about style do not need to be applied to quotations, such as that of in-game text. This section might not be necessary, as very few fangames have text to quote in the first place.]

1.9 Punctuation

1.9.1 Spacing

Place a single space before the beginning of a new sentence, items in a list separated by commas, and after colons and semicolons.

For example, write "There are hats in different colors. The colors available are: red, green, blue, and yellow.", not "There are hats in different colors.The colors available are:red,green,blue,and yellow."

Do not place any spaces before any punctuation marks.

For example, write "The colors available are: red, green, blue, and yellow.", not "The colors available are : red , green , blue , and yellow ."

1.9.2 Apostrophes

Use straight apostrophes ('). Do not use curly apostrophes (’), backticks (`), or accent marks (´) as apostrophes.

If a foreign word or proper noun contains an apostrophe-like mark such as the ʻokina (ʻ), use the appropriate symbol and not an apostrophe.

1.9.3 Quotation marks

Use straight quotation marks (").

Do not use:

  • curly quotation marks (“” or ‘’)
  • low-high quotation marks („ “)
  • guillemets (« »)
  • square quotes (「」or 『』)
  • backticks (``)
  • accent marks (´)
  • or two apostrophes ('')

When quoting, prefer double quotes (") over single quotes (') to introduce a quote. Quotations within quotations should use single quotes (').

1.9.4 Brackets and parentheses

Avoid having sets of parentheses or square brackets right next to each other. [example]

If a sentence ends in closing parentheses or square brackets, it must end in a period outside the brackets, regardless of whether there is punctuation inside of the parentheses. For example, "(x, y, z, etc.)."

Ask yourself if the information is really parenthetical to the sentence, or if it can stand alone as its own sentence. If it is not, rewrite.

1.9.x Terminal punctuation

Avoid the use of exclamation points (!) and question marks (?) unless they are part of a proper noun or a quotation.

Do not use ellipses, unless they are part of a quotation, or to indicate that text has been omitted from a quotation.

Do not use inverted exclamation points or question marks.

1.9.x Commas

1.9.x Colons and semicolons

1.10 Numbers

Write out numbers from 0-20 as words, unless in a mathematical or statistical context, or when specifying an amount of currency. [move to own sections?] For example, "6" should usually be written as "six"; however, write "$20" and not "twenty dollars".

Write out numbers greater than 20 as numerals. For example, "one hundred and twenty-three" should always be written as "123". [What about large numbers than can be expressed in one or two words, such as four billion?]

For numbers with five or more digits, use a comma every three digits from the right. For example, write "2,313,879", not "2313879".

The cut off is generally between twenty and twenty-one, because hyphenated numbers are best written using numerals for ease of reading and spelling. The important thing is to be consistent in the article.

1.10.x Percentages

Use the percent sign (%) when indicating percentages, rather than writing out "percent" or "per cent". Do not put a space before the percent sign.

1.10.x Dates and time

1.10.x Version Numbers

[This needs an extensive rewrite, as this paragraph conveys almost no information.]

Refer to versions using the version number and letter, e.g. "0.100a" or "version 0.100a." Don't use ".100a," or "100a," or "ver0.100a" in articles. In the case of patches, write out the word patch then the number, e.g. "0.100a patch 3." If a wiki consistently uses a different format, stay consistent with the wiki and do not change all its pages to the format outlined here.

1.9 Romanization and Translation

When foreign text appears, provide a romanization (if applicable) and translation. If you lack the requisite language skills, contact an editor who has them for assistance.

If the Japanese text appears in the body of an article, enclose the romanization and translation in parentheses, separating them with a comma. Place translations after the romanization. For example, "ゆめにっき (Yume Nikki, Dream Diary)".

If a romanization appears in the body of an article, enclose the original Japanese text and translation in parentheses, separating them with a comma. Place translations after the original text. For example, "Yume Nikki (ゆめにっき, Dream Diary)".

1.9.1 Romanization

1.9.1.1 Standard

When providing a romanization, use the Revised Hepburn standard.

Notable features of the Revised Hepburn standard:

  • Long vowels are usually indicated by a macron over the lengthened vowel. For example, お弁当 is written as obentō. Note that いい is still usually written as ii and えい is written as ei. Vowels followed by a lengthening marker () always have a macron over them.
  • Repeating vowels across morpheme boundaries are left separate. For example, 邪悪 is romanized as jaaku.
  • Consonants that change sound before i or u are written phonetically. For example, ふ is romanized as fu, not hu. Similarly, じゃ is romanized as ja, not zya.
  • Long consonants are doubled. Note that っち is romanized as tchi, not cchi.
  • Moraic n (ん) is always written as n; it does not change to m before labial consonants. Only before vowels and や、ゆ、よ, an apostrophe is written after n. For example, 千円 romanizes as sen'en, and 案内 romanizes as annai.

Do not omit macrons where prescribed by the standard. For example, romanize 教室 as "Kyōshitsu", not "Kyoshitsu", "Kyoushitsu" or "Kyositu". For further details about the standard, see the linked Wikipedia article above.

1.9.1.2 Capitalization

If a phrase contains katakana, do not render the romanization of the katakana in all caps. For example, romanize タイル通路 as "Tairu Tsūro", not "TAIRU Tsūro".

When providing a romanization for a proper name, capitalize each word, unless that word is a suffix or a particle. Italicize the romanization. For example, romanize [example] as [example]

1.9.1.3 Loanwords and romāji

If the phrase contains a word in romāji, transcribe it exactly as it is written. For example, romanize FC世界 as "FC Sekai", not "Efu Shī Sekai", and 真っ白umi as "Masshiro umi", not "Masshiro Umi".

If a phrase contains a foreign loanword in katakana, transcribe it fully. For example, romanize ブロックの世界 as "Burokku no Sekai", not "Block no Sekai".

There is one exception to this. If the phrase is a title or other important proper name, you may romanize the loanword as its translation. For this exception, map locations are not considered important proper names. For example, ユメ‐グラフィティ may be romanized as "Yume Graffiti" rather than "Yume Gurafiti", because it is the title of a game.

1.9.2 Translation

When providing a translation, ensure it is accurate.

Do not use machine translation (such as Google Translate or DeepL) or large language models (such as ChatGPT or DeepSeek) to make translations for you, because they are prone to error and routinely fail to understand context. If you do not know the target language, please leave the translation work to someone who does.

Be careful when creating page titles based on translations. Do not create a page title or rename a page based on a translation unless you are absolutely sure it is correct.

2. Grammar and Usage

2.1 Pronouns

2.1.1 The first person

Do not use first person pronouns (I, we, our, etc.) to refer to the editor(s) or reader(s) of an article.

2.1.2 The second person

Avoid the use of the second-person pronoun "you" when referring to the player or reader(s) of an article.

Prefer the use of "one", "a person", or the passive voice when referring to "anyone" as a subject.

2.1.3 The third person

2.1.3.1 Gender

When referring to a person or character, use the pronouns that match their self-identification (or official sources in the case of a character). If the person or character is non-binary, use singular they.

If a person or character's gender identity is not known, use singular they.

2.1.3.2 Protagonist versus Player

For actions done by the game protagonist, use the name or the appropriate gendered pronouns (such as she/her). For example, in Yume Nikki, the protagonist falls asleep, not the player, so use "Madotsuki falls asleep."

For actions done by or to the player, use the phrase "the player", the passive mood, or second-person pronouns . For example, the player interacts with the menu, not the protagonist, so use "The player can open the menu." or "The menu can be opened."

In cases where either the player or the protagonist are valid actors in a sentence, use your discretion. Be consistent. For example, if a section states the protagonist interacted with an NPC, ensure all text in this section refers to the protagonist and does not suddenly switch to referring to the player.

2.2 Tense

By default, when referring to content that is currently available, use the present tense. For example, "The FC Worlds are a set of worlds that all feature simplified, NES/Famicom-styled graphics."

When referring to content that is no longer available or present, or when discussing something that no longer exists, use the past tense. For example, "The Droplets World was an area accessible from Character World."

2.3 Contractions

Where possible, avoid using contractions. For example, use "do not", instead of "don't", "it is" instead of "it's", and so on.

Contractions which are compulsory in the English language, such as "o'clock" and "'s" for possessives, are allowed.

3. Tone

3.1 Neutrality

Write articles using a neutral, unbiased tone. Avoid terms that are loaded, judgemental, or biased. For example, avoid calling a map or game "impressive", "ugly", "unpleasant", "innovative", "controversial", etc., or an author "talented", "skilled", "amateurish", "derivative", etc.

Similarly, avoid the use of emotional qualifiers about a subject such as "terrifying", "creepy", "relaxing", "frustrating", etc.

Avoid language that can be construed as expressing doubt (such as "so-called", "supposedly", "allegedly", "it is believed that...", or the use of scare quotes), especially about uncontested facts.

In general, do not state opinions or contested assertions as facts, or facts as opinions.

3.2 Professionalism

3.2.1 Slang

Do not use slang, memes, or other informal language in article bodies. The words "kinda", "ain't", "sorta", etc. should not appear in articles. Do not use obscenities or profanity unless its inclusion is absolutely necessary in an article.

In other words, the same linguistic standards that apply to writing a professional email or academic essay apply here as well.

3.2.2 Humor

Contain any jokes to the captions on images. Do not write jokes into the body of an article for any reason. This includes the use of editorial irony, dry humor, and Internet memes.

Captions on images should be in good taste and should not belittle the subject for any reason. If useful information can be provided in a caption (such as labeling a map connection), skip the joke and provide information instead.

Captions may be removed by moderators for any reason.

3.3 Clarity

Write using clear, plain, concise language. Choose vocabulary and phrases that can be understood by a broad general audience familiar with English. Be specific and precise in your descriptions, but avoid bloating descriptions with flowery language or unnecessary detail. The purpose of the wiki is communication.

In general, avoid the following:

  • Clichés and idioms. For example, "bear fruit", "elephant in the room", "by any stretch of the imagination", and phrases like these are at once vague, overused, and possibly confusing to speakers of English as a second language.
  • Euphemisms, such as "passed away" or "croaked". These pose the same issues as idioms.
  • Relative time references, such as "recently", "not long ago", or "soon". These are both imprecise and lose their meaning as time passes from the time of writing.
  • Neologisms, unless they're directly related to terminology used in-game.
  • Jargon and technical terminology where a simple description will do.
  • Flowery, poetic descriptions using words mainly found in literary fiction, or worse, have gone extinct entirely.
  • Excessively detailed descriptions of characters or objects, especially if there is a picture on the page of the thing being described.
  • Using easily confused words incorrectly, such as using "exaggerate" to mean "exacerbate", or "infer" to mean "imply". There are a number of lists available online clarifying these terms. When in doubt, consult the dictionary or rewrite.
  • Long sentences with multiple subclauses or heavily nested descriptions. These are often difficult to parse even for native English speakers. If you're not sure if a sentence is easy to understand, try reading it out loud. If it sounds awkward or you need to keep pausing to catch your breath, it probably needs to be rewritten.
  • Any of the numerous and unnecessary synonyms for "said".

Group ideas together in paragraphs. Sentences within paragraphs should logically flow together.

If events occur in sequence, describe them in chronological order. For example, "If Madotsuki attacks Toriningen with the Knife effect, they will become hostile and chase her." is a better sentence than "Toriningen become hostile and chase Madotsuki if she attacks them with the Knife effect.", because the first sentence describes events in chronological order.

3.4 Precision

Be specific in your descriptions, especially for descriptions involving player actions or unlock conditions. Avoid being vague.

Precise figures for time are preferable to "a while", "some time", "a long time", etc.

Similarly, precision when describing random chance is preferable to "sometimes", "rarely", "occasionally", etc. If it is known when a random variable is generated (for example, upon entering a room, upon interacting with an object, upon going to sleep, every second the protagonist remains in a location, etc.), include this information as well.

For example, instead of writing "By waiting a long time, the map's event will begin.", write "By waiting in the exterior without leaving for six uninterrupted minutes, the Figure in the Flames event will begin."

4.5 Directness

Be direct in your language. Avoid unnecessary clauses or qualifiers wherever possible.

Do not use qualifiers like "seemingly", "appears to be...", "could possibly be...", etc., unless it is genuinely uncertain what the object being described is. For example, do not write "The room has what appears to be two beds and some sort of table." if the furniture in the room is obviously two beds and a table, even if those objects are strange or otherworldly in appearance (for example, being a strange color or made out of an unusual material, etc.).

Do not use the medium of the player's or the protagonist's senses for description, such as by writing "the player can see that...", "...is visible", "will hear the sound of...", etc. Write the description directly. For example, write "This room contains two NPCs.", not "The player will see two NPCs after entering the room." or "There are two NPCs visible in the room."

4. Links

4.1 Internal Links

4.1.1 Frequency

When using internal links to other wiki pages in articles, only the first mention of the topic should be a link. Do not link to the same page multiple times within the same article.

Some exceptions to this rule apply:

  • Infoboxes should have links even if the link already exists in the article.
  • Locations listed in the "Directions" section of location pages should have links, except the first and last locations.
  • Image captions in galleries may repeat links, at the discretion of the editor.

4.1.2 Linking to Effects

When linking the names of effects, make the effect name a link, but not the word "effect" itself. For example, "Urotsuki can use the Chainsaw effect."

4.2 External Links

If possible, when linking to Wikipedia or other external wikis, use interwiki links. If an interwiki link is available, do not use a URL. Currently, the only interwiki link available is [[wikipedia:Example]].

If you wish to mimic the look of internal links when using external links, use <span class="plainlinks"> </span>.

5. Titles and Organization

[THIS SECTION REALLY NEEDS SOME HELP OH NO]

When creating a page on Yume Wiki, the name should represent the subject of the article.

It is good policy to check the names other people in the community are using, if any. For example, Yume 2kki locations may have names suggested in Version History or Map IDs. If no name has been adopted by the community, or declared officially by the author, the editor must invent a name for the wiki.

When naming a page, it should generally be based on its original (probably Japanese) name, which can be found in a few possible ways:

  1. Opening the game using its engine and checking the internal name of the map or event.
  2. Checking the name of the assets used, such as a map's ChipSet or a character's event CharSet.
  3. In a changelog file, if any (for Yume 2kki it is changelog.txt)

There are many exceptions to using the original name, such as it being too similar to another name (in which case it should be something else to avoid confusion), if the original name sounds awkward when translated into English, or if the name is generic or missing.

All articles should be named in title case, except when using official names. The editor who creates (or moves) the page should ideally mention the method used to (re)name it.

Never use special characters like & or ?; these are reserved URL parameter delimiters, and doing otherwise may break APIs (e.g. those used in external projects like Yume 2kki Explorer or YNOproject) making use of wiki content. Alternate names will need to be chosen. For example, the character page ***-tsuki uses that name instead of the more common ???-tsuki due to this limitation.

Grammatical Articles

Avoid naming a page using grammatical articles, such as the definite article "The", even if it appears to make sense grammatically: using it makes it harder to find, sort, and link to the page. For example, Yume 2kki:Spaceship is always referred to as "the Spaceship," but does not include "The" in the page name. There are some exceptions such as when the name is a title; see Wikipedia's guidance for further details, which may be applied to Yume Wiki.

Pages using official names are not expected to follow this guideline.

Yume 2kki page names may include grammatical articles due to either using an official name or because changing the name would cause issues in YNOproject's expedition feature. The community has agreed to avoid renaming these pages. Discussion may still be opened to rename, but it requires notifying the YNOproject developers in the official Discord server.

In cases where an article is included at the start of the page name, the {{DEFAULTSORT:}} function should be used.

The function should be placed at the end of the page, and if any categories are listed at the end, the function should be placed in the first line.

The following example is taken from the page of Yume 2kki's The Magic Nexus:

==Gallery==
<gallery>
…
</gallery>

{{DEFAULTSORT:Magic Nexus, The}}
[[Category:Yume 2kki In Development]]
[[Category:Open for Cross-Author Connections]]
[[Category:Yume 2kki Hub Worlds]]
[[Category:Yume 2kki Connecting Maps]]

Official Names

Page names may be changed according to the wishes of the content's author(s). Some wikis, such as Collective Unconscious Wiki, use official names in a majority of cases. For most content on Yume Wiki, it is not required to ask authors for permission to name things, although it is courteous to do so when possible.

Page names using official names are not expected to follow some of the preceding guidelines.

  • They may include the definite article "The" and should not be renamed to omit it. This is unlike pages named by users, which should mostly avoid using grammatical articles.
  • They may be in a different case than the normal title case, such as .flow's hole in girl using lowercase or Collective Unconscious' RED DREAD DEATH using uppercase.

The reason behind these exceptions is to preserve the author's intention completely.

Editors should mention that the name is officially requested by the author in the edit summary of the page creation (or page move).

Yume 2kki Page Naming

For Yume 2kki worlds, in the official Discord server, there is a naming process for locations that involves a suggestion phase and a voting phase. The idea of the naming process is to have a dedicated space for community members to discuss, suggest, and vote on world names.

After at least 24 hours have passed since the new content has been made available to download, a thread will be created for each location. In each thread, users can suggest names for the location. After at least 72 hours have passed since the thread has been created, a poll will be created for each location using all of the suggestions, limited to one suggestion per user. These polls last for 72 hours, with the winner being chosen as the name of the location. A tiebreaker poll will be held in case of tied results.

6. Location Pages

6.1 The Locationbox Template

Every location page must use the Locationbox template. This template presents the basic information of the location. The template is used heavily to supply information for APIs.

The only location pages that should not use the template are multi-page locations.

6.1.1 JapaneseName

This field is used to display a location's Japanese name in the Yume 2kki Explorer for Japanese-language users.

For Yume 2kki maps, you must fill in the JapaneseName field. Use exactly one value, which is the map's original name written in Japanese. Do not add multiple values to this field.

If the map's equivalent name is available on the JP wiki, use the name provided there.

If the map is counted as a sub-area on the JP wiki, include the parent area's name, separating the names with the full-width colon. Use the format "[Parent area name]:[Child area name]".

6.1.2 Name

If a map's original name is not the same as the name used on the wiki, provide the map's original name(s) in the Name field.

If the map's original name is already listed in the JapaneseName field, do not list it again in the Name field.

6.1.2.1 Romanizations and Translations of Names

If necessary, provide a romanization and/or translation of the map's original name, separating each item with a comma. For example, "Madotsuki no Heya, Madotsuki's Room".


Other games are permitted to include the original Japanese name in the Name field instead.

6.1.3 Connections

The Connections field (and RemovedConnections field) of the Locationbox template makes use of the Connection template for each connection. The parameters are explained in the template documentation. For a full guide, see Help:Connections.

6.1.4 BGM

The BGM field must use the BGM template.

The title of the BGM is usually the name used in the game files. The filename is instead the name of the uploaded audio file on the wiki. More information can be found on the template page.

BGM field syntax:

{{BGM|title = examplesong|filename = game_examplesong_100.ogg|label = Plays in a subarea|soundroom = 008C}}

For more details on naming and uploading files to Yume Wiki, see Section [section number, with link].

6.1.5 Authors and Contributing

The following guidelines apply to games with multiple authors, such as Collective Unconscious, Muma|Rope, Uneven Dream, and Yume 2kki.

6.1.5.1 Authors

[Define an "author"].

Always use the original capitalization of an author's name, but do not include any special characters that are usually omitted from page or category names.

6.1.5.2 Contributing

If an author has made additions to an existing map that isn't theirs, or has only implemented a map by proxy without actually "authoring" it, that author should be listed in the Contributing field.

6.2 Maps

Insert all world maps intended for use in navigation by using the LocationMap template.

See help on creating location maps for more advice.

6.2.1 Labels

Add labels to connections, points of interest, and important objects such as effects or notable NPCs.

Labels are usually white bubbles with black text.

Use a simple typeface like Arial, Century Gothic, Courier, Times New Roman, or Comic Sans. Do not use decorative, calligraphic, or otherwise hard-to-read typefaces, such as Jokerman, Mistral, Chiller, or Papyrus. Do not handwrite labels.

6.2.2 Internal Connections

6.2.3 Mazes and Navigation Instructions

For mazes, draw paths from the entrance(s) of the world to its major features like exits.

These policies are especially important for maps with many entrances, exits, and teleporters. Labels and paths should keep in mind accessibility concerns (for example, using only colors will make it hard to read for those who are colorblind).

6.2.4 Editing Maps

Although maps are ideally as accurate to the game as possible, readability takes priority. An unreadable map is useless.

You may edit the appearance of maps to make their content more clear. This includes:

  • Changing the background from the panorama to a solid color
  • Dimming bright panoramas
  • Dimming/hiding useless paths in mazes
  • Circling or otherwise highlighting notable content that is hard to see
  • Moving rooms around to better draw paths between them

6.2.5 Older Versions

Maps that are included for trivia or other purposes, such as maps of older versions, do not have the same policies as described above, and should not use the LocationMap template.

Examples of free image editing and digital painting software are GIMP and Medibang.

6.3 Directions

6.3.1 Priority

When listing the directions to an area, list the shortest possible path (in terms of worlds visited) that does not require any prerequisites (e.g. effects or unlockable shortcuts) first.

If there is a shorter path that has prerequisites to reaching it, it should be listed in addition, specifying what would be required to follow that path.

There may be even more alternate paths for worlds with multiple shortcuts that rely on different prerequisites to become available. If these exist, list them too.

If there are multiple paths tied for the shortest length, list them all.

Example:

Nexus → Location A → Location B → Location C → Location D → Location E

*With the <effectname> effect equipped:
Nexus → Location A → Location X → Location E

6.3.2 Formatting and Links

All world names in the "Directions" section must be links to the location pages, excluding the initial location (usually the Nexus) and the location the article is about. This applies even if a world name appears multiple times across the multiple paths.

Do not bold any location names in the section, with the exception of locations at the end of the path (Location E shown in the example, commonly seen on pages for Yume 2kki worlds).

6.4 Location Categories

The Locationbox template used in location pages automatically inserts the appropriate Locations category for that game, as well as inserting the primary author's category if one specified.

Locations that currently connect to the game's Nexus (or Nexus equivalent) should be categorized under the wiki's specific Nexus Worlds category.

Locations must be categorized under the wiki's specific In Development category if a future update to the world is confirmed.

Removed content of any kind should be under the wiki's specific Removed Content category.

Media

Images

Screenshots of games must be at least 640x480 in pixel size. Smaller screenshots should be replaced. Ideally the screenshot should be scaled to a multiple of the game resolution to avoid blur or artifacts, but this is a minor issue that is usually unnoticeable.

Audio

BGM tracks uploaded for use in Locationbox and soundtracks must be edited to meet the following requirements:

  • Speed (along with pitch) changed to match the one in-game
  • Converted to the .ogg file format
  • Extended to at least 1 minute (this is not needed for full-length tracks or those that do not loop)
  • No added fade in or fade out

It is preferred that BGM uploaded for other purposes such as trivia also follow these guidelines.

SFX should also be edited to match the speed in-game, unless the purpose is to show the original file for comparison.

Filenames

Image Filenames

Filenames of images should be descriptive in what they contain, but short enough to be convenient. Generic names such as connection2.png make the file hard to use and keep track of. Generally, try choosing a name for the file that is unlikely to be chosen for any other purpose. Abbreviating the game name or world names is a common way to make the name short but unique. Although there is no current rule on case, Title Case and lowercase see common usage.

Audio Filenames

All audio files uploaded to the wiki should use the following format:

[game name]_[original name]_[speed].ogg

For example:

Yume_Nikki_【FC】BGM_003_90.ogg
  • Yume Nikki is the game name as written on the wiki
  • 【FC】BGM_003 is the original name in the game files
  • 90 is the speed setting used in-game (meaning 90% speed)

If the speed is unchanged, the filename should still have _100 appended. Be aware that in MediaWiki, spaces and underscores are interchangeable.

It is not required to move any already uploaded file to fit this naming scheme, especially because any page using the file would need to be updated afterwards. However, you are free to do so.

Captions

While humorous captions on images can be acceptable, they should be avoided if useful information or descriptions can be given instead. YumeWiki strives to be informative and professional first and foremost, so practice good judgment in caption selection.

Animated Media

Exercise caution in including animated images and videos, especially those containing rapid flashes. It can distract or annoy readers, and is especially a problem for any readers with photosensitive epilepsy. Consider using the Photosensitive Epilepsy Analysis Tool (PEAT) to test if the animated content is safe for viewing given such conditions. An additional guide can be found here. It may be necessary to hide the flashing image under a collapsible section with a clear warning of the contents.

Galleries

Pictures in galleries should be present in the current version of the game or else moved to the "Trivia" section in accordance with Outdated or Unused Content.

Normal galleries are usually preferred over slideshows. The MultimediaViewer feature allows users to interact with the gallery as a slideshow, and is enabled by default, making slideshow style galleries redundant.

Media Categories

Currently, there is no site-wide standard for file categories. There is a suggested structure for images that has limited use in the Amillusion wiki, but this has not been formally adopted. For now, files are not expected to have any categories on their pages.

Outdated or Unused Content

Outdated or unused content should go in the "Trivia" section of the article if it may interest users, or else be removed completely. Images showcasing outdated content, such as old screenshots and maps, may be included in a subheading titled "Old Images" under "Trivia," separate from the main "Gallery." However, placing these images in the normal gallery is still accepted, and may be favourable if there are only a couple images.

If a location is removed, update the connections of that location to be removed connections. This includes updating the connections from other location pages to the removed one. In the article's introductory paragraph, note that the world is removed. There is also a VersionRemoved parameter in Locationbox that must be added.

In addition, if you are writing a page for a location that has already been removed (for example, the page Yume 2kki:Droplets World was written long after the world itself was removed), you should use past tense. Changing all the tenses from present to past in a location page that was removed later on is not an urgent matter, but does improve the article.