VRCWiki:Manual of Style/zh-hans: Difference between revisions

From VRChat Wiki
(Created page with "VRC维基:文本格式指南")
 
(Updating to match new version of source page)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<div lang="en" dir="ltr" class="mw-content-ltr">
<div class="mw-translate-fuzzy">
This Manual of Style (MoS or MOS) is a suggested style manual for the VRChat Wiki.
本篇《VRC 维基:文本格式指南》(以下简称:指南)是 VRChat 维基的投稿规范。
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
我们希望:
In general:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
* 所有贡献至 VRChat 维基的内容应当客观真实、准确可信;
* All content on the VRChat Wiki should be truthful and accurate.
* 投稿人应当使用简洁易懂、直截了当的书面风格撰写内容,并以上下文一致、便于阅读的排版组织文章;
* Contributors should write articles using straightforward, succinct, easily understood language and structure articles with consistent, reader-friendly layouts and formatting.
* 若您对 VRChat 维基百科的风格、布局或格式有任何疑问,欢迎联系咨询[https://wiki.vrchat.com/wiki/Special:ListUsers?username=&group=community-mod&wpsubmit=&wpFormIdentifier=mw-listusers-form&limit=50 社区管理员]
* If you have any questions about style, layout, or formatting the VRChat Wiki, contact one of the [https://wiki.vrchat.com/wiki/Special:ListUsers?username=&group=community-mod&wpsubmit=&wpFormIdentifier=mw-listusers-form&limit=50 Community Moderators] for help.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
关于文章文本格式,要求如下:
A few specific guidelines for style are detailed below:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<span id="Article_titles"></span>
=== Article titles ===
<div class="mw-translate-fuzzy">
=== 文章标题 ===
</div>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
文章标题应当是一个可辨识的名词,或对主题的描述,同时兼顾语气自然、文义准确、简洁,以及与相关文章用词一致等要求。
A title should be a recognizable name or description of the topic, balancing the criteria of being natural, sufficiently precise, concise, and consistent with those of related articles.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
若您希望贡献英文内容,请参考文章标题格式部分的要求,并注意以下几点:
For formatting guidance see the Article title format section, noting the following:
* 对于英文文章标题,应当使用首字母大写,其余文本遵循常规英文语句格式的大小写写法;
* Capitalize the initial letter, but otherwise follow sentence case. VRChat uses sentence case for sentences, article titles, section titles, table headers, image captions, list entries (in most cases), and entries in infoboxes and similar templates, among other things.
* 请勿使用冠词(例如 a、an 或 the)作为第一个单词,例如关于创作者经济的文章标题,应当考虑使用"VRChat Creator Economy"而不是"The VRChat Creator Economy",除非它本身就是名称或作品标题的一部分(例如:"The Black Cat", "The VRChat Times");
* Do not use articles (''a'', ''an'', or ''the'') as the first word ([[Special:MyLanguage/Creator Economy|VRChat Creator Economy]], not [[Special:MyLanguage/Creator economy|The VRChat Creator Economy]]), unless it is an inseparable part of a name ([[Special:MyLanguage/The Black Cat|The Black Cat]]) or title of a work (''The VRChat Times'').
* 推荐使用名词或名词短语来构建文章标题,例如:"Early life", 您不应当用诸如"in early life",因为后者更适合被用作较长的文章的子章节标题(非必须)。您也可以将名词或名词短语用于较长文章的章节标题,尤其是当文章本身由多个篇幅较短的事件(子章节)组合而成的时候,此做法有利于缓解文章结构导致的歧义问题;
* Normally use nouns or noun phrases: Early life, not In early life. Phrases such as In early life are acceptable (though not required) as section headings. They are also used frequently as part of longer article titles such as [[Special:MyLanguage/VRChat Events|VRChat Events]], especially when a shorter construction (Events) may have ambiguity issues.
* 最后一个字符不应当是标点符号,除非它们是特定名词的一部分(例如:《机器人梦见电子羊》、VRChat Inc.);
* The final character should not be punctuation unless it is an inseparable part of a name (such as ''Do Androids Dream of Electric Sheep?''), or an abbreviation (VRChat Inc.), or when a closing round bracket or quotation mark is required (''Fantastic Avatars (and where to find them)'').
* 文本中出现引号或斜杠时,请使用斜杠为同一标题添加一个重定向链接,避免使用“智能引号”(smart quotes),因为在大多数设备平台上,引号和斜杠更加易于输入,且可靠地被显示出来。
* Whenever quotation marks or apostrophes appear, add a redirect for the same title using apostrophes. Avoid use of curly quotes ("smart quotes") because straight quotation marks and apostrophes are easier to type and display reliably on most platforms.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
===Section headings===
==Section headings==
</div>
</div>


Line 74: Line 65:


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
=== English word choice and capitalization ===
== English word choice and capitalization ==
</div>
</div>


Line 82: Line 73:


<div lang="en" dir="ltr" class="mw-content-ltr">
<div lang="en" dir="ltr" class="mw-content-ltr">
* ''Quotations, titles of works (books, films, etc.)''' should be capitalized as given in the source (but see Typographic conformity, below);
* '''Quotations, titles of works (books, films, etc.)''' should be capitalized as given in the source (but see Typographic conformity, below);
* '''Proper names''' use the subject's own spelling and capitalization, e.g., "...joint project of VRChat Inc. and VRChat Community Labs..."; "International Avatar Federation"
* '''Proper names''' use the subject's own spelling and capitalization, e.g., "...joint project of VRChat Inc. and VRChat Community Labs..."; "International Avatar Federation"
* Generally, do not capitalize the word the in mid-sentence: throughout the United Kingdom, not throughout The United Kingdom.
* Generally, do not capitalize the word the in mid-sentence: throughout the United Kingdom, not throughout The United Kingdom.

Latest revision as of 21:25, 7 September 2024

本篇《VRC 维基:文本格式指南》(以下简称:指南)是 VRChat 维基的投稿规范。

我们希望:

  • 所有贡献至 VRChat 维基的内容应当客观真实、准确可信;
  • 投稿人应当使用简洁易懂、直截了当的书面风格撰写内容,并以上下文一致、便于阅读的排版组织文章;
  • 若您对 VRChat 维基百科的风格、布局或格式有任何疑问,欢迎联系咨询社区管理员

关于文章文本格式,要求如下:

文章标题

文章标题应当是一个可辨识的名词,或对主题的描述,同时兼顾语气自然、文义准确、简洁,以及与相关文章用词一致等要求。

若您希望贡献英文内容,请参考文章标题格式部分的要求,并注意以下几点:

  • 对于英文文章标题,应当使用首字母大写,其余文本遵循常规英文语句格式的大小写写法;
  • 请勿使用冠词(例如 a、an 或 the)作为第一个单词,例如关于创作者经济的文章标题,应当考虑使用"VRChat Creator Economy"而不是"The VRChat Creator Economy",除非它本身就是名称或作品标题的一部分(例如:"The Black Cat", "The VRChat Times");
  • 推荐使用名词或名词短语来构建文章标题,例如:"Early life", 您不应当用诸如"in early life",因为后者更适合被用作较长的文章的子章节标题(非必须)。您也可以将名词或名词短语用于较长文章的章节标题,尤其是当文章本身由多个篇幅较短的事件(子章节)组合而成的时候,此做法有利于缓解文章结构导致的歧义问题;
  • 最后一个字符不应当是标点符号,除非它们是特定名词的一部分(例如:《机器人梦见电子羊》、VRChat Inc.);
  • 文本中出现引号或斜杠时,请使用斜杠为同一标题添加一个重定向链接,避免使用“智能引号”(smart quotes),因为在大多数设备平台上,引号和斜杠更加易于输入,且可靠地被显示出来。

Section headings

Section headings should generally follow the guidance for article titles (above), and should be presented in sentence case (How to feed your VRCat), not title case (How To Feed Your VRCat).

The heading must be on its own line, with one blank line just before it; a blank line just after is optional and ignored (but do not use two blank lines, before or after, because that will add unwanted visible space).

For technical reasons, section headings should:

  • Be unique within a page, so that section links lead to the right place.
  • Not contain links, especially where only part of a heading is linked.
  • Not contain images, emoji or icons.
  • Not contain citations or footnotes.
  • Not misuse description list markup (";") to create pseudo-headings.
  • Not contain template transclusions.

As a matter of consistent style, section headings should:

  • Not redundantly refer back to the subject of the article, e.g., Early life, not Smith's early life or His early life.
  • Not refer to a higher-level heading, unless doing so is shorter or clearer.
  • Not be numbered or lettered as an outline.
  • Not be phrased as a question, e.g., Languages, not What languages are spoken in Mexico?.
  • Not use color or unusual fonts that might cause accessibility problems.
  • Not be wrapped in markup, which may break their display and cause other accessibility issues

English word choice and capitalization

In order to make localization of the wiki content easier in the long run, consider a few style choices such as these:

  • Quotations, titles of works (books, films, etc.) should be capitalized as given in the source (but see Typographic conformity, below);
  • Proper names use the subject's own spelling and capitalization, e.g., "...joint project of VRChat Inc. and VRChat Community Labs..."; "International Avatar Federation"
  • Generally, do not capitalize the word the in mid-sentence: throughout the United Kingdom, not throughout The United Kingdom.
  • Use universally accepted terms rather than those less widely distributed, especially in titles. For example, "glasses" is preferred to the national varieties spectacles (British English) and eyeglasses (American English); "Ten million" is preferable to "one crore" (Indian English).
  • If a variant spelling appears in a title, make a redirect page to accommodate the others, as with "artefact" and "artifact", so that all variants can be used in searches and linking.
  • Use a commonly understood word or phrase in preference to one that has a different meaning because of national differences (rather than "alternate", use "alternative" or "alternating", as appropriate), except in technical contexts where such substitution would be inappropriate ("alternate reality"; "alternate universe").