apache-hive / 3.1.1 / reference / How_to_edit_the_website.html

如何编辑网站

Hive website为所有相关网站和有关 Apache Hive 项目的信息提供了一个中央门户。该 Wiki 提供了 Hive 文档,您可以按照AboutThisWiki页上的说明进行编辑。要编辑 Hive 网站,请按照此页面上基于Apache MRUnit 的说明的说明进行操作。该网站使用 Apache CMS。 Apache 基础结构页面上提供了更详细的文档,包括Apache bookmarkletreference manual上的快速入门指南。例如,查看其他 Apache CMS 网站也很有用。

Website Changes Require Review

Apache Hive 需要对网站的更改进行审查。

Process

buildsite/build_site.pl --source-base hive-site --target-base hive-website

如果删除文件或更改文件名,请对 lib/path.pm 或 lib/view.pm 进行少量编辑,以强制进行完整的站点重建。如果进行简单的编辑,则只需使用 Apache 书签即可。

  • await 几分钟,以获取 buildbot 重建staging website的提交列表上的电子邮件。

  • 如果更改看起来可以,请通过以下方法之一将更改提交到生产网站:

  • 使用 Apache 小书签并选择Publish site

  • curl -sL http://s.apache.org/cms-cli |在本地计算机上运行 perl

  • ssh -t<user> @ people.apache.org publish.pl mrunit<your Apache ID>

发布生成的内容

  • 将相对于 extpaths.txt 文件的路径添加到 content/extpaths.txt 中,以防止在发布临时站点时删除内容

  • 将生成的内容直接提交到SVN 生产 site

Style

  • 尝试将行长限制为 80 列,在 Linux 上使用 fold -s<filename>有助于限制行长

  • 使用[link name] []样式的链接,而不要使用[link name] [1],因为匹配数字更加困难,并且删除链接会导致所有数字必须更新

  • 缩进而不是制表符

  • 使用*表示列表,并将列表缩进 2 个空格