Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Vietnamese CONTRIBUTING, update Vietnamese README #918

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
159 changes: 159 additions & 0 deletions CONTRIBUTING.vi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,159 @@
# Hướng dẫn đóng góp

🎌
[Čeština][CZ],
[Dansk][DA],
[Deutsch][DE],
[English][EN],
[Español][ES],
[Français][FR],
[Italiano][IT],
[Kurdi][KU],
[Lietuvių][LT],
[Nederlands][NL],
[Norsk][NO],
[Polski][PL],
[Português][PT_BR],
**Tiếng Việt**,
[Türkçe][TR],
[Ukrainian][UA]،
[Ελληνικά][GR],
[العربية][AR],
[日本語][JA],
[正體中文][ZH_TW],
[简体中文][ZH_CN],
[한국어][KO_KR]

[AR]: CONTRIBUTING.ar.md
[CZ]: CONTRIBUTING.cz.md
[DA]: CONTRIBUTING.da.md
[DE]: CONTRIBUTING.de.md
[EN]: CONTRIBUTING.md
[ES]: CONTRIBUTING.es.md
[FR]: CONTRIBUTING.fr.md
[GR]: CONTRIBUTING.gr.md
[IT]: CONTRIBUTING.it.md
[JA]: CONTRIBUTING.ja.md
[KO_KR]: CONTRIBUTING.ko_kr.md
[KU]: CONTRIBUTING.ku.md
[LT]: CONTRIBUTING.lt.md
[NL]: CONTRIBUTING.nl.md
[NO]: CONTRIBUTING.no.md
[PL]: CONTRIBUTING.pl.md
[PT_BR]: CONTRIBUTING.pt_br.md
[VI]: CONTRIBUTING.vi.md
[TR]: CONTRIBUTING.tr.md
[UA]: CONTRIBUTING.ua.md
[ZH_CN]: CONTRIBUTING.zh_cn.md
[ZH_TW]: CONTRIBUTING.zh_tw.md

Mã nguồn trong repo này được số hóa một cách thủ công từ các bản in giấy, do đó lỗi đánh máy và các lỗi khác đã vô tình được đưa vào. Code sẽ được sửa để phù hợp với các bản in được quét sau:

- [AGC printouts for Comanche][8]
- [AGC printouts for Luminary][9]

## Các tiện ích mở rộng

GitHub tích hợp sẵn hỗ trợ cú pháp cho ngôn ngữ lắp assembly AGC. Thật không may, trình soạn thảo của bạn sẽ không hỗ trợ, tuy nhiên có các tiện ích mở rộng ngôn ngữ AGC cung cấp tính năng highlight cú pháp cho các trình soạn thảo sau:

- [Atom][Atom]†
- [CodeBlocks][CodeBlocks]
- [Eclipse][Eclipse]
- [Kate][Kate]
- [ProgrammersNotepad][ProgrammersNotepad]
- [Sublime Text 3][Sublime Text]†
- [TextPad][TextPad]
- [Vim][Vim]
- [Visual Studio Code][VisualStudioCode]†
- [jEdit][jEdit]

† Hỗ trợ tự động định dạng (Auto formatting)

[Atom]: https://github.com/Alhadis/language-agc
[CodeBlocks]: https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/CodeBlocks
[Eclipse]: https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/Eclipse
[Kate]: https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/Kate
[ProgrammersNotepad]: https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/ProgrammersNotepad
[Sublime Text]: https://github.com/jimlawton/AGC-Assembly
[TextPad]: https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/TextPad
[Vim]: https://github.com/wsdjeg/vim-assembly
[VisualStudioCode]: https://github.com/wopian/agc-assembly
[jEdit]: https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/jEdit

## Định dạng

**Lưu ý:** GitHub và các tiện ích mở rộng được đánh dấu ở trên sẽ đảm bảo bạn đang sử dụng định dạng chính xác một cách tự động.

- Sử dụng canh chĩnh tab
- Sử dụng chiều rộng tab là 8
- Xóa khoảng trắng cuối

## Tôi cần kiểm tra cái gì?

Bất kỳ sự khác biệt nào giữa các bản quét và mã nguồn trong repo này.

### Comments

Các comment trong code **PHẢI** khớp **chính xác** với bản quét.

Các vấn đề phổ biến mà bạn nên chú ý khi kiểm tra, nhưng không giới hạn, bao gồm:

#### Lỗi đánh máy

Ở một số nơi, các nhà phát triển ban đầu đã mắc lỗi đánh máy khi viết comment. Một số lỗi này đã được sửa nhầm trong quá trình số hóa ban đầu, tuy nhiên quá trình số hóa cũng đã đưa vào các lỗi đánh máy không có trong bản quét.

Ví dụ, nếu các bình luận được số hóa có chứa `SPACECRAFT`, nhưng `SPAECRAFT` được in trong bản quét, thì bản số hóa **PHẢI** được sửa thành `SPAECRAFT` (thiếu `C`).

Tương tự như vậy, nếu một từ có lỗi đánh máy trong bản số hóa nhưng được viết đúng chính tả trong bản quét thì **PHẢI** được sửa lỗi đánh máy đó.

#### Khoảng trắng

