Jump to content

Project:Style Manual: Difference between revisions

From Kanzenshuu Dragon Ball Wiki
SaiyaJedi (talk | contribs)
Hujio (talk | contribs)
Standard Writing Practices: Added Daima references
 
(43 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This is an instruction manual that addresses the conventions adopted by ''Kanzenshuu'' in writing, titles, pages, images, and linking. Please read it before you contribute to the wiki. Note, however, that this document may not updated frequently, so it is also recommended users survey prevailing conventions in addition to reading these guidelines.
This is an instruction manual that addresses the conventions adopted by ''Kanzenshuu'' in writing, titles, pages, images, and linking. Please read it before you contribute to the wiki. Note, however, that this document may not be updated frequently, so it is also recommended users survey prevailing conventions in addition to reading these guidelines.


==Writing Style==
==Writing Style==
Line 7: Line 7:
The main goal of all writing on the wiki is to present as much accurate information as possible within the smallest space possible. Conciseness is one of our most guiding principles. This has an immediate advantage when trying to create an information database covering such a large subject. Of course, any fan-made wiki is going to be read primarily by those already fairly familiar with the series, but it stands to reason that pages should be organized to be as friendly to newcomers as possible.
The main goal of all writing on the wiki is to present as much accurate information as possible within the smallest space possible. Conciseness is one of our most guiding principles. This has an immediate advantage when trying to create an information database covering such a large subject. Of course, any fan-made wiki is going to be read primarily by those already fairly familiar with the series, but it stands to reason that pages should be organized to be as friendly to newcomers as possible.


Rather than creating a long-winded article detailing every last little thing [[Son Goku]] ever did over the course of the series, we're aiming to simply have a few paragraphs summarizing Goku's life as concisely as possible. For example, imagine if someone who had never heard of ''Dragon Ball'' had just 5 to 10 minutes to learn about Goku, and at the end of that time they'd be tested on the major facts of his life. How can we structure our page on Goku so that this hypothetical person could learn as much about the character as possible in that brief amount of time?
Rather than creating a long-winded article detailing every last little thing [[Son Goku]] ever did over the course of the series, we're aiming to simply have a few paragraphs summarizing Goku's life as concisely as possible. For example, imagine if someone who had never heard of ''Dragon Ball'' had just 5 to 10 minutes to learn about Goku, and at the end of that time they'd be tested on the major facts of his life. Think of how we can structure our page on Goku so that this hypothetical person could learn as much about the character as possible in that brief amount of time.


===Professionalism===
===Professionalism===
 
Users are not only expected to behave and conduct themselves in a respectable manner on ''Kanzenshuu'', but they are also expected to bring a professionalism to their writing on the wiki. Use words that are appropriate to the article and keep the language simple. Slang, profanity, obscenities, and euphemistic terms should be avoided at all costs, unless in the context of a quote. Not only are these terms unprofessional, they may also be difficult for non-native English readers to understand.


===Non-Opinionated===
===Non-Opinionated===
In addition to our information being concise and accurate, it should also be factually based. Just as dictionaries and encyclopedias are used to determine facts, the same will be so with the wiki. Opinionated and non-factual writing will not be tolerated. In order to avoid disagreements over factual accuracy, it is best to cite sources for controversial statements.
In addition to information being concise and accurate, it should also be factually based. Just as dictionaries and encyclopedias are used to determine facts, the same will be so with the wiki. Opinionated and non-factual writing will not be tolerated. In order to avoid disagreements over factual accuracy, it is best to cite sources for controversial statements.


===Cite Sources===
===Cite Sources===
{{see|Project:Style Manual/Sources|:Category:Citation Templates}}
As with any intellectually recognized publication, information sources should be cited when possible. This will allow other users to easily double-check content and increases the reader's confidence in the information provided.
===Standard Writing Practices===
The following is a list of standard writing practices that users are expected to follow on the ''Kanzenshuu'' wiki:
* Numbers under and through ten written as words; 11 and above as their actual numbers (numbers written in names or publication titles are the only exception).
* Date Month Year (ex: '''01 January 2222''', with zeroes to take up the two numerical spaces); should be '''bold'''.
* The titles of works should be ''italicized''; website names and publications should also be placed in ''italics'' (ex: The latest issue of ''V-Jump'' showcases new ''Dragon Ball'' screen shots); articles thereof in quotation marks.
* ''Dragon Ball'', ''Dragon Ball Z'', ''Dragon Ball GT'', ''Dragon Ball Kai'', ''Dragon Ball Super'', and ''Dragon Ball Daima'' should be ''italicized'' and written out fully when at all possible; acronyms and abbreviations (DB, DBZ, DBGT, etc.) should be avoided (Z, GT, Kai, Super, and Daima short hands are acceptable).


==Grammar==
==Grammar==
Users are expected to adhere to recognized standards of written English usage. Non-native English speakers and those unused to formal writing are still welcome to contribute; however, they may find their contributions subsequently altered to bring them in line with the standards expected of the ''Kanzenshuu'' Wiki.
Users are expected to adhere to recognized standards of written English usage. Non-native English speakers and those unused to formal writing are still welcome to contribute; however, they may find their contributions subsequently altered to bring them in line with the standards expected of the wiki.
 
We at ''Kanzenshuu'' welcome contributions from around the world, and have no preference with respect to U.S. or U.K. spellings or usage. We ''do'' ask, however, that a given article be consistent with itself, and that users try to avoid colloquialisms that might confuse speakers of other dialects.
 
===Standard Grammatical Practices===
The following is a list of standard grammatical practices that users are expected to follow on the ''Kanzenshuu'' wiki:


We at ''Kanzenshuu'' welcome contributions from around the world, and have no preference with respect to U.S. or U.K. spellings or usage, but we do ask that a given article be consistent with itself, and that users try to avoid colloquialisms that may confuse speakers of other dialects.
* Contractions should ''not'' be used (i.e. "should not" instead of "shouldn't").
* Keep the tenses of pages/sections consistent. Generally speaking, discussion of past events in the real world is in the past tense, while discussion of characters and events in-universe is in the present tense.
* Use proper capitalization rules for titles where appropriate. This includes items such as, Chapter, Episode, and Movie titles, song titles, and section headings.
* When referring to a specific episode, capitalize the word "Episode." Due to the fact that page names are "Episode #" instead of the episode's true name, this makes the word "episode" part of the title, and therefore it should be capitalized. This applies to Chapters and Movies as well.


==Naming Conventions==
==Naming Conventions==
Names of characters, locations, and techniques, as well as titles of manga chapters, TV episodes, and theatrical films, will should use ''Kanzenshuu''’s house style. In many instances, names used by ''Kanzenshuu'' deviate from official adaptations, so please check against it for reference. In an article where said item is the main focus, the naming in Japanese must always be given, both in Japanese script and romanization (see below). Names used in official adaptations may be mentioned when relevant to the subject of the article, but are not the focus of ''Kanzenshuu'' and should not be relied upon out of convenience.
Names of characters, locations, and techniques, as well as titles of manga chapters, TV episodes, and theatrical films, should use ''Kanzenshuu''<nowiki>'</nowiki>s house style. In many instances, names used by ''Kanzenshuu'' deviate from official adaptations, so please check against it for reference. In an article where said item is the main focus, the naming in Japanese must always be given, both in Japanese script and romanization (see below). Names used in official adaptations may be mentioned when relevant to the subject of the article, but are not the focus of ''Kanzenshuu'' and should not be relied upon out of convenience.


==Japanese Names & Titles==
==Japanese Names & Titles==
 
When applicable, all Japanese names and titles should be provided in native Japanese text, including [http://en.wikipedia.org/wiki/Kanji kanji], [http://en.wikipedia.org/wiki/Katakana katakana], or [http://en.wikipedia.org/wiki/Hiragana hiragana]. Japanese text should not be provided in the form of an image, but written with actual Japanese unicode characters. Japanese names will be written in their Western order (given-name family-name) and all retained honorifics (''sama'', ''san'', ''kun'', etc.) will be ''italicized''.


===Romanization===
===Romanization===
Romanization of Japanese words is expected to follow [http://en.wikipedia.org/wiki/Hepburn_romanization Modified Hepburn] romanization. As Hepburn is the most widely used romanization of Japanese, users are likely to be already familiar with its basic form. However, note the following:
Romanization of Japanese words is expected to follow [http://en.wikipedia.org/wiki/Hepburn_romanization Modified Hepburn] romanization and be ''italicized'' in running text. As Hepburn is the most widely used romanization of Japanese, users are likely to be already familiar with its basic form. However, note the following:
* ''shi'', ''chi'', or ''ji'' followed by small ''ya'', ''yu'' or ''yo'' contains no "y": ''Shū'', ''Chaozu'', ''Janken'', etc.
* し (''shi''), ち (''chi''), or じ (''ji'') followed by small ゃ (''ya''), ゅ (''yu''), or ょ (''yo'') contains no "y": ''Shū'', ''Chaozu'', ''Janken'', etc.
* The ''-u'' syllable in the ''d''-row should be written ''zu'' (not ''du'' or ''dzu''): ''Tsuzuku''
* The ''-u'' syllable in the ''d''-row should be written ''zu'' (not ''du'' or ''dzu''): ''Tsuzuku''
* Long vowels should be written with a macron (''ā, ī, ū, ē, ō''), '''except''' in the following circumstances:
* Long vowels should be written with a [http://en.wikipedia.org/wiki/Macron macron] (''ā, ī, ū, ē, ō''), '''except''' in the following circumstances:
** for long "i" in a native Japanese word, two ''i''’s should be used: ''Shōzō Iizuka'', ''Niigata''
** for long "i" in a native Japanese word, two ''i''<nowiki>'</nowiki>s should be used: ''Shōzō Iizuka'', ''Niigata''
** when two vowels in a proper name belong to separate syllables, they should be written separately and also separated by an apostrophe, to aid in syllabification: ''Chiho Kiyo'oka'', ''Ja'akuryū'', ''Kinto'un''
** in verbs and adjectives where a long vowel is divided between the stem and a morphological suffix, they should be written separately: ''tsudou'', ''atarashii''
** in native Japanese common nouns derived from phrases, apostrophes are not necessary: ''mizūmi'' ("lake"; not ''mizu'umi'' or ''mizu-umi'', "freshwater sea"), ''honō'' ("flame"; not ''hono'o'' or ''ho-no-o'', "tail of fire").
** when two repeating vowels (as well as the combination ''ou'') in a proper name belong to separate semantic units, they should be written separately and also separated by an apostrophe, to aid in syllabification: ''Chiho Kiyo'oka'', ''Ja'akuryū'', ''Kinto'un''
** in native Japanese common nouns derived from phrases, apostrophes are not necessary: ''mizūmi'' ("lake"; not ''mizu'umi'' or ''mizu-umi'', "freshwater sea"), ''honō'' ("flame"; not ''hono'o'' or ''ho-no-o'', "frond of fire").
* Other vowel combinations may be written normally, but apostrophes should be applied, as above, where there would otherwise be ambiguity in syllabification: ''Tenka'ichi Budōkai'' (''Ten-ka-ichi'', not ''ten-kai-chi'')
* Other vowel combinations may be written normally, but apostrophes should be applied, as above, where there would otherwise be ambiguity in syllabification: ''Tenka'ichi Budōkai'' (''Ten-ka-ichi'', not ''ten-kai-chi'')
* An independent vowel or a syllable starting with ''n'' that follows a nasal ''n'' should be separated from it by an apostrophe: ''Zen’ō'', ''Kame-Sen'nin''
* Obvious phrases of distinct native-Japanese words that nevertheless form a semantic unit may be separated by hyphens.
* Obvious phrases of distinct native-Japanese words that nevertheless form a semantic unit may be separated by hyphens.
* Nasal ''n'' before ''b'' or ''p'' should remain as ''n'' in direct romanization (although the ''Kanzenshuu'' spelling, distinct from pure romanization, may use ''m'' as the curators see fit)
* Nasal ''n'' before ''b'' or ''p'' should remain as ''n'' in direct romanization (although the ''Kanzenshuu'' spelling, distinct from pure romanization, may use ''m'' as the curators see fit)
* Hiragana を should be customarily written as ''o''; hiragana は and へ should be written as ''ha'' and ''he'' as part of words, but as ''wa'' and ''e'' when functioning as grammatical particles.
* Compound particles should be given a space in between their elements. では ''de wa'' (not ''dewa''), にも ''ni mo'' (not ''nimo''), でも ''de mo'' (not ''demo'')


Anything else?
==Page Layouts==
The following are a list of layouts used for pages:
* [[Project:Style Manual/Age Page Layout|Age Page Layout]]
* [[Project:Style Manual/Book Page Layout|Book Page Layout]]
* [[Project:Style Manual/Cast & Staff Page Layout|Cast & Staff Page Layout]]
* [[Project:Style Manual/Chapter Page Layout|Chapter Page Layout]]
* [[Project:Style Manual/Character Page Layout|Character Page Layout]]
* [[Project:Style Manual/Company Page Layout|Company Page Layout]]
* [[Project:Style Manual/Episode Page Layout|Episode Page Layout]]
* [[Project:Style Manual/Feature Page Layout|Feature Page Layout]]
* [[Project:Style Manual/Game Page Layout|Game Page Layout]]
* [[Project:Style Manual/Item Page Layout|Item Page Layout]]
* [[Project:Style Manual/Location Page Layout|Location Page Layout]]
* [[Project:Style Manual/Movie Page Layout|Movie Page Layout]]
* [[Project:Style Manual/Music Page Layout|Music Page Layout]]
* [[Project:Style Manual/Technique Page Layout|Technique Page Layout]]


==Page Layouts==
These page layouts are a brief guide covering the expectations of how a page should be properly set up. Every effort should be made to maintain consistency between related pages, but common sense should be used when variations are implemented. It is standard policy, for both pages and information boxes, to not include headers for subjects where no content is available.


==Image Preferences==
==Image Preferences==
{{main|Project:Style Manual/Images}}
{{main|Project:Style Manual/Images}}
{{Kanzenshuu guidelines}}

Latest revision as of 15:37, 12 March 2026

This is an instruction manual that addresses the conventions adopted by Kanzenshuu in writing, titles, pages, images, and linking. Please read it before you contribute to the wiki. Note, however, that this document may not be updated frequently, so it is also recommended users survey prevailing conventions in addition to reading these guidelines.

Writing Style

The staff have compiled the following writing style goals and principles to help guide users in the development of the wiki. These goals will provide the foundation for what we hope will become the most accurate and reliable database of information for the Dragon Ball franchise.

Brevity

The main goal of all writing on the wiki is to present as much accurate information as possible within the smallest space possible. Conciseness is one of our most guiding principles. This has an immediate advantage when trying to create an information database covering such a large subject. Of course, any fan-made wiki is going to be read primarily by those already fairly familiar with the series, but it stands to reason that pages should be organized to be as friendly to newcomers as possible.

Rather than creating a long-winded article detailing every last little thing Son Goku ever did over the course of the series, we're aiming to simply have a few paragraphs summarizing Goku's life as concisely as possible. For example, imagine if someone who had never heard of Dragon Ball had just 5 to 10 minutes to learn about Goku, and at the end of that time they'd be tested on the major facts of his life. Think of how we can structure our page on Goku so that this hypothetical person could learn as much about the character as possible in that brief amount of time.

Professionalism

Users are not only expected to behave and conduct themselves in a respectable manner on Kanzenshuu, but they are also expected to bring a professionalism to their writing on the wiki. Use words that are appropriate to the article and keep the language simple. Slang, profanity, obscenities, and euphemistic terms should be avoided at all costs, unless in the context of a quote. Not only are these terms unprofessional, they may also be difficult for non-native English readers to understand.

Non-Opinionated

In addition to information being concise and accurate, it should also be factually based. Just as dictionaries and encyclopedias are used to determine facts, the same will be so with the wiki. Opinionated and non-factual writing will not be tolerated. In order to avoid disagreements over factual accuracy, it is best to cite sources for controversial statements.

Cite Sources

As with any intellectually recognized publication, information sources should be cited when possible. This will allow other users to easily double-check content and increases the reader's confidence in the information provided.

Standard Writing Practices

The following is a list of standard writing practices that users are expected to follow on the Kanzenshuu wiki:

  • Numbers under and through ten written as words; 11 and above as their actual numbers (numbers written in names or publication titles are the only exception).
  • Date Month Year (ex: 01 January 2222, with zeroes to take up the two numerical spaces); should be bold.
  • The titles of works should be italicized; website names and publications should also be placed in italics (ex: The latest issue of V-Jump showcases new Dragon Ball screen shots); articles thereof in quotation marks.
  • Dragon Ball, Dragon Ball Z, Dragon Ball GT, Dragon Ball Kai, Dragon Ball Super, and Dragon Ball Daima should be italicized and written out fully when at all possible; acronyms and abbreviations (DB, DBZ, DBGT, etc.) should be avoided (Z, GT, Kai, Super, and Daima short hands are acceptable).

Grammar

Users are expected to adhere to recognized standards of written English usage. Non-native English speakers and those unused to formal writing are still welcome to contribute; however, they may find their contributions subsequently altered to bring them in line with the standards expected of the wiki.

We at Kanzenshuu welcome contributions from around the world, and have no preference with respect to U.S. or U.K. spellings or usage. We do ask, however, that a given article be consistent with itself, and that users try to avoid colloquialisms that might confuse speakers of other dialects.

Standard Grammatical Practices

The following is a list of standard grammatical practices that users are expected to follow on the Kanzenshuu wiki:

  • Contractions should not be used (i.e. "should not" instead of "shouldn't").
  • Keep the tenses of pages/sections consistent. Generally speaking, discussion of past events in the real world is in the past tense, while discussion of characters and events in-universe is in the present tense.
  • Use proper capitalization rules for titles where appropriate. This includes items such as, Chapter, Episode, and Movie titles, song titles, and section headings.
  • When referring to a specific episode, capitalize the word "Episode." Due to the fact that page names are "Episode #" instead of the episode's true name, this makes the word "episode" part of the title, and therefore it should be capitalized. This applies to Chapters and Movies as well.

Naming Conventions

Names of characters, locations, and techniques, as well as titles of manga chapters, TV episodes, and theatrical films, should use Kanzenshuu's house style. In many instances, names used by Kanzenshuu deviate from official adaptations, so please check against it for reference. In an article where said item is the main focus, the naming in Japanese must always be given, both in Japanese script and romanization (see below). Names used in official adaptations may be mentioned when relevant to the subject of the article, but are not the focus of Kanzenshuu and should not be relied upon out of convenience.

Japanese Names & Titles

When applicable, all Japanese names and titles should be provided in native Japanese text, including kanji, katakana, or hiragana. Japanese text should not be provided in the form of an image, but written with actual Japanese unicode characters. Japanese names will be written in their Western order (given-name family-name) and all retained honorifics (sama, san, kun, etc.) will be italicized.

Romanization

Romanization of Japanese words is expected to follow Modified Hepburn romanization and be italicized in running text. As Hepburn is the most widely used romanization of Japanese, users are likely to be already familiar with its basic form. However, note the following:

  • し (shi), ち (chi), or じ (ji) followed by small ゃ (ya), ゅ (yu), or ょ (yo) contains no "y": Shū, Chaozu, Janken, etc.
  • The -u syllable in the d-row should be written zu (not du or dzu): Tsuzuku
  • Long vowels should be written with a macron (ā, ī, ū, ē, ō), except in the following circumstances:
    • for long "i" in a native Japanese word, two i's should be used: Shōzō Iizuka, Niigata
    • in verbs and adjectives where a long vowel is divided between the stem and a morphological suffix, they should be written separately: tsudou, atarashii
    • when two repeating vowels (as well as the combination ou) in a proper name belong to separate semantic units, they should be written separately and also separated by an apostrophe, to aid in syllabification: Chiho Kiyo'oka, Ja'akuryū, Kinto'un
    • in native Japanese common nouns derived from phrases, apostrophes are not necessary: mizūmi ("lake"; not mizu'umi or mizu-umi, "freshwater sea"), honō ("flame"; not hono'o or ho-no-o, "frond of fire").
  • Other vowel combinations may be written normally, but apostrophes should be applied, as above, where there would otherwise be ambiguity in syllabification: Tenka'ichi Budōkai (Ten-ka-ichi, not ten-kai-chi)
  • An independent vowel or a syllable starting with n that follows a nasal n should be separated from it by an apostrophe: Zen’ō, Kame-Sen'nin
  • Obvious phrases of distinct native-Japanese words that nevertheless form a semantic unit may be separated by hyphens.
  • Nasal n before b or p should remain as n in direct romanization (although the Kanzenshuu spelling, distinct from pure romanization, may use m as the curators see fit)
  • Hiragana を should be customarily written as o; hiragana は and へ should be written as ha and he as part of words, but as wa and e when functioning as grammatical particles.
  • Compound particles should be given a space in between their elements. では de wa (not dewa), にも ni mo (not nimo), でも de mo (not demo)

Page Layouts

The following are a list of layouts used for pages:

These page layouts are a brief guide covering the expectations of how a page should be properly set up. Every effort should be made to maintain consistency between related pages, but common sense should be used when variations are implemented. It is standard policy, for both pages and information boxes, to not include headers for subjects where no content is available.

Image Preferences