docs: 重写网页 PR 教程 (#10005)

* docs: 初步重写 PR 网页教程

* chore: Auto update by pre-commit hooks [skip changelog]

* docs: 再加一个按钮

* chore: Auto update by pre-commit hooks [skip changelog]

* fix: 先把图片路径修了

* docs: 不新建分支了

* chore: Auto update by pre-commit hooks [skip changelog]

* docs: 修复坏图片

* docs: 完成英语翻译 | English version completed (translated by gpt)

* chore: Auto update by pre-commit hooks [skip changelog]

* i18n: english tweaks

* i18n: english tweaks

---------

Co-authored-by: 晓丶梦丶仁 <1020623818@qq.com>
Co-authored-by: Constrat <56174894+Constrat@users.noreply.github.com>
This commit is contained in:
Rbqwow
2024-08-05 01:01:17 +08:00
committed by GitHub
parent 4af1856a0b
commit 8a6f121ec3
61 changed files with 1062 additions and 239 deletions

View File

@@ -22,7 +22,16 @@ repo로도 알려져 있으며 코드 및 다른 리소스 파일을 저장하
👇 현재 이 웹 페이지 및 그 내용 전체가 MAA의 저장소입니다 (일반적으로 MAA의 기본 저장소로 불립니다).
![image](/image/zh-cn/pr-tutorial/repository.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/repository-light.png",
"dark": "image/zh-cn/pr-tutorial/repository-dark.png"
}
]
}
```
### Fork (복사)
@@ -33,7 +42,16 @@ repo로도 알려져 있으며 코드 및 다른 리소스 파일을 저장하
원래 저장소와 구별하기 위해 일반적으로 원래 MAA 저장소를 "원본 저장소", "원격 저장소", "상위 저장소"로 지칭합니다.
각 사람이 자신의 복사본을 만들 수 있기 때문에 복사본을 "개인 저장소"로 지칭합니다.
![image](/image/zh-cn/pr-tutorial/fork.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/fork-light.png",
"dark": "image/zh-cn/pr-tutorial/fork-dark.png"
}
]
}
```
### Pull Request
@@ -44,7 +62,16 @@ PR로도 알려져 있으며, "풀 리퀘스트"라는 용어는 너무 길고
👇 아래는 현재 전문가들이 제시한 PR을 대기 중인 상태입니다.
![image](/image/zh-cn/pr-tutorial/pull-request.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pull-request-light.png",
"dark": "image/zh-cn/pr-tutorial/pull-request-dark.png"
}
]
}
```
### Conflict (충돌)
@@ -56,55 +83,166 @@ PR로도 알려져 있으며, "풀 리퀘스트"라는 용어는 너무 길고
1. 먼저 MAA 주 저장소로 이동하여 코드를 fork합니다.
![~ NKHB1CIE8`G(UK@ %3`H](/image/zh-cn/pr-tutorial/pr-1.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/fork-light.png",
"dark": "image/zh-cn/pr-tutorial/fork-dark.png"
}
]
}
```
2. "마스터 브랜치만" 옵션을 해제한 다음 Fork를 클릭합니다.
![20221004144039](/image/zh-cn/pr-tutorial/pr-2.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-2-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-2-dark.png"
}
]
}
```
3. 이제 개인 저장소로 이동하면 제목이 "YourName/MaaAssistantArknights"이고 아래에 한 줄짜리 작은 글씨로 "forked from MaaAssistantArknights/MaaAssistantArknights" (MAA 주 저장소에서 복제됨)이라고 표시됩니다.
![image](/image/zh-cn/pr-tutorial/pr-3.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-3-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-3-dark.png"
}
]
}
```
4. dev 브랜치로 전환합니다. (브랜치 개념은 이 문서와는 관련이 없으며~~사실 나는 귀찮아서 쓰지 않았습니다~~, 관심이 있다면 검색하여 알아보세요. 여기에서는 그냥 이렇게 조작하면 됩니다. 원리를 고려할 필요는 없습니다)
4. 수정하려는 파일을 찾아 "Go to file"을 클릭하여 전역 검색을 수행하거나 아래 폴더에서 직접 찾을 수 있습니다. (파일의 위치를 알고 있다면)
![image](/image/zh-cn/pr-tutorial/pr-4.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-4-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-4-dark.png"
}
]
}
```
5. 수정하려는 파일을 찾아 "Go to file"을 클릭하여 전역 검색을 수행하거나 아래 폴더에서 직접 찾을 수 있습니다. (파일의 위치를 알고 있다면)
5. 파일을 열면 파일 오른쪽 상단의 ✏️을 클릭하여 편집합니다.
![image](/image/zh-cn/pr-tutorial/pr-5.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-5-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-5-dark.png"
}
]
}
```
6. 파일을 열면 파일 오른쪽 상단의 ✏️을 클릭하여 편집합니다.
6. 수정하세요! (리소스 파일과 같은 경우 먼저 컴퓨터에있는 MAA 폴더에서 수정 사항을 테스트 한 다음 웹 페이지로 복사하여 잘못된 수정을 방지하세요)
7. 수정이 완료되면 맨 아래로 스크롤하여 수정 내용을 적습니다.
![image](/image/zh-cn/pr-tutorial/pr-6.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-7-1-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-7-1-dark.png"
}
]
}
```
7. 수정하세요! (리소스 파일과 같은 경우 먼저 컴퓨터에있는 MAA 폴더에서 수정 사항을 테스트 한 다음 웹 페이지로 복사하여 잘못된 수정을 방지하세요)
8. 수정이 완료되면 맨 아래로 스크롤하여 수정 내용을 적습니다.
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-7-2-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-7-2-dark.png"
}
]
}
```
![image](/image/zh-cn/pr-tutorial/pr-8.png)
9. 두 번째 파일을 수정해야합니까? 수정 후 오류가 발생하여 수정을 다시하고 싶습니까? 전혀 문제가되지 않습니다! 5-8을 반복하세요!
10. 모두 완료되면 PR을 제출하세요! Pull Request 탭을 클릭합니다.
8. 두 번째 파일을 수정해야합니까? 수정 후 오류가 발생하여 수정을 다시하고 싶습니까? 전혀 문제가되지 않습니다! 5-8을 반복하세요!
9. 모두 완료되면 PR을 제출하세요! Pull Request 탭을 클릭합니다.
Compare & Pull Request 버튼이 있으면 좋지만 없어도 걱정하지 마세요. 아래의 New Pull Request를 클릭하면 됩니다. (11단계 참조)
![image](/image/zh-cn/pr-tutorial/pr-10.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-9-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-9-dark.png"
}
]
}
```
11. 이제 주 저장소로 이동하여 제출할 PR을 확인합니다.
10. 이제 주 저장소로 이동하여 제출할 PR을 확인합니다.
아래 그림에서 화살표가 있는 곳은 오른쪽에 개인 이름/MAA의 dev 브랜치를 주 저장소/MAA의 dev 브랜치에 병합하는 것입니다.
그런 다음 제목, 수정한 내용 등을 작성하고 확인을 클릭합니다.
![image](/image/zh-cn/pr-tutorial/pr-11.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-10-1-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-10-1-dark.png"
}
]
}
```
12. MAA 팀의 전문가들의 검토를 기다립니다! 물론 그들도 의견을 제시 할 수 있습니다.
그런 다음 제목, 수정한 내용 등을 작성하고 확인을 클릭합니다.
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-10-2-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-10-2-dark.png"
}
]
}
```
11. MAA 팀의 전문가들의 검토를 기다립니다! 물론 그들도 의견을 제시 할 수 있습니다.
👇 예를 들어(오로지 오락을 위한 것이니 진지하게 받아들이지 마세요)
![image](/image/zh-cn/pr-tutorial/pr-12.png)
13. 만약 전문가들이 몇 가지 작은 문제를 수정하라고 말한다면 개인 저장소로 돌아가 이전의 dev 브랜치로 이동하여 3-9 단계를 반복하세요!
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-11-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-11-dark.png"
}
]
}
```
12. 만약 전문가들이 몇 가지 작은 문제를 수정하라고 말한다면 개인 저장소로 돌아가 이전의 dev 브랜치로 이동하여 3-9 단계를 반복하세요!
당신의 현재 PR은 여전히 검토 대기 중이므로 나중에 수정 사항이 이 PR에 직접 반영됩니다.
👇 예를 들어 아래에서 "재수정 데모"라는 새로운 내용이 추가된 것을 볼 수 있습니다.
![image](/image/zh-cn/pr-tutorial/pr-13.png)
14. 전문가들의 승인을 기다리면 모두 완료됩니다! **버전이 출시**되면 당신의 GitHub 프로필 사진이 자동으로 기여자 목록에 추가됩니다. 모든 분들의 자비로운 공헌에 감사드립니다!
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-12-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-12-dark.png"
}
]
}
```
13. 전문가들의 승인을 기다리면 모두 완료됩니다! **버전이 출시**되면 당신의 GitHub 프로필 사진이 자동으로 기여자 목록에 추가됩니다. 모든 분들의 자비로운 공헌에 감사드립니다!
~~왜 모든 사람들이 이중 인격이야, 오 나도 그렇지, 그럼 괜찮아~~
::: tip 기여자
@@ -113,7 +251,7 @@ PR로도 알려져 있으며, "풀 리퀘스트"라는 용어는 너무 길고
[![Contributors](https://contributors-img.web.app/image?repo=MaaAssistantArknights/MaaAssistantArknights&max=114514&columns=15)](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
:::
15. 다음에 다른 PR을 제출하려면 먼저 dev 브랜치로 전환한 다음 아래 그림과 같이 진행하세요.
14. 다음에 다른 PR을 제출하려면 먼저 dev 브랜치로 전환한 다음 아래 그림과 같이 진행하세요.
::: warning
이 조작은 개인 저장소를 주 저장소와 완전히 동일한 상태로 강제로 동기화합니다. 이것은 충돌을 해결하는 가장 간단하고 효과적인 방법입니다. 그러나 개인 저장소에 이미 추가한 것이 있으면 그것이 삭제됩니다!
@@ -122,6 +260,19 @@ PR로도 알려져 있으며, "풀 리퀘스트"라는 용어는 너무 길고
에서 설명한 이 모든 것을 모르거나 알 필요가 없다면 왼쪽의 버튼을 클릭하세요.
![image](/image/zh-cn/pr-tutorial/pr-15.png)
```component Image1
{
"imageList": [
{
"light": "image/zh-cn/pr-tutorial/pr-14-1-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-14-1-dark.png"
},
{
"light": "image/zh-cn/pr-tutorial/pr-14-2-light.png",
"dark": "image/zh-cn/pr-tutorial/pr-14-2-dark.png"
}
]
}
```
그러면 3-14 단계를 반복하여 수정하고 PR을 제출하면 됩니다~