原文链接 : http://zeppelin.apache.org/docs/0.7.2/development/howtocontributewebsite.html

译文链接 : http://cwiki.apachecn.org/pages/viewpage.action?pageId=10031123

贡献者 : 小瑶 ApacheCN Apache中文网

本页将给您概述如何构建和贡献 Apache Zeppelin 的文档。 zeppelin.apache.org 上的在线文档也是从这里找到的文件生成的。

注意

Apache Zeppelin 是 Apache2 license 软件。对 Zeppelin （源代码，文档，图像，网站）的任何贡献意味着您同意许可协议作为 Apache2 license。

Getting the source code ( 获取源代码 )

首先，您需要 Zeppelin 源代码。 Zeppelin 的官方位置是 http://git.apache.org/zeppelin.git 。文档网站托管在 / docs / dir 下的 'master' 分支中。

git access ( git 访问 )

首先，您需要网站源代码。 Zeppelin 镜像的官方位置是 http://git.apache.org/zeppelin.git 。使用 git 获取开发机器上的源代码。

  1. git clone git://git.apache.org/zeppelin.git
  2. cd docs

Apache Zeppelin 遵循 Fork&Pull 作为源代码管理工作流程。如果您不仅要构建 Zeppelin ，还可以进行任何更改，那么您需要 fork Zeppelin github 镜像存储库 并进行 pull 请求。

Build ( 构建 )

您需要安装一些先决条件来构建代码。请参阅 docs / README.md 中的Build 文档 部分。

Run website in development mode ( 在开发模式下运行网站 )

在修改网站时，您可能希望看到它的预览。请参阅docs/README.md 中的 运行网站 部分。然后，您可以使用网络浏览器访问 http：// localhost：4000 。

Making a Pull Request ( 提出 Pull 请求 )

当你准备好了，只需做一个 pull-request 。

Alternative way ( 替代方式 )

您可以直接在 /docs/ 目录中编辑 github 的 Web 界面上的 .md 文件，并立即执行 pull-request 。

Stay involved ( 保持参与 )

贡献者应该加入Zeppelin mailing lists 。