diff --git a/CONTRIBUTING.zh_cn.md b/CONTRIBUTING.zh_cn.md index 71f0922..3bdfefb 100644 --- a/CONTRIBUTING.zh_cn.md +++ b/CONTRIBUTING.zh_cn.md @@ -1,4 +1,4 @@ -# Contributing +# 贡献 🎌 [Deutsch][DE], @@ -27,13 +27,13 @@ 本仓库中的源代码来自对纸质打印输出文件的手动数字化,所以会不小心引入一些拼写错误和其他差异。这些代码应该被修正以使其与原纸质打印输出文件内容保持一致: -- [阿波罗11号制导计算机(AGC)中指令模块打印输出][8] -- [阿波罗11号制导计算机(AGC)中登月模块打印输出][9] +- [阿波罗 11 号制导计算机(AGC)中指令模块打印输出][8] +- [阿波罗 11 号制导计算机(AGC)中登月模块打印输出][9] ## 有用的扩展 -GitHub内建会支持AGC汇编语言语法。不幸的是,你的代码编辑器不会,但有些 -AGC的语言扩展插件可以为下列的编辑器提供语法高亮显示支持: +GitHub 内建支持 AGC 汇编语言语法。不幸的是,你的代码编辑器并不支持,但有些 +AGC 语言的扩展插件可以为下列的编辑器提供语法高亮显示支持: - [Atom][Atom]† - [CodeBlocks][CodeBlocks] @@ -46,7 +46,7 @@ AGC的语言扩展插件可以为下列的编辑器提供语法高亮显示支 - [Visual Studio Code][VisualStudioCode]† - [jEdit][jEdit] -† Supports automatic formatting +† 符号表示支持自动格式化 [Atom]:https://github.com/Alhadis/language-agc [CodeBlocks]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/CodeBlocks @@ -61,10 +61,10 @@ AGC的语言扩展插件可以为下列的编辑器提供语法高亮显示支 ## 格式化 -**注意**:GitHub和上面列出的3个扩展插件会确保您自动使用正确的格式。 +**注意**:GitHub 和上面列出的3个扩展插件会确保您自动使用正确的格式。 -- 使用TAB进行缩进 -- TAB宽度为8个字符 +- 使用 TAB 进行缩进 +- TAB 宽度为 8 个字符 - 去掉末尾的空格 ## 我该怎么检查? @@ -73,18 +73,18 @@ AGC的语言扩展插件可以为下列的编辑器提供语法高亮显示支 ### 注释 -- 转录代码中的注释应与扫描完全匹配 +- 转录代码中的注释应与扫描件完全匹配 - 这可能涉及故意创建的拼写错误或删除/添加整个评论 ### 换行 -- 第1列带`R0000`的换行符应与扫描完全匹配。 -- 第1列中带**__out__* `R0000` 的换行符应该只包含一个或2个连续空行。 - - 如果有超过2个空行换行,请删除额外的空白行换行。 - - 第1列中带`R0000`的行不计入此。 - - 在原始图片中,这些是由一个未打印的数字分8列创建. A 2 处强制两个空格(单个空白行),A 3 强制三个空格(双空行)。值4-8是被定义但从未使用过。可在[#159][7]查看更多 +- 第 1 列 *带* `R0000` 的换行符应与扫描件完全匹配。 +- 第 1 列 *不**__带__* `R0000` 的换行符应该只包含 1 个或 2 个连续空行。 + - 如果有超过 2 个空行换行,请删除额外的空白行换行。 + - 第 1 列中带 `R0000` 的行不计入此。 + - 在原始图片中,这些是由一个未打印的数字分 8 列创建。A 2 处强制两个空格(单个空白行),A 3 处强制三个空格(双空行)。值 4-8 被定义但从未使用过。可在 [#159][7] 查看细节 -例如以下内容: +例如以下内容: ```plain R0819 SUBROUTINE TO SKIP... @@ -95,7 +95,7 @@ R0820 0821 LAMPTEST CS IMODES33 ``` -应该改为: +应该改为: ```plain R0819 SUBROUTINE TO SKIP... @@ -107,19 +107,19 @@ R0820 ### 空格 -- 字符串中两个字符之间的空格应遵循以下约定 (可在 [#316][10]查阅相关讨论): +- 字符串中两个字符之间的空格应遵循以下约定 (可在 [#316][10] 查阅相关讨论): - 新单词另起一个空格. - 新句另起两个空格. - 缩进占三个空格. -例如以下内容: +例如以下内容: ```plain 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, GARPLY, WALDO. ``` -应该改为: +应该改为: ```plain 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 [1]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ diff --git a/README.zh_cn.md b/README.zh_cn.md index b5412a6..17eb2ea 100644 --- a/README.zh_cn.md +++ b/README.zh_cn.md @@ -1,4 +1,4 @@ -# 阿波罗11号 +# 阿波罗 11 号 [![NASA][1]][2] [![SWH]][SWH_URL] @@ -54,44 +54,48 @@ [ZH_TW]:README.zh_tw.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的部分源代码
`Assemble revision 055 of AGC program Comanche by NASA`
`2021113-051. 10:28 APR. 1, 1969` -Luminary099 | 阿波罗11号制导计算机(AGC)中的登月模块(LM), Luminary 1A的部分源代码
`Assemble revision 001 of AGC program LYM99 by NASA`
`2021112-061. 16:27 JUL. 14, 1969` +Comanche055 | 阿波罗 11 号制导计算机(AGC)中的指令模块(CM), Colossus 2A 的部分源代码
`Assemble revision 055 of AGC program Comanche by NASA`
`2021113-051. 10:28 APR. 1, 1969` +Luminary099 | 阿波罗 11 号制导计算机(AGC)中的登月模块(LM), Luminary 1A 的部分源代码
`Assemble revision 001 of AGC program LYM99 by NASA`
`2021112-061. 16:27 JUL. 14, 1969` 汇编程序 | yaYUL 联系人 | Ron Burkey 网站 | www.ibiblio.org/apollo -数字化 | 该源代码从MIT 科学博物馆的印刷本电子化图片抄录、改编而来。电子化工作由 Paul Fjeld 完成,并由该馆的 Deborah Douglas 进一步整理。由衷地感激两位。 +数字化 | 该源代码从 MIT 科学博物馆的印刷本电子化图片抄录、改编而来。电子化工作由 Paul Fjeld 完成,并由该馆的 Deborah Douglas 进一步整理。由衷地感激两位。 ### 协议与许可 *派生于 [CONTRACT_AND_APPROVALS.agc]* -本 AGC 程序亦可称为: Colossus 2A +本 AGC 程序亦可称为:Colossus 2A 根据第 R-577 报告,本程序被用于指令模块。本程序是在 DSR 项目 55-23870 下编写的。该项目由(美国)国家航空航天局载人航天中心与位于马萨诸塞州剑桥的麻省理工学院 The Instrumentation Laboratory 实验室签属的第 NAS 9-4065 号合同进行资助。 提交者 | Role | 日期 :------------------- | :--- | :-- -Margaret H. Hamilton | Colossus 程序设计负责人
阿波罗制导 | 1969年3月28日 +Margaret H. Hamilton | Colossus 程序设计负责人
阿波罗制导 | 1969 年 3 月 28 日 核准人 | Role | 日期 :---------------- | :--- | :-- -Daniel J. Lickly | 负责人、任务程序开发
阿波罗制导程序 | 1969年3月28日 -Fred H. Martin | Colossus 项目经理
阿波罗制导程序 | 1969年3月28日 -Norman E. Sears | 负责人、任务开发
阿波罗制导程序 | 1969年3月28日 -Richard H. Battin | 负责人、任务开发
阿波罗制导程序 | 1969年3月28日 -David G. Hoag | 负责人
阿波罗制导程序 | 1969年3月28日 -Ralph R. Ragan | 副负责人
Instrumentation Laboratory | 1969年3月28日 +Daniel J. Lickly | 负责人、任务程序开发
阿波罗制导程序 | 1969 年 3 月 28 日 +Fred H. Martin | Colossus 项目经理
阿波罗制导程序 | 1969 年 3月 28 日 +Norman E. Sears | 负责人、任务开发
阿波罗制导程序 | 1969 年 3 月 28 日 +Richard H. Battin | 负责人、任务开发
阿波罗制导程序 | 1969 年 3 月 28 日 +David G. Hoag | 负责人
阿波罗制导程序 | 1969 年 3 月 28 日 +Ralph R. Ragan | 副负责人
Instrumentation Laboratory | 1969 年 3 月 28 日 [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 @@ -100,7 +104,7 @@ Ralph R. Ragan | 副负责人
Instrumentation Laboratory | 1969年3月28 [4]:http://web.mit.edu/museum/ [5]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ [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 [SWH]:https://flat.badgen.net/badge/Software%20Heritage/Archive/0B3D91 [SWH_URL]:https://archive.softwareheritage.org/browse/origin/https://github.com/chrislgarry/Apollo-11/