mirror of https://github.com/CrimsonTome/tldr.git
style-guide: add mnemonic translations
parent
8b8a2d2de0
commit
67f90450a4
|
@ -189,7 +189,7 @@ In this case, provide a note and method to determine whether the command current
|
||||||
|
|
||||||
### Short option mnemonics
|
### Short option mnemonics
|
||||||
|
|
||||||
Short option mnemonics are optional hints which can be added to help English users understand the meaning of these short options. For example:
|
Short option mnemonics are optional hints which can be added to help users understand the meaning of these short options. For example:
|
||||||
|
|
||||||
```md
|
```md
|
||||||
- [d]isplay the ins[t]allation [i]D for the current device. Useful for offline license activation:
|
- [d]isplay the ins[t]allation [i]D for the current device. Useful for offline license activation:
|
||||||
|
@ -205,6 +205,8 @@ Note that, on the first example, the `[d]`, `[t]`, and `[i]` characters are encl
|
||||||
|
|
||||||
**Mmemonic characters must be written in case-sensitive**, even though it is placed as the first character of the sentence (i.e. `[d]isplay` instead of `[D]isplay`). This is to avoid conflicts with GNU-style command options which may intepret uppercase options differently than the lowercase ones, such as `-v` for displaying the command's `[v]ersion` number and `-V` to run the command in `[V]erbose` mode.
|
**Mmemonic characters must be written in case-sensitive**, even though it is placed as the first character of the sentence (i.e. `[d]isplay` instead of `[D]isplay`). This is to avoid conflicts with GNU-style command options which may intepret uppercase options differently than the lowercase ones, such as `-v` for displaying the command's `[v]ersion` number and `-V` to run the command in `[V]erbose` mode.
|
||||||
|
|
||||||
|
Option mnemonics may also be used in translations as long as the highlighted word contains similar meanings to the language (commonly English) which the command is written for. For example, `[i]nstall` in English may be translated to `[i]nstallieren` in German, and `[a]pp` in English may be translated into `[a]plikasi` in Indonesian and Malay.
|
||||||
|
|
||||||
## Placeholder syntax
|
## Placeholder syntax
|
||||||
|
|
||||||
User-provided values should use the `{{placeholder}}` syntax
|
User-provided values should use the `{{placeholder}}` syntax
|
||||||
|
|
Loading…
Reference in New Issue