The wiki source of YSLib documentation.
Revisión | 6b11a459623fb63166ea7e055385309e239fff9a (tree) |
---|---|
Tiempo | 2018-10-17 03:11:30 |
Autor | FrankHB <frankhb1989@gmai...> |
Commiter | FrankHB |
WikiRules.en-US.md: Added notes for English grammartic forms; fixed a typo; quasiquoted tags in the list.
@@ -40,14 +40,14 @@ | ||
40 | 40 | |
41 | 41 | Unless explicitly specified, when the meaning is in conflict for multiple editions in different languages, the complete one shall be valid over others. If there are no only one complete edition, the validity is specified in following order: |
42 | 42 | |
43 | -* en-US | |
44 | -* en | |
45 | -* zh-CN | |
46 | -* zh | |
43 | +* `en-US` | |
44 | +* `en` | |
45 | +* `zh-CN` | |
46 | +* `zh` | |
47 | 47 | |
48 | 48 | If no one edition in above languages is complete, the documentation is defective. |
49 | 49 | |
50 | -A language tag mey be used to annotate one or more words in text. An annotation of such use is a *language tag annotation*, which consists of a tag combined with one pair of enclosing parentheses (namely, `(` and `)`). | |
50 | +A language tag may be used to annotate one or more words in text. An annotation of such use is a *language tag annotation*, which consists of a tag combined with one pair of enclosing parentheses (namely, `(` and `)`). | |
51 | 51 | |
52 | 52 | [Hyperlinks](https://en.wikipedia.org/wiki/Hyperlink) in pages should preferrably link to localized contents corresponding to the language or one of the major languages used in the page (if any) when suitable. If contents of the linked target is in other languages (esp. when there are more than one semantically identical editions in multiple languages), at least one language tag for majority of the contents should be noted subsequent to the hyperlink; otherwise, the tag should be omitted. For compatibility of client programs, each link of [URI](https://en.wikipedia.org/wiki/URI) should be encoded in form of normalized [Percent-Encoding in RFC 3986](https://tools.ietf.org/html/rfc3986#section-2.1). |
53 | 53 |
@@ -55,7 +55,14 @@ | ||
55 | 55 | |
56 | 56 | * For [Chinese Wikipedia(zh-CN)](https://zh.wikipedia.org/zh-cn), the link shall following the rule in [the language conversion help page(zh-CN)], with small letter "cn" in the link. |
57 | 57 | |
58 | -# Format specific rules | |
58 | +### Grammartical notes | |
59 | + | |
60 | +The following grammartical forms of English (with `en` or `en-US` tags) are considered idiomatic and application of such forms may be preferred: | |
61 | + | |
62 | +* [bare passive clause](http://en.wikipedia.org/wiki/English_passive_voice#Additional_passive_constructions) omitting the auxiliary verb for short descriptive notes (e.g. commit messages in repositories and assertions messages in programs) | |
63 | +* [zero article](https://en.wikipedia.org/wiki/Zero-marking_in_English#Zero_article) for singular form of a countable noun denoting a specialized term being referenced, usually used in a terse-style title or in a list term (like this line) | |
64 | + | |
65 | +# Format-specific rules | |
59 | 66 | |
60 | 67 | ## Text files |
61 | 68 |