New Crowdin translations - ko (#24677)

Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
This commit is contained in:
PX4 Build Bot
2025-04-09 14:24:28 +10:00
committed by GitHub
co-authored by Crowdin Bot
parent 6704cc14f9
commit e58035c57a
10 changed files with 392 additions and 68 deletions
+50 -22
View File
@@ -17,7 +17,7 @@ Simple changes to _existing content_ can be made by clicking the **Edit on GitHu
![Vitepress: Edit Page button](../../assets/vuepress/vuepress_edit_page_on_github_link.png)
기존 페이지를 편집하려면:
To edit an existing English page:
1. 해당 페이지를 엽니다.
2. Click the **Edit on GitHub** link below the page content.
@@ -26,19 +26,32 @@ Simple changes to _existing content_ can be made by clicking the **Edit on GitHu
문서 팀은 요청을 검토하고, 병합하거나 업데이트하기 위하여 귀하와 협력할 것입니다.
## Git을 사용한 변경(새 페이지 및 이미지)
Note that you can only make changes to the English version directly in the source.
[Translations are handled in Crowdin](../contribute/translation.md).
## Changes using Git
새 페이지 추가 또는 이미지 추가/수정을 포함하여 보다 실질적인 변경은 Github에서 수행(또는 적절하게 테스트)하는 것처럼 간단하지 않습니다.
For these kinds of changes we suggest using the same approach as for _code_:
1. Use the _git_ toolchain to get the documentation source code onto your local computer.
1. Use the _git_ toolchain to get the PX4 source code onto your local computer.
2. 필요한 문서를 수정합니다(추가, 변경, 삭제).
3. _Test_ that it builds properly using Vitepress.
4. 변경 사항에 대한 분기를 만들고 풀 요청을 만들어 문서로 다시 가져옵니다.
4. Create a branch for your changes and create a pull request (PR) to pull it back into the [PX4-Autopilot](https://github.com/PX4/PX4-Autopilot.git) repo.
다음에는 소스 코드를 가져오고, 로컬에서 빌드(테스트용)하고, 코드를 수정하는 방법을 설명합니다.
### 문서 소스 코드 가져오기/보내기
### Get Documentation Source Code
Documentation sources are in the [PX4-Autopilot](https://github.com/PX4/PX4-Autopilot/) repo, alongside all the other PX4 source code.
The sources are markdown files located the [/docs](https://github.com/PX4/PX4-Autopilot/tree/main/docs) subdirectory.
The English source files are in the [/docs/en/](https://github.com/PX4/PX4-Autopilot/tree/main/docs/en) subdirectory and can be edited directly.
[Translation](../contribute/translation.md) sources are in language specific subdirectories, such as `ko` for korean and `zh` for Chinese: these are edited via the Crowdin tool, and should not be edited directly.
:::tip
If you already have a clone of the [PX4-Autopilot](https://github.com/PX4/PX4-Autopilot/) you can ignore this section.
:::
라이브러리 소스를 로컬 컴퓨터로 가져오려면 git 명령어를 사용하여야 합니다.
아래 지침은 git을 가져와 로컬 컴퓨터에서 사용하는 방법을 설명합니다.
@@ -47,31 +60,31 @@ For these kinds of changes we suggest using the same approach as for _code_:
2. [Sign up](https://github.com/join) for Github if you haven't already
3. Create a copy (Fork) of the [PX4 User Guide repo](https://github.com/PX4/PX4-user_guide) on Github ([instructions here](https://docs.github.com/en/get-started/quickstart/fork-a-repo)).
3. Create a copy (Fork) of the [PX4-Autopilot repo](https://github.com/PX4/PX4-Autopilot) on Github ([instructions here](https://docs.github.com/en/get-started/quickstart/fork-a-repo)).
4. 복사된 저장소를 로컬 컴퓨터에 복제합니다.
```sh
cd ~/wherever/
git clone https://github.com/<your git name>/PX4-user_guide.git
git clone https://github.com/<your git name>/PX4-Autopilot.git
```
예를 들어, Github 계정이 "john_citizen"인 사용자의 PX4 사용자 가이드 포크를 복제합니다.
For example, to clone PX4 source fork for a user with Github account "john_citizen":
```sh
git clone https://github.com/john_citizen/PX4-user_guide.git
git clone https://github.com/john_citizen/PX4-Autopilot.git
```
5. 로컬 저장소로 이동합니다.
```sh
cd ~/wherever/PX4-user_guide
cd ~/wherever/PX4-Autopilot
```
6. Add a _remote_ called "upstream" to point to the PX4 version of the library:
6. Add a _remote_ called "upstream" to point to the "official" PX4 version of the library:
```sh
git remote add upstream https://github.com/PX4/PX4-user_guide.git
git remote add upstream https://github.com/PX4/PX4-Autopilot.git
```
:::tip
@@ -81,7 +94,19 @@ For these kinds of changes we suggest using the same approach as for _code_:
:::
7. 변경 사항에 대한 브랜치를 생성합니다.
### Make/Push Documentation Changes
Within the repository you created above:
1. Bring your copy of the repository `main` branch up to date:
```sh
git checkout main
git fetch upstream main
git pull upstream main
```
2. Create a new branch for your changes:
```sh
git checkout -b <your_feature_branch_name>
@@ -89,9 +114,9 @@ For these kinds of changes we suggest using the same approach as for _code_:
This creates a local branch on your computer named `your_feature_branch_name`.
8. 필요에 따라 문서를 변경합니다(다음 섹션에서 이에 대한 일반 지침).
3. 필요에 따라 문서를 변경합니다(다음 섹션에서 이에 대한 일반 지침).
9. 변경 사항에 완료되면 "커밋"을 사용하여, 로컬 브랜치에 추가합니다.
4. 변경 사항에 완료되면 "커밋"을 사용하여, 로컬 브랜치에 추가합니다.
```sh
git add <file name>
@@ -100,23 +125,26 @@ For these kinds of changes we suggest using the same approach as for _code_:
For a good commit message, please refer to the [Source Code Management](../contribute/code.md#commits-and-commit-messages) section.
10. 로컬 분기(추가된 커밋 포함)를 Github의 분기된 저장소에 푸시합니다.
5. 로컬 분기(추가된 커밋 포함)를 Github의 분기된 저장소에 푸시합니다.
```sh
git push origin your_feature_branch_name
```
11. Go to your forked repository on Github in a web browser, e.g.: `https://github.com/<your git name>/PX4-user_guide.git`.
6. Go to your forked repository on Github in a web browser, e.g.: `https://github.com/<your git name>/PX4-Autopilot.git`.
새 분기가 분기된 저장소로 푸시되었다는 메시지가 표시되어야 합니다.
12. 풀 요청(PR) 생성:
7. 풀 요청(PR) 생성:
- On the right hand side of the "new branch message" (see one step before), you should see a green button saying "Compare & Create Pull Request".
클릭합니다.
- 풀 요청 템플릿이 생성됩니다.
그것은 당신의 커밋을 나열하고 의미 있는 제목(하나의 커밋 PR의 경우 일반적으로 커밋 메시지)과 메시지(<span style="color:orange">어떤 이유에서 수행했는지 설명</span>)를 추가할 수 있습니다(반드시).
Check [other pull requests](https://github.com/PX4/PX4-user_guide/pulls) for comparison)
Check [other pull requests](https://github.com/PX4/PX4-Autopilot/pulls) for comparison).
- Add the "Documentation" label.
8. 완료하였습니다.
13. 완료하였습니다.
PX4 사용자 가이드 유지 관리자는 이제 귀하의 기여를 검투한 후에, 통합 여부를 결정합니다.
때때로 변경 사항에 대한 질문을 확인하십시오.
@@ -129,10 +157,10 @@ For these kinds of changes we suggest using the same approach as for _code_:
- [Nodejs 18+](https://nodejs.org/en)
- [Yarn classic](https://classic.yarnpkg.com/en/docs/install)
2. 로컬 저장소로 이동합니다.
2. Navigate to your local repository and the `/docs` subdirectory:
```sh
cd ~/wherever/PX4-user_guide
cd ~/wherever/PX4-Autopilot/docs
```
3. 종속성(Vuepress 포함)들을 설치합니다.