Apollo-11 贡献指南:AGC 源码与扫描件校对的完整操作规范(日文版解读)

发布时间:2026/9/30 2:04:59
Apollo-11 贡献指南:AGC 源码与扫描件校对的完整操作规范(日文版解读) 嵌入式固件【免费下载链接】Apollo-11Original Apollo 11 Guidance Computer (AGC) source code for the command and lunar modules.项目地址https://gitcode.com/GitHub_Trending/ap/Apollo-11点击查看免费下载本篇指南以仓库官方贡献文档 CONTRIBUTING.ja.md日文版为骨架系统讲解 Apollo-11 仓库的 AGCApollo Guidance Computer源码数字化校对规范包括格式化要求、注释与扫描件的逐字符比对规则、R0000序列号行的断行处理以及可用编辑器扩展清单。读完本篇你将能够按照官方标准参与校对 Pull Request为阿波罗 11 号制导计算机源码的保真度贡献力量。仓库背景与校对工作的意义Apollo-11 仓库保存的是阿波罗 11 号指挥舱Command ModuleComanche 055与登月舱Lunar ModuleLuminary 099的 AGC 原始汇编源码。根据 README.md 与各源码文件头部如 Comanche055/EXECUTIVE.agc的说明这些代码由 Virtual AGC 团队与 MIT Museum 从纸质打印件手工数字化而来使用 yaYUL 汇编器汇编。正因为是手工转录逐字校对是保证历史资料保真度的核心工作。注意本仓库的.agc文件本身不含R0000这类序列号行——它们只存在于原始扫描打印件中。校对者需要在扫描件与转录文件之间来回比对可用 https://28gpc.csb.app/ 网站快速浏览 Comanche 与 Luminary 的扫描件。格式化规范与扫描件严格一致所有.agc文件必须遵循以下格式化规则GitHub 与下文列出的扩展会自动帮助你保持正确格式使用制表符Tab缩进制表符宽度为 8删除行尾空白Trailing whitespace格式化规范与校对规则共同构成了「与扫描件一致」这一总目标的两个方面前者保证可读性与一致性后者保证内容准确性。校对工作流我应该检查什么校对的唯一任务就是找出扫描件与仓库源码之间的任何不一致之处。具体检查点分为注释、空格和断行三大部分。注释必须与扫描件「精确」一致注释是校对中最严格的部分——转录代码中的注释必须与扫描件完全一致MUST match exactly。日常校对的常见问题包括但不限于误植Typographic Errors原始开发者在写注释时本身就存在拼写错误最初的数字化过程有些地方「好心」把这些错误改正了而数字化本身又引入了扫描件中本不存在的错误。校对规则是以扫描件为唯一真相例如如果数字化后的注释是SPACECRAFT而扫描打印件上是SPAECRAFT缺少C那么数字化版本必须改正为SPAECRAFT反之如果数字化版本中有拼写错误、而扫描件拼写正确则必须把数字化版本修正为正确的拼写。也就是说注释的拼写以扫描件为准无论对错。空格与扫描件保持一致注释中任意两个字符之间的空格数应当SHOULD与扫描件匹配。多数情况下参见仓库 PR #316 的讨论遵循以下惯例1 个空格用于分隔新单词2 个空格用于新句子的开头3 个空格用于缩进。需要注意扫描件并非每一页都遵循这一泛化规则。如果扫描件只有 1 个空格而非 2 个空格那就使用 1 个空格——以扫描件实际显示为准。断行Line Breaks与R0000序列号断行规则是本文档最具技术特色的部分它涉及 AGC 打印件中独特的序列号系统列 1 包含R0000的断行必须与扫描件精确一致列 1 不含R0000的断行连续空行只允许 1 或 2 行即空白行不超过 2 行如果出现 2 个以上的连续空行删除多余的断行列 1 包含R0000的行不计入空行统计在原始扫描图像中这些断行由第 8 列的未打印数字控制数字 2 强制双倍行距产生 1 个空行数字 3 强制三倍行距产生 2 个空行数字 4–8 虽被定义但从未使用详见仓库 issue #159。断行修正示例原始错误状态——R0821处有 3 个空行且行号从R0820跳到0821R0819 SUBROUTINE TO SKIP... R0820 0821 LAMPTEST CS IMODES33应修正为——R0820后只保留 2 个空行且连续行号恢复到0820R0819 SUBROUTINE TO SKIP... R0820 0820 LAMPTEST CS IMODES33这个例子同时展示了「删多余空行」与「行号序列连续」两条规则的应用。实用开发工具AGC 语法高亮扩展GitHub 内置了对 AGC 汇编语言的语法支持但大多数本地代码编辑器默认没有。下列编辑器可通过对应的 AGC 语言扩展获得语法高亮标†的扩展还支持自动格式化编辑器扩展自动格式化Atomlanguage-agc†CodeBlocksVirtual AGC 贡献包EclipseVirtual AGC 贡献包KateVirtual AGC 贡献包ProgrammersNotepadVirtual AGC 贡献包Sublime Text 3AGC-Assembly†TextPadVirtual AGC 贡献包Vimvim-assemblyVisual Studio Codeagc-assembly†jEditVirtual AGC 贡献包对于 Visual Studio Code 用户agc-assembly扩展还提供了可自定义的用户设置见其 user settings可进一步控制高亮与自动格式化行为配合上文「制表符宽度 8」的规范使用效果最佳。提交前自查清单在创建 Pull Request 之前请务必确认代码使用 Tab 缩进、Tab 宽度为 8、无行尾空白所有注释与扫描件逐字符精确一致包括原始误植也保留注释内空格数与扫描件一致新词 1 格、新句 2 格、缩进 3 格以扫描件实际为准含R0000的行完整保留且与扫描件断行一致不含R0000的位置空行不超过 2 行R序列号保持连续。遵循以上流程即可确保你提交的改动与原始 AGC 扫描件保持一致为这份人类登月工程的珍贵源码贡献一份可靠的校对成果。赞分享嵌入式固件【免费下载链接】Apollo-11Original Apollo 11 Guidance Computer (AGC) source code for the command and lunar modules.项目地址https://gitcode.com/GitHub_Trending/ap/Apollo-11点击查看免费下载相关推荐Gutenberg FormTokenField 深度解析:带自动补全的令牌字段组件、Props 全解与键盘可访问性实现Gutenberg FormTokenField 深度解析:带自动补全的令牌字段组件、Props 全解与键盘可访问性实现 本篇围绕 Gutenberg 仓库 p嵌入式固件Apollo-11 仓库 AGC 汇编源码的转录校对与贡献规范让扫描件与代码逐字符一致Apollo 11 仓库 AGC 汇编源码的转录校对与贡献规范让扫描件与代码逐字符一致 本指南基于 Apollo 11 仓库官方贡献文档整理系统讲解 Com嵌入式固件OpenReel Video 音频效果全解均衡器、压缩器、混响、延迟与失真完整使用指南OpenReel Video 音频效果全解均衡器、压缩器、混响、延迟与失真完整使用指南 OpenReel Video 是一款 100% 基于浏览器的开源视频编嵌入式固件上一篇dcm2niix医学影像转换工具从DICOM到NIfTI的完整指南 下一篇多图片与OCR文档场景InternVL3_5-4B-HF图像理解能力全清单实测创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考