Khoảng trắng giữa hai ký tự trong comment **NÊN** khớp với bản quét. Trong hầu hết các trường hợp (xem phần thảo luận trong [#316][10]), như sau:

- 1 khoảng trắng cho các từ mới.
- 2 khoảng trắng cho các câu mới.
- 3 khoảng trắng cho các thụt lề.

Không phải tất cả các trang trong bản quét đều tuân theo quy tắc trên, nếu bản quét chỉ có một khoảng trắng thay vì hai khoảng trắng, hãy sử dụng một khoảng trắng.

### Ngắt dòng

- Ngắt dòng _có_ `R0000` trong cột 1 phải khớp chính xác với bản quét.
- Ngắt dòng _\*\***không** có_ `R0000` trong cột 1 chỉ nên chứa 1 hoặc 2 dòng trống liên tiếp.
- Nếu có nhiều hơn 2 ngắt dòng trống, hãy xóa các ngắt dòng thừa.
- Các dòng có `R0000` ở cột 1 sẽ không được tính vào đây.
- Trong các hình ảnh nguồn, Những thứ trên được tạo ra bởi một chữ số không được in vào trong cột 8. Một số 2 ở đó buộc phải có hai khoảng trắng (một dòng trống) và một số 3 buộc phải có ba khoảng trắng (hai dòng trống). Các giá trị 4-8 được xác định nhưng không bao giờ được sử dụng. Đọc thêm tại [#159][7]

Hãy xem ví dụ dưới đây:

```plain
R0819 SUBROUTINE TO SKIP...
R0820



0821 LAMPTEST CS IMODES33
```

Nên là:

```plain
R0819 SUBROUTINE TO SKIP...
R0820


0820 LAMPTEST CS IMODES33
```

## Ghi chú

Trước khi bạn tạo PR, hãy chắc chắn rằng những thay đổi của bạn phù hợp và ổn định với những scan sau:

[0]: https://github.com/chrislgarry/Apollo-11/pull/new/master
[1]: http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/
[2]: http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/
[6]: https://github.com/wopian/agc-assembly#user-settings
[7]: https://github.com/chrislgarry/Apollo-11/issues/159
[8]: http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/
[9]: http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/
[10]: https://github.com/chrislgarry/Apollo-11/pull/316#pullrequestreview-102892741
8 changes: 4 additions & 4 deletions README.vi.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
[ZH_CN]:README.zh_cn.md
[ZH_TW]:README.zh_tw.md

Mã nguồn của máy tính hướng dẫn Apollo 11 (AGC) thông qua Command Module (Comanche055) và Lunar Module (Luminary099). Được số hóa bởi những người ở [Virtual AGC][3] và [Bảo tàng MIT][4]. Mục tiêu là tạo ra một kho lưu trữ mã nguồn cho Apollo 11. Do vậy, PRs là một điều bình thường cho bất kì một vấn đề được xác định giữa các bản dịch trong kho lưu trữ này và nguồn gốc quét mã cho [Luminary 099][5] và [Comanche 055][6], cũng như bất kì file nào mà chúng tôi có thể bỏ lỡ.
Mã nguồn của máy tính hướng dẫn Apollo 11 (AGC) thông qua Command Module (Comanche055) và Lunar Module (Luminary099). Được số hóa bởi những người ở [Virtual AGC][3] và [Bảo tàng MIT][4]. Mục tiêu là tạo ra một repo lưu trữ mã nguồn cho Apollo 11. Do vậy, yêu cầu đóng góp (pull request) là một điều bình thường cho bất kì một vấn đề được xác định giữa các bản dịch trong repo này và nguồn gốc quét mã cho [Luminary 099][5] và [Comanche 055][6], cũng như bất kì file nào mà chúng tôi có thể bỏ lỡ.

## Đóng góp

Expand All @@ -79,11 +79,11 @@ Hãy đọc [CONTRIBUTING.md][7] trước khi bạn mở một pull request.

Nếu bạn quan tâm đến việc biên dịch mã nguồn, hãy kiểm tra [Virtual AGC][8].

## Ghi công
## Ghi nhận công sức và đóng góp

  |  
:---------- | :-----
Bản quyền | Công cộng
Bản quyền | Tài nguyên công cộng
Comanche055 | Một phần của mã nguồn cho Colossus 2A, Command Module's (CM) Apollo Guidance Computer (AGC) cho Apollo 11<br>`Tập hợp sửa đổi 055 của AGC chương trình Comanche bởi NASA`<br>`2021113-051. 10:28 APR. 1, 1969`
Luminary099 | Một phần của mã nguồn cho Luminary 1A, Lunar Module's (LM) Apollo Guidance Computer (AGC) cho Apollo 11<br>`Tập hợp sửa đổi 001 của AGC chương trình LMY99 bởi NASA`<br>`2021112-061. 16:27 JUL. 14, 1969`
Assembler | yaYUL
Expand All @@ -97,7 +97,7 @@ Số hóa | Mã nguồn này đã được sao chép hoặc chuyển thể

Chương trình AGC này cũng sẽ được gọi là Colossus 2A.

Chương trình này được thiết kế để sử dụng trong CM như được chỉ định trong báo cáo `R-577`. Chương trình này được chuẩn bị theo dự án DSR `55-23870`, được tài trợ bởi Trung tâm tàu vũ trụ có người lái của Cơ quan hàng không vũ trụ quốc gia thông qua hợp đồng `NAS 9-4065` với Phòng thí nghiệm thiết bị, Viện công nghệ Massachusetts, Cambridge, Mass.
Chương trình này được thiết kế để sử dụng trong Mô-đun Chỉ huy (Command Module) như được chỉ định trong báo cáo `R-577`. Chương trình này được chuẩn bị theo dự án DSR `55-23870`, được tài trợ bởi Trung tâm tàu vũ trụ có người lái của Cơ quan hàng không vũ trụ quốc gia (Manned Spacecraft Center of The National Aeronautics and Space Administration) thông qua hợp đồng `NAS 9-4065` với Phòng thí nghiệm thiết bị (Instrumentation Laboratory), Viện công nghệ Massachusetts (Massachusetts Institute of Technology), Cambridge, Mass.

Gửi bởi | Vai trò | Ngày
:------------------- | :------ | :---
Expand Down