Update ZH_CN README (#677)

* format and sync something

* format

* change link text
This commit is contained in:
2BFL 2020-06-23 20:02:27 +08:00 committed by GitHub
parent a7077ec72e
commit 653a4af4bc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 41 additions and 37 deletions

View File

@ -1,4 +1,4 @@
# Contributing # 贡献
🎌 🎌
[Deutsch][DE], [Deutsch][DE],
@ -27,13 +27,13 @@
本仓库中的源代码来自对纸质打印输出文件的手动数字化,所以会不小心引入一些拼写错误和其他差异。这些代码应该被修正以使其与原纸质打印输出文件内容保持一致: 本仓库中的源代码来自对纸质打印输出文件的手动数字化,所以会不小心引入一些拼写错误和其他差异。这些代码应该被修正以使其与原纸质打印输出文件内容保持一致:
- [阿波罗11号制导计算机AGC中指令模块打印输出][8] - [阿波罗 11 号制导计算机AGC中指令模块打印输出][8]
- [阿波罗11号制导计算机AGC中登月模块打印输出][9] - [阿波罗 11 号制导计算机AGC中登月模块打印输出][9]
## 有用的扩展 ## 有用的扩展
GitHub内建支持AGC汇编语言语法。不幸的是你的代码编辑器不会,但有些 GitHub 内建支持 AGC 汇编语言语法。不幸的是,你的代码编辑器并不支持,但有些
AGC的语言扩展插件可以为下列的编辑器提供语法高亮显示支持: AGC 语言的扩展插件可以为下列的编辑器提供语法高亮显示支持:
- [Atom][Atom]† - [Atom][Atom]†
- [CodeBlocks][CodeBlocks] - [CodeBlocks][CodeBlocks]
@ -46,7 +46,7 @@ AGC的语言扩展插件可以为下列的编辑器提供语法高亮显示支
- [Visual Studio Code][VisualStudioCode]† - [Visual Studio Code][VisualStudioCode]†
- [jEdit][jEdit] - [jEdit][jEdit]
Supports automatic formatting 符号表示支持自动格式化
[Atom]:https://github.com/Alhadis/language-agc [Atom]:https://github.com/Alhadis/language-agc
[CodeBlocks]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/CodeBlocks [CodeBlocks]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/CodeBlocks
@ -61,10 +61,10 @@ AGC的语言扩展插件可以为下列的编辑器提供语法高亮显示支
## 格式化 ## 格式化
**注意**GitHub和上面列出的3个扩展插件会确保您自动使用正确的格式。 **注意**GitHub 和上面列出的3个扩展插件会确保您自动使用正确的格式。
- 使用TAB进行缩进 - 使用 TAB 进行缩进
- TAB宽度为8个字符 - TAB 宽度为 8 个字符
- 去掉末尾的空格 - 去掉末尾的空格
## 我该怎么检查? ## 我该怎么检查?
@ -73,18 +73,18 @@ AGC的语言扩展插件可以为下列的编辑器提供语法高亮显示支
### 注释 ### 注释
- 转录代码中的注释应与扫描完全匹配 - 转录代码中的注释应与扫描完全匹配
- 这可能涉及故意创建的拼写错误或删除/添加整个评论 - 这可能涉及故意创建的拼写错误或删除/添加整个评论
### 换行 ### 换行
- 第1列带`R0000`的换行符应与扫描完全匹配。 - 第 1 ** `R0000` 的换行符应与扫描完全匹配。
- 第1列中带**__out__* `R0000` 的换行符应该只包含一个或2个连续空行。 - 第 1 列 *不**__带__* `R0000` 的换行符应该只包含 1 个或 2 个连续空行。
- 如果有超过2个空行换行请删除额外的空白行换行。 - 如果有超过 2 个空行换行,请删除额外的空白行换行。
- 第1列中带`R0000`的行不计入此。 - 第 1 列中带 `R0000` 的行不计入此。
- 在原始图片中,这些是由一个未打印的数字分8列创建. A 2 处强制两个空格单个空白行A 3 强制三个空格双空行。值4-8是被定义但从未使用过。可在[#159][7]查看更多 - 在原始图片中,这些是由一个未打印的数字分 8 列创建。A 2 处强制两个空格单个空白行A 3 处强制三个空格(双空行)。值 4-8 被定义但从未使用过。可在 [#159][7] 查看细节
例如以下内容: 例如以下内容
```plain ```plain
R0819 SUBROUTINE TO SKIP... R0819 SUBROUTINE TO SKIP...
@ -95,7 +95,7 @@ R0820
0821 LAMPTEST CS IMODES33 0821 LAMPTEST CS IMODES33
``` ```
应该改为: 应该改为
```plain ```plain
R0819 SUBROUTINE TO SKIP... R0819 SUBROUTINE TO SKIP...
@ -107,19 +107,19 @@ R0820
### 空格 ### 空格
- 字符串中两个字符之间的空格应遵循以下约定 (可在 [#316][10]查阅相关讨论): - 字符串中两个字符之间的空格应遵循以下约定 (可在 [#316][10] 查阅相关讨论)
- 新单词另起一个空格. - 新单词另起一个空格.
- 新句另起两个空格. - 新句另起两个空格.
- 缩进占三个空格. - 缩进占三个空格.
例如以下内容: 例如以下内容
```plain ```plain
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO. GARPLY, WALDO.
``` ```
应该改为: 应该改为
```plain ```plain
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
@ -128,7 +128,7 @@ R0820
## 谨记 ## 谨记
制作PR之前请确保您的更改与原始的扫描打印输出一致! 提交 PR 之前,请确保您的更改与原始的扫描件打印输出一致!
[0]:https://github.com/chrislgarry/Apollo-11/pull/new/master [0]:https://github.com/chrislgarry/Apollo-11/pull/new/master
[1]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ [1]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/

View File

@ -1,4 +1,4 @@
# 阿波罗11号 # 阿波罗 11
[![NASA][1]][2] [![NASA][1]][2]
[![SWH]][SWH_URL] [![SWH]][SWH_URL]
@ -54,44 +54,48 @@
[ZH_TW]:README.zh_tw.md [ZH_TW]:README.zh_tw.md
[NL]:README.nl.md [NL]:README.nl.md
阿波罗11号制导计算机AGC中指令模块Comanche055和登月模块Luminary099原始代码。由[虚拟 AGC][3] 和 [MIT 科学博物馆][4] 的伙计们完成电子化。本仓库存在的目的是存储阿波罗11号原始代码。当然倘若在本仓库或原始代码扫描件[Luminary 099][5] 及 [Comanche 055][6] 发现问题或者任何我可能漏掉的文件欢迎提交PRs。 阿波罗 11 号制导计算机AGC中指令模块Comanche055和登月模块Luminary099原始代码。由 [虚拟 AGC][3] 和 [MIT 科学博物馆][4] 的伙计们完成电子化。本仓库存在的目的是存储阿波罗 11 号原始代码。当然,倘若在本仓库或原始代码扫描件 [Luminary 099][5] 及 [Comanche 055][6] 发现问题,或者任何我可能漏掉的文件,欢迎提交 PR。
## 贡献
在提交 pull request 之前,请先阅读 [CONTRIBUTING.zh_cn.md][7]。
## 编译 ## 编译
如果对编译原始代码有兴趣的话,请查阅 [虚拟 AGC][8] 的文档。 如果对编译原始代码有兴趣的话,请查阅 [虚拟 AGC][8] 的文档。
## 贡献 ## 归属
  |     |  
:---------- | :----- :---------- | :-----
版权 | 公共领域。 版权 | 公共领域。
Comanche055 | 阿波罗11号制导计算机AGC中的指令模块CM, Colossus 2A的部分源代码<br>`Assemble revision 055 of AGC program Comanche by NASA`<br>`2021113-051. 10:28 APR. 1, 1969` Comanche055 | 阿波罗 11 号制导计算机AGC中的指令模块CM, Colossus 2A 的部分源代码<br>`Assemble revision 055 of AGC program Comanche by NASA`<br>`2021113-051. 10:28 APR. 1, 1969`
Luminary099 | 阿波罗11号制导计算机AGC中的登月模块LM, Luminary 1A的部分源代码<br>`Assemble revision 001 of AGC program LYM99 by NASA`<br>`2021112-061. 16:27 JUL. 14, 1969` Luminary099 | 阿波罗 11 号制导计算机AGC中的登月模块LM, Luminary 1A 的部分源代码<br>`Assemble revision 001 of AGC program LYM99 by NASA`<br>`2021112-061. 16:27 JUL. 14, 1969`
汇编程序 | yaYUL 汇编程序 | yaYUL
联系人 | Ron Burkey <info@sandroid.org> 联系人 | Ron Burkey <info@sandroid.org>
网站 | www.ibiblio.org/apollo 网站 | www.ibiblio.org/apollo
数字化 | 该源代码从MIT 科学博物馆的印刷本电子化图片抄录、改编而来。电子化工作由 Paul Fjeld 完成,并由该馆的 Deborah Douglas 进一步整理。由衷地感激两位。 数字化 | 该源代码从 MIT 科学博物馆的印刷本电子化图片抄录、改编而来。电子化工作由 Paul Fjeld 完成,并由该馆的 Deborah Douglas 进一步整理。由衷地感激两位。
### 协议与许可 ### 协议与许可
*派生于 [CONTRACT_AND_APPROVALS.agc]* *派生于 [CONTRACT_AND_APPROVALS.agc]*
本 AGC 程序亦可称为: Colossus 2A 本 AGC 程序亦可称为Colossus 2A
根据第 R-577 报告,本程序被用于指令模块。本程序是在 DSR 项目 55-23870 下编写的。该项目由(美国)国家航空航天局载人航天中心与位于马萨诸塞州剑桥的麻省理工学院 The Instrumentation Laboratory 实验室签属的第 NAS 9-4065 号合同进行资助。 根据第 R-577 报告,本程序被用于指令模块。本程序是在 DSR 项目 55-23870 下编写的。该项目由(美国)国家航空航天局载人航天中心与位于马萨诸塞州剑桥的麻省理工学院 The Instrumentation Laboratory 实验室签属的第 NAS 9-4065 号合同进行资助。
提交者 | Role | 日期 提交者 | Role | 日期
:------------------- | :--- | :-- :------------------- | :--- | :--
Margaret H. Hamilton | Colossus 程序设计负责人<br>阿波罗制导 | 1969年3月28日 Margaret H. Hamilton | Colossus 程序设计负责人<br>阿波罗制导 | 1969 3 28
核准人 | Role | 日期 核准人 | Role | 日期
:---------------- | :--- | :-- :---------------- | :--- | :--
Daniel J. Lickly | 负责人、任务程序开发<br>阿波罗制导程序 | 1969年3月28日 Daniel J. Lickly | 负责人、任务程序开发<br>阿波罗制导程序 | 1969 3 28
Fred H. Martin | Colossus 项目经理<br>阿波罗制导程序 | 1969年3月28日 Fred H. Martin | Colossus 项目经理<br>阿波罗制导程序 | 1969 3月 28
Norman E. Sears | 负责人、任务开发<br>阿波罗制导程序 | 1969年3月28日 Norman E. Sears | 负责人、任务开发<br>阿波罗制导程序 | 1969 3 28
Richard H. Battin | 负责人、任务开发<br>阿波罗制导程序 | 1969年3月28日 Richard H. Battin | 负责人、任务开发<br>阿波罗制导程序 | 1969 3 28
David G. Hoag | 负责人<br>阿波罗制导程序 | 1969年3月28日 David G. Hoag | 负责人<br>阿波罗制导程序 | 1969 3 28
Ralph R. Ragan | 副负责人<br>Instrumentation Laboratory | 1969年3月28日 Ralph R. Ragan | 副负责人<br>Instrumentation Laboratory | 1969 3 28
[CONTRACT_AND_APPROVALS.agc]:https://github.com/chrislgarry/Apollo-11/blob/master/Comanche055/CONTRACT_AND_APPROVALS.agc [CONTRACT_AND_APPROVALS.agc]:https://github.com/chrislgarry/Apollo-11/blob/master/Comanche055/CONTRACT_AND_APPROVALS.agc
[1]:https://flat.badgen.net/badge/NASA/Mission%20Overview/0B3D91 [1]:https://flat.badgen.net/badge/NASA/Mission%20Overview/0B3D91
@ -100,7 +104,7 @@ Ralph R. Ragan | 副负责人<br>Instrumentation Laboratory | 1969年3月28
[4]:http://web.mit.edu/museum/ [4]:http://web.mit.edu/museum/
[5]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ [5]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/
[6]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/ [6]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/
[7]:https://github.com/chrislgarry/Apollo-11/blob/master/CONTRIBUTING.md [7]:https://github.com/chrislgarry/Apollo-11/blob/master/CONTRIBUTING.zh_cn.md
[8]:https://github.com/rburkey2005/virtualagc [8]:https://github.com/rburkey2005/virtualagc
[SWH]:https://flat.badgen.net/badge/Software%20Heritage/Archive/0B3D91 [SWH]:https://flat.badgen.net/badge/Software%20Heritage/Archive/0B3D91
[SWH_URL]:https://archive.softwareheritage.org/browse/origin/https://github.com/chrislgarry/Apollo-11/ [SWH_URL]:https://archive.softwareheritage.org/browse/origin/https://github.com/chrislgarry/Apollo-11/