Skip to content

Commit 3a99f9a

Browse files
authored
New Crowdin updates (#595)
* New translations common.md (Korean) * New translations common.md (Chinese Simplified) * New translations csairlink.md (Korean) * New translations minimal.md (Korean) * New translations paparazzi.md (Korean) * New translations python_array_test.md (Korean) * New translations standard.md (Korean) * New translations storm32.md (Korean) * New translations test.md (Korean) * New translations uavionix.md (Korean) * New translations all.md (Korean) * New translations ardupilotmega.md (Korean) * New translations asluav.md (Korean) * New translations avssuas.md (Korean) * New translations ftp.md (Korean) * New translations loweheiser.md (Korean) * New translations csairlink.md (Chinese Simplified) * New translations minimal.md (Chinese Simplified) * New translations paparazzi.md (Chinese Simplified) * New translations python_array_test.md (Chinese Simplified) * New translations standard.md (Chinese Simplified) * New translations storm32.md (Chinese Simplified) * New translations test.md (Chinese Simplified) * New translations uavionix.md (Chinese Simplified) * New translations all.md (Chinese Simplified) * New translations ardupilotmega.md (Chinese Simplified) * New translations asluav.md (Chinese Simplified) * New translations avssuas.md (Chinese Simplified) * New translations ftp.md (Chinese Simplified) * New translations loweheiser.md (Chinese Simplified) * New translations define_xml_element.md (Korean) * New translations xml_schema.md (Korean) * New translations define_xml_element.md (Chinese Simplified) * New translations xml_schema.md (Chinese Simplified)
1 parent d828a29 commit 3a99f9a

34 files changed

+456
-540
lines changed

ko/guide/define_xml_element.md

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -93,48 +93,48 @@ To create a new dialect file:
9393

9494
3. Copy the following text into the new file.
9595

96-
```xml
97-
<?xml version="1.0"?>
98-
<mavlink>
96+
```xml
97+
<?xml version="1.0"?>
98+
<mavlink>
9999

100-
<include>common.xml</include>
101-
<!-- <version>9</version> -->
102-
<dialect>8</dialect>
100+
<include>common.xml</include>
101+
<!-- <version>9</version> -->
102+
<dialect>8</dialect>
103103

104-
<enums>
105-
<!-- Enums are defined here (optional) -->
106-
</enums>
104+
<enums>
105+
<!-- Enums are defined here (optional) -->
106+
</enums>
107107

108-
<messages>
109-
<!-- Messages are defined here (optional) -->
110-
</messages>
108+
<messages>
109+
<!-- Messages are defined here (optional) -->
110+
</messages>
111111

112-
</mavlink>
113-
```
112+
</mavlink>
113+
```
114114

115-
The template assumes that your dialect:
115+
The template assumes that your dialect:
116116

117-
- imports **common.xml** (`<include>common.xml</include>`)
118-
- takes its version from **common.xml** (which is why the `version` tags are commented out).
117+
- imports **common.xml** (`<include>common.xml</include>`)
118+
- takes its version from **common.xml** (which is why the `version` tags are commented out).
119119

120120
4. Update the `include`(s):
121121

122-
- if the dialect is not based on **common.xml** remove the existing `include` line
123-
- Add additional `<include> </include>` elements to import additional files/dialects.
122+
- if the dialect is not based on **common.xml** remove the existing `include` line
123+
- Add additional `<include> </include>` elements to import additional files/dialects.
124124

125-
::: info
126-
Includes in nested files are ignored.
127-
:::
125+
::: info
126+
Includes in nested files are ignored.
127+
:::
128128

129129
5. Update the `version`:
130130

131-
- Most dialects should leave the version commented out (i.e. all dialects that include **common.xml**).
132-
- Dialects that are _not_ based on **common.xml** can uncomment the `<version>6</version>` line and use whatever version is desired.
131+
- Most dialects should leave the version commented out (i.e. all dialects that include **common.xml**).
132+
- Dialects that are _not_ based on **common.xml** can uncomment the `<version>6</version>` line and use whatever version is desired.
133133

134-
::: info
135-
The `version` specified in the top level file is used by default, if present.
136-
If it is not present in the file, then a `version` from an included file is used.
137-
:::
134+
::: info
135+
The `version` specified in the top level file is used by default, if present.
136+
If it is not present in the file, then a `version` from an included file is used.
137+
:::
138138

139139
6. Update the `<dialect>8</dialect>` line to replace `8` with the next-largest unused dialect number (based on the other files in the folder).
140140

@@ -370,6 +370,8 @@ The main rules for enums are:
370370
If enums are merged, only one description will be used (usually the first that is encountered).
371371
- Enums _may_ be marked as deprecated.
372372
- Enums _must_ have at least one enum entry.
373+
- Enums that define bitmasks (values that increase by a power of 2) should be marked with the attribute `bitmask="true"`.
374+
This allows users to render a checkbox UI for things that can be represented as flags.
373375
- Entries:
374376

375377
- _must_ have a `name` attribute.
@@ -385,8 +387,6 @@ The main rules for enums are:
385387

386388
- _should_ (very highly recommended) include a `description` element.
387389

388-
- may represent bitmasks, in which case values will increase by a power of 2.
389-
390390
- _may_ be marked as deprecated.
391391

392392
:::warning
@@ -536,7 +536,7 @@ The default value cannot later be changed from `NaN` to `0` (or visa versa) with
536536

537537
To declare a `param` as `reserved` with `default` value of `NaN` you should use the following syntax.
538538

539-
```
539+
```xml
540540
<param index="3" reserved="true" default="NaN" />
541541
```
542542

ko/guide/xml_schema.md

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -84,9 +84,13 @@ For example, the definition of the [LANDING_TARGET_TYPE](../messages/common.md#L
8484
</enum>
8585
```
8686

87-
The main `enum` tags/fields are:
87+
The main `enum` attributes are:
8888

8989
- `name`: The name of the enum (mandatory). This is a string of capitalized, underscore-separated words.
90+
- `bitmask`: Set to `true` for enums that defines entries with values that increase by a power of 2, such as flags.
91+
92+
The main `enum` nested tags are:
93+
9094
- `description` (optional): A string describing the purpose of the enum
9195
- `entry` (optional): An entry (zero or more entries can be specified for each enum)
9296
- [deprecated](#deprecated) (optional): A tag indicating that the enum is deprecated.
@@ -97,10 +101,13 @@ The main `enum` tags/fields are:
97101

98102
### entry {#entry}
99103

100-
The "normal" enum `entry` tags/fields are:
104+
The "normal" enum `entry` attributes are:
101105

102106
- `name`: The name of the enum value (mandatory). This is a string of capitalized, underscore-separated words.
103107
- `value` (optional): The _value_ for the entry (a number).
108+
109+
The "normal" `entry` nested fields are:
110+
104111
- `description` (optional): A description of the entry.
105112
- [deprecated](#deprecated) / [wip](#wip) (optional): A tag indicating that the enum is deprecated or "work in progress".
106113

@@ -214,7 +221,7 @@ For example,the definition of the [BATTERY_STATUS](../messages/common.md#BATTERY
214221
<field type="uint8_t" name="charge_state" enum="MAV_BATTERY_CHARGE_STATE">State for extent of discharge, provided by autopilot for warning or external reactions</field>
215222
<field type="uint16_t[4]" name="voltages_ext" units="mV" invalid="[0]">Battery voltages for cells 11 to 14. Cells above the valid cell count for this battery should have a value of 0, where zero indicates not supported (note, this is different than for the voltages field and allows empty byte truncation). If the measured value is 0 then 1 should be sent instead.</field>
216223
<field type="uint8_t" name="mode" enum="MAV_BATTERY_MODE">Battery mode. Default (0) is that battery mode reporting is not supported or battery is in normal-use mode.</field>
217-
<field type="uint32_t" name="fault_bitmask" display="bitmask" enum="MAV_BATTERY_FAULT">Fault/health indications. These should be set when charge_state is MAV_BATTERY_CHARGE_STATE_FAILED or MAV_BATTERY_CHARGE_STATE_UNHEALTHY (if not, fault reporting is not supported).</field>
224+
<field type="uint32_t" name="fault_bitmask" enum="MAV_BATTERY_FAULT">Fault/health indications. These should be set when charge_state is MAV_BATTERY_CHARGE_STATE_FAILED or MAV_BATTERY_CHARGE_STATE_UNHEALTHY (if not, fault reporting is not supported).</field>
218225
</message>
219226
```
220227

@@ -261,8 +268,6 @@ The main message tags/fields are:
261268
To get the original value, scale by multiplying the value with the multiplier (`360/256`).
262269
This is currently only used for values where scaling is not encoded in the `units`.
263270

264-
- `display` (optional): This should be set as `display="bitmask"` for bitmask fields (hint to ground station that enum values must be displayed as checkboxes).
265-
266271
- `print_format` (optional): TBD.
267272

268273
- `default` (optional): TBD.

ko/messages/ASLUAV.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -393,3 +393,5 @@ Mission command to perform a power cycle on payload
393393
| 5 | Empty |
394394
| 6 | Empty |
395395
| 7 | Empty |
396+
397+

ko/messages/AVSSUAS.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -238,3 +238,5 @@ AVSS defined command. Shuts down the PRS system.
238238
| 5 | User defined |
239239
| 6 | User defined |
240240
| 7 | User defined |
241+
242+

ko/messages/all.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,8 +60,8 @@ span.warning {
6060

6161
| Type | Defined | Included |
6262
| -------------------------- | ------- | -------- |
63-
| [Messages](#messages) | 0 | 376 |
64-
| [Enums](#enumerated-types) | 0 | 239 |
63+
| [Messages](#messages) | 0 | 372 |
64+
| [Enums](#enumerated-types) | 0 | 235 |
6565
| [Commands](#mav_commands) | 217 | 0 |
6666

6767
The following sections list all entities in the dialect (both included and defined in this file).

0 commit comments

Comments
 (0)