Skip to content

Commit

Permalink
New Crowdin updates (#310)
Browse files Browse the repository at this point in the history 
* New translations autoquad.html (Chinese Simplified)

* New translations ualberta.html (Chinese Simplified)

* New translations ASLUAV.html (Chinese Simplified)

* New translations ualberta.html (Korean)

* New translations ASLUAV.html (Korean)

* New translations autoquad.html (Korean)

* New translations faq.md (Korean)

* New translations faq.md (Chinese Simplified)

* New translations README.md (Korean)

* New translations README.md (Chinese Simplified)

* New translations generate_libraries.md (Korean)

* New translations generate_libraries.md (Chinese Simplified)
  • Loading branch information
@PX4BuildBot
PX4BuildBot authored Jan 28, 2021
1 parent f4c1916 commit ae5cb89
Show file tree
Hide file tree
Showing 12 changed files with 391 additions and 109 deletions.
46 changes: 24 additions & 22 deletions ko/README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,36 +20,38 @@ MAVLink는 2009년 초반 Lorenz Meier가 처음으로 출시했으며, 현재

* 매우 효율적입니다. MAVLink 1은 시작 부호와 패킷 손실 탐지 부분을 포함하여 패킷당 8바이트의 크기를 가집니다. MAVLink 2는 14바이트의 크기를 가집니다(만, 더 안전하고 기능 확장에 용이합니다). MAVLink는 추가 프레이밍이 필요가 없기 때문에 통신 대역폭을 상당히 제한하는 여건에서도 프로그램에 매우 안성맞춤입니다.
* 상당히 견고합니다. MAVLink는 여건이 혹독한 다양한 통신 채널(높은 지연율/잡음) 환경에서 다양한 기체, 지상 관제국(및 타 노드)간의 통신 수행 목적으로 2009년부터 사용했습니다. 패킷 손실, 손상, 인증 수단을 제공합니다.
* 여러 마이크로컨트롤러(ARM7, ATMega, dsPic, STM32)와 운영체제(윈도우, 리눅스, MacOS, 안드로이드, iOS)에서 동작하는 [많은 프로그래밍 언어](#supported_languages)를 지원합니다.
* [Many different programming languages](#supported_languages) can be used, running on numerous microcontrollers/operating systems (including ARM7, ATMega, dsPic, STM32 and Windows, Linux, MacOS, Android and iOS).
* 네트워크에서 최대 255대의 시스템(기체, 지상 관제국)을 동시에 운용할 수 있습니다.
* 보드 내외간 통신이 가능합니다(GCS와 드론간의 통신, 드론 오토파일럿과 MAVLink 통신 기능을 갖춘 드론 카메라와의 통신).

## 지원 언어 {#supported_languages}
## Language/Generator List {#supported_languages}

MAVLink 프로젝트에는 [mavgen](getting_started/generate_libraries.md#mavgen)과 [mavgenerate](getting_started/generate_libraries.md#mavgenerate) 도구가 들어있어, 다양한 프로그래밍 언어를 활용할 수 있는 MAVLink 라이브러리를 만들 수 있습니다. 추가 제네레이터는 다른 프로젝트에서 제공합니다.
MAVLink 프로젝트에는 [mavgen](getting_started/generate_libraries.md#mavgen)과 [mavgenerate](getting_started/generate_libraries.md#mavgenerate) 도구가 들어있어, 다양한 프로그래밍 언어를 활용할 수 있는 MAVLink 라이브러리를 만들 수 있습니다. The organisation also includes [rust-mavlink](https://github.com/mavlink/rust-mavlink) for generating Rust MAVLink libraries. Additional generators are delivered by a number of other (independent) projects.

> **Note**MAVLink 프로젝트에서는 *mavgen*과 *mavgenerate*를 제외한 다른 모든 제네레이터를 아직 검증하지 않았고, 해당 제네레이터를 대상으로 기술지원을 하지 않습니다.
> **Note** The MAVLink project has not validated and does not provide technical support for generators other than *mavgen*, *mavgenerate*, and *rust-mavlink*.
하단 표에서는 현재 MAVLink 1, [MAVLink 2](guide/mavlink_2.md), [메시지 서명](guide/message_signing.md)에 활용할 수 있는 프로그래밍 언어와 제너레이터를 보여드립니다.

| 언어 | 제너레이터 | MAVLink v1 | MAVLink v2 | 서명 | 참고 |
|:--------------------- |:----------------------------------------------------------- |:----------:|:----------:|:---:|:---------------------------------------------------------------------------------------------- |
| C | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | 예 | 예 | MAVLink 프로젝트 참고 구현입니다. [생성 라이브러리](#prebuilt_libraries)는 프로토콜 버전 별로 출시합니다. |
| C++11 | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | 예 | 예 | |
| 파이썬 (2.7+, 3.3+) | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | 예 | 예 | |
| C# | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | | | |
| Objective C | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | | | |
| Java | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | | | |
| Java | [dronefleet/mavlink](https://github.com/dronefleet/mavlink) | 예 | 예 | 예 | MAVLink용 *Idiomatic* Java SDK/API 입니다. 코드 제너레이터용 그래들 플러그인이 있습니다. |
| JavaScript | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | 예 | 아니요 | |
| TypeScript/JavaScript | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | 예 | 아니요 | [node-mavlink](https://github.com/ifrunistuttgart/node-mavlink)와 활용할 수 있는 TypeScript 클래스가 있습니다 |
| Lua | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | 예 | | |
| Swift | [mavgen](getting_started/generate_libraries.md#mavgen) | 예 | | | |
| Clojure | [clj-mavlink](https://github.com/WickedShell/clj-mavlink) | 예 | 예 | 예 | Clojure용 MAVLink 바인딩이 있습니다. |
| Go | [gomavlib](https://github.com/gswly/gomavlib) | 예 | 예 | 예 | |
| Go | [go-mavlink1](https://github.com/mgr9525/go-mavlink1) | Y | N | 아니요 | Golang MAVLink v1 |
| Haskell | [HaskMavlink](https://github.com/SweeWarman/HaskMavlink) | N | Y | N | |
| Rust | [rust-mavlink](https://github.com/mavlink/rust-mavlink) | Y | Y | | Rust MAVLink generated code |
| 언어 | 제너레이터 | MAVLink v1 | MAVLink v2 | 서명 | 참고 |
|:----------------------------- |:----------------------------------------------------------- |:----------:|:----------:|:------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| C | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | ✓ | ✓ | MAVLink 프로젝트 참고 구현입니다. [생성 라이브러리](#prebuilt_libraries)는 프로토콜 버전 별로 출시합니다. |
| C++11 | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | ✓ | ✓ | |
| 파이썬 (2.7+, 3.3+) | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | ✓ | ✓ | Python bindings. Library also available on PyPi: [pymavlink](https://pypi.org/project/pymavlink/). |
| C# | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | | | |
| Objective C | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | | | |
| Java | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | | | |
| Java | [dronefleet/mavlink](https://github.com/dronefleet/mavlink) | ✓ | ✓ | ✓ | MAVLink용 *Idiomatic* Java SDK/API 입니다. 코드 제너레이터용 그래들 플러그인이 있습니다. |
| JavaScript (Stable) | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | ✓ | ✗ | Old mavgen JavaScript binding (has known bugs and no test suite). |
| JavaScript (NextGen) | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | ✓ | ✓ | New mavgen JavaScript library. Full test suite, resulting library produces binary compatible output compared to C bindings. Slightly incompatible with previous version, but not hard to migrate. |
| TypeScript/JavaScript | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | ✓ | ✗ | TypeScript classes which can be used with [node-mavlink](https://github.com/ifrunistuttgart/node-mavlink). |
| Lua | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | ✓ | ✗ | Lua library. Does not support zero trimming of MAVLink 2 messages. |
| WLua (Wireshark Lua bindings) | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | ✓ | NA | Allow MAVLink-aware packet inspection in Wireshark. Generated lua scripts should be copied to the Wireshark plugin directory (e.g. **wireshark/plugins/mavlink.lua**). |
| Swift | [mavgen](getting_started/generate_libraries.md#mavgen) | ✓ | | | |
| Clojure | [clj-mavlink](https://github.com/WickedShell/clj-mavlink) | ✓ | ✓ | ✓ | Clojure MAVLink Bindings. |
| Go | [gomavlib](https://github.com/gswly/gomavlib) | ✓ | ✓ | ✓ | Go library with support for MAVLink 1, 2 and signing, test suite, and [documentation](https://pkg.go.dev/github.com/aler9/gomavlib) |
| Go | [go-mavlink1](https://github.com/mgr9525/go-mavlink1) | ✓ | ✗ | ✗ | Golang MAVLink v1 |
| Haskell | [HaskMavlink](https://github.com/SweeWarman/HaskMavlink) | ✗ | ✓ | ✗ | |
| Rust | [rust-mavlink](https://github.com/mavlink/rust-mavlink) | ✓ | ✓ | | Rust MAVLink generated code. Has tests and minimal docs. |

## 미리 빌드한 MAVLink C 라이브러리 {#prebuilt_libraries}

Expand Down
18 changes: 18 additions & 0 deletions ko/about/faq.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,24 @@
<dt>MAVLINK는 얼마나 안전한가요?</dt>
<dd>MAVLINK는 시스템이 신뢰할 수 있는 출처에서 오는 메시지임을 인증하도록 <a href="../guide/message_signing.md">message signing</a>을 사용합니다. MAVLINK는 메시지 암호화를 제공하지 않습니다.
</dd>

<dt>What version of MAVLink should I use?</dt>
<dd>You should use the <a href="../guide/mavlink_2.md">MAVLink 2</a> protocol where at all possible (it fixes a number of limitations of earlier versions).
The <em>MAVLink 2</em> libraries also support <em>MAVLink 1</em>, so you can use them to communicate with legacy systems if needed.
</dd>

<dt>How often is MAVLink updated/released?</dt>
<dd>


<ul>
<li>The underlying over-the-wire format is rarely updated (we're only up to <em>MAVLink 2</em>, which was introduced in 2017).
</li>
<li>New <a href="../messages/common.md">messages</a>/<a href="../services/README.md">microservices</a> are frequently added. This is a backwards compatible change, and users are expected to regularly update their libraries to support new messages.</li>
<li>Messages are rarely modified (or removed) such that they would become incompatible. If this is needed the project will update the MAVLink minor version number and notify users through the <a href="https://groups.google.com/forum/#!forum/mavlink">mailing list</a> (users can also query the version in code).</li>
</ul>
</dd>

</dl>

## 개발자
Expand Down
12 changes: 10 additions & 2 deletions ko/getting_started/generate_libraries.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,14 @@ Generator Steps:
2. Choose an output directory (e.g. **mavlink/include**).

3. Select the target output programming language.

![mavgenerate UI - language list](../../assets/mavgen/malink_gen_ui_languages.png)

> **Note** There are three JavaScript options:
- `JavaScript_Stable` is an older version that only supports MAVLink 1.0,
- `JavaScript_NextGen` is a more recent version that supports MAVLink 1 and 2 along with signing.
- `JavaScript` is a "proxy" for the recommended version. Currently this is `JavaScript_Stable`.
4. Select the target MAVLink protocol version (ideally 2.0) > **Caution** Generation will fail if the protocol is not [supported](../README.md#supported_languages) by the selected programming language.
5. Optionally check *Validate* and/or *Validate Units* (if checked validates XML specifications).
6. Click **Generate** to create the source files.
Expand All @@ -60,7 +68,7 @@ python3 -m pymavlink.tools.mavgen --lang=C --wire-protocol=2.0 --output=generate
The full syntax and options can be output by running *mavgen* with the `-h` flag (reproduced below):

usage: mavgen.py [-h] [-o OUTPUT]
[--lang {C,CS,JavaScript,TypeScript,Python,WLua,ObjC,Swift,Java,C++11}]
[--lang {C,CS,JavaScript,JavaScript_Stable,JavaScript_NextGen,TypeScript,Python,Lua,WLua,ObjC,Swift,Java,C++11}]
[--wire-protocol {0.9,1.0,2.0}] [--no-validate]
[--error-limit ERROR_LIMIT] [--strict-units]
XML [XML ...]
Expand All @@ -74,7 +82,7 @@ The full syntax and options can be output by running *mavgen* with the `-h` flag
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
output directory.
--lang {C,CS,JavaScript,TypeScript,Python,WLua,ObjC,Swift,Java,C++11}
--lang {C,CS,JavaScript,JavaScript_Stable,JavaScript_NextGen,TypeScript,Python,Lua,WLua,ObjC,Swift,Java,C++11}
language of generated code [default: Python]
--wire-protocol {0.9,1.0,2.0}
MAVLink protocol version. [default: 1.0]
Expand Down
Loading

0 comments on commit ae5cb89

Please sign in to comment.