Oberon/贡献
任何进度都是受欢迎的。更正语法和算法中的错误。在讨论页面中提出未经完善的想法。
维基教科书中的源代码可以使用支持 HTTPS 的浏览器直接编辑。或者,它可以在 Oberon 系统上编辑,使用 MediaWiki.Markup 翻译,并应用于替换现有版本,例如添加新模块时。如果要替换,请注意避免覆盖先前的编辑。页面最新版本应被检索到一个工作的 Oberon 系统,并使用 Diff.Do 进行比较。或者,注册用户可以在用户沙盒中放置一个新版本,并应用 MediaWiki 比较功能。请注意,从书籍检索到新版本安装之间非零的时间间隔会导致 编辑冲突。
- 从发布版本初始化模块或工具页面。最好是最新的版本。例如,Oberon.Sort.Mod 取自 UnixA2 中的 Oberon 子系统。在维基编辑主题行中指示来源。
- 使用 Oberon 命名约定。
- 避免页面重复。如果两个系统共享一个源模块,页面重定向优先于重复页面。
- 如果意外创建了编辑冲突,请修复它。
- 避免中断编译。
- 避免中断接口。如果接口发生更改,请调整所有连接到它的模块。在讨论页面中清晰表达的想法优先于中断的接口。
- 避免中断功能。
- 避免引入错误。如果引入了错误,即使改进意图再出色,更改也可能会被还原。
- 更喜欢最新的语法而不是旧的语法。删除 LOOP。在可能的情况下,删除 RETURN。
添加文本是 文本的数据流图 中的前两个步骤。第一步由贡献者执行。第二步由 MediaWiki 服务器自动执行。检索 MediaWiki 模块 (ETH Oberon,A2 的 Oberon 子系统) 到你的 Oberon 系统并编译它。用要贡献的模块打开一个查看器,并 * 标记文本。使用 "MediaWiki.Markup * " 翻译为 MediaWiki 标记,并使用 Edit.StoreAscii 或 ET.StoreAscii 保存 <Module>.Mod.mw。
要将页面添加到书籍,需要使用支持 HTTPS 的浏览器;ETH Oberon 中的 Desktops.OpenDoc 不足。建议登录到一个 Wikimedia 帐户。在现有页面中的某个地方添加要添加页面的名称,预览并“发布更改”。新条目将以红色显示。点击它打开新页面。初始化新页面,预览并“发布更改”。
存在各种格式化约定和偏好。参考 Oberon 邮件列表,2017 年 7 月 22 日至 7 月 26 日,并搜索“缩进?”。没有特定的格式是必不可少的。贡献者喜欢的任何合理的格式都是受欢迎的。
也存在各种风格约定。参考 Oberon 邮件列表,2017 年 7 月 29 日至 7 月 30 日,并搜索“斜体”。A2 中的 PET 等编辑器以及列表中提到的“漂亮打印机”会自动设置源代码文本的样式以突出显示语法。因此,直接语法设置可能是多余的。用于区分修订的颜色是可选的,而且相对无害。