VRCWiki:מדריך סגנון

מדריך סגנון זה (MoS או MOS) הוא מדריך סגנון מוצע לוויקי של VRChat.

באופן כללי:

• כל התוכן בוויקי של VRChat צריך להיות אמיתי ומדויק.
• תורמים צריכים לכתוב דפים בשפה ישירה, תמציתית וקלה להבנה, ולבנות דפים בפריסות ובעיצוב עקביים וידידותיים לקורא.
• אם יש לכם שאלות על סגנון, פריסה או עיצוב של הוויקי של VRChat, פנו לאחד ממודרטורי הקהילה לעזרה.

כמה הנחיות ספציפיות לסגנון מפורטות להלן:

כותרות של מאמרים

כותרת צריכה להיות שם או תיאור מוכרים של הנושא, תוך איזון בין הקריטריונים של היותה טבעית, מדויקת דיה, תמציתית ועקבית עם כותרות של דפים קשורים.

להנחיות עיצוב ראו את המאמר "פורמט כותרת מאמר", תוך תשומת לב לדברים הבאים:

• יש לכתוב את האות הראשונה באות גדולה, ובשאר הכותרת לפעול לפי כתיב משפט (sentence case). VRChat משתמשת בכתיב משפט (sentence case) במשפטים, בכותרות של מאמרים, בכותרות של חלקים, בכותרות של טבלאות, בכיתובי תמונות, ברשימות (ברוב המקרים) ובערכים בתיבות מידע ובתבניות דומות, בין היתר.
• אין להתחיל כותרת של מאמר ב-article (a, an או the). למשל, כותבים Creator Economy ולא The Creator Economy. החריג הוא כשהמילה היא חלק אמיתי מהשם עצמו, כמו The Black Cat, או חלק מכותרת של יצירה, כמו The VRChat Times.
• בדרך כלל יש להשתמש בשמות עצם או בצירופי שם עצם: Early life, ולא In early life. ביטויים כמו In early life מקובלים (אם כי לא חובה) ככותרות של חלקים. הם משמשים לעתים קרובות גם כחלק מכותרות ארוכות יותר של מאמרים, כמו VRChat Events, במיוחד כשמבנה קצר יותר (Events) עלול לגרום לעמימות.
• התו האחרון לא צריך להיות סימן פיסוק, אלא אם הוא חלק בלתי נפרד משם (כמו Do Androids Dream of Electric Sheep?), או קיצור (VRChat Inc.), או כשנדרש סוגר עגול סוגר או מרכאה סוגרת (Fantastic Avatars (and where to find them)).
• בכל מקום שבו מופיעות מרכאות או גרשיים, יש להוסיף הפניה לאותה כותרת עם גרשיים. הימנעו משימוש במרכאות מסולסלות ("smart quotes"), כי מרכאות וגרשיים ישרים קלים יותר להקלדה ומוצגים באופן אמין ברוב הפלטפורמות.

כותרות חלקים

כותרות חלקים צריכות בדרך כלל לפעול לפי ההנחיות לכותרות דפים (לעיל), ולהיכתב בכתיב משפט (sentence case), למשל How to feed your VRCat, ולא בכתיב כותרת (title case), למשל How To Feed Your VRCat.

הכותרת חייבת להיות בשורה משלה, עם שורה ריקה אחת מיד לפניה; שורה ריקה מיד אחריה היא אופציונלית ומתעלמים ממנה (אבל אין להשתמש בשתי שורות ריקות, לפני או אחרי, כי הדבר יוסיף רווח גלוי לא רצוי).

מסיבות טכניות, כותרות חלקים צריכות:

• 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" 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").

Links

Please make an effort to use internal links whenever possible and avoid including tracking parameters in your URLs.

Group Links

When linking to your group, ensure that you use a permanent link. The link should clearly display the group name followed by its short code.

Example:

• VRChat Team - VRCHAT.0000

Categories

When adding a category to a page, ensure you are adding {{#translation:}} within the category enclosing.

Example:

• [[Category:Game worlds{{#translation:}}]]

This ensures that future pages that get marked for translation doesn't clog up the category list with language variants of the same page.

---