Added: kylin/site/cn/development40/howto_contribute.html
URL: 
http://svn.apache.org/viewvc/kylin/site/cn/development40/howto_contribute.html?rev=1891303&view=auto
==============================================================================
--- kylin/site/cn/development40/howto_contribute.html (added)
+++ kylin/site/cn/development40/howto_contribute.html Tue Jul  6 07:50:56 2021
@@ -0,0 +1,997 @@
+<!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<!doctype html>
+<html>
+       <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+
+  <title>Apache Kylin | 如何贡献</title>
+  <meta name="description" content="Apache Kylin Home">
+  <meta name="author"      content="Apache Kylin">
+  <link rel="shortcut icon" href="fav.png" type="image/png">
+
+
+
+<link rel="stylesheet" href="/assets/css/animate.css">
+<!-- Bootstrap -->
+<link rel="stylesheet" href="/assets/css/bootstrap.min.css">
+
+<!-- Fonts -->
+<!-- <link rel="stylesheet" 
href="http://fonts.googleapis.com/css?family=Alice|Open+Sans:400,300,700"> -->
+
+<!-- Icons -->
+<link rel="stylesheet" href="/assets/css/font-awesome.min.css">
+
+  <!-- Custom styles -->
+  <link rel="stylesheet" href="/assets/css/styles.css">
+  <link rel="stylesheet" href="/assets/css/docs.css">
+
+  <link rel="canonical" 
href="http://kylin.apache.org/cn/development40/howto_contribute.html";>
+  <link rel="alternate" type="application/rss+xml" title="Apache Kylin" 
href="http://kylin.apache.org/feed.xml"; />
+
+<!--[if lt IE 9]> <script src="assets/js/html5shiv.js"></script> <![endif]-->
+<!-- Global site tag (gtag.js) - Google Analytics -->
+<script async 
src="https://www.googletagmanager.com/gtag/js?id=UA-120788561-1";></script>
+<script>
+  window.dataLayer = window.dataLayer || [];
+  function gtag(){dataLayer.push(arguments);}
+  gtag('js', new Date());
+
+  gtag('config', 'UA-120788561-1');
+</script>
+<script type="text/javascript" src="/assets/js/jquery-1.9.1.min.js"></script>
+<script type="text/javascript" src="/assets/js/nside.js"></script> </script>
+<script type="text/javascript" src="/assets/js/nnav.js"></script> </script>
+<script>
+var _hmt = _hmt || [];
+(function() {
+  var hm = document.createElement("script");
+  hm.src = "https://hm.baidu.com/hm.js?bdc5e03add430c0b72cc0eb91eabfa99";;
+  var s = document.getElementsByTagName("script")[0]; 
+  s.parentNode.insertBefore(hm, s);
+})();
+</script>
+</head>
+
+       <body>
+               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<header id="header" >
+  <!-- Main Menu -->
+  <nav class="navbar navbar-default" role="navigation" id="nav-wrapper">
+    <div class="container-fluid" id="nav">
+      <!-- Brand and toggle get grouped for better mobile display -->
+      <div class="navbar-header">
+        <img class="navbar-logo" width="46" src="/assets/images/kylin_logo.png 
"></img> 
+        
+        <button type="button" class="navbar-toggle collapsed" 
data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+          <span class="sr-only">Toggle navigation</span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+        </button>
+        <ul class="nav icon-navbar">
+            <li><a href="https://twitter.com/apachekylin"; target="_blank" 
class="fa fa-twitter fa-lg"  title="Twitter: @ApacheKylin" ></a></li>
+            <li><a href="https://github.com/apache/kylin"; target="_blank" 
class="fa fa-github-alt fa-lg" title="Github: apache/kylin" ></a></li>          
+            <li><a href="https://www.facebook.com/kylinio"; target="_blank" 
class="fa fa-facebook fa-lg" title="Facebook: kylin.io" ></a></li>    
+        </ul>
+      </div>
+
+      <!-- Collect the nav links, forms, and other content for toggling -->
+      <div class="navbar-collapse collapse" id="bs-example-navbar-collapse-1">
+        <ul class="nav navbar-nav">
+            <li><a href="/cn">首页</a></li>
+            <li><a href="/cn/docs" >文档</a></li>
+            <li><a href="/cn/download">下载</a></li>
+            <li><a href="/cn/community" >社区</a></li>
+            <li><a href="/cn/development" >开发</a></li>
+            <li><a href="/cn/blog">博客</a></li>
+            <li><a href="/" >English</a></li>           
+        </ul>
+        
+
+      </div><!-- /.navbar-collapse -->
+    </div><!-- /.container-fluid -->
+  </nav>
+
+  <div id="head" class="parallax normal-header" >
+    <div class="text-center header-apache">
+      <a href="http://apache.org/foundation/contributing.html"; title="Support 
Apache" style="margin-left: 150px;">
+        <div>
+          <img src="https://www.apache.org/images/SupportApache-small.png";>
+        </div>
+      </a>
+    </div>  
+  </div>
+
+ </header>
+
+               
+               <div class="container">
+                       <div class="row"  style="clear:both;">
+                               
+                               <div class="col-md-8 col-lg-8 col-xs-12 
col-sm-12 aside2" style="float: right;">
+                                       <div id="container" class="docs">
+                                               <div id="pjax">
+                                                       <h1 
class="post-title">如何贡献</h1>
+                                                       <article 
class="post-content" >
+                                                       <p>Apache Kylin 
一直寻求的不只是代ç 
çš„贡献,还寻求使用文档,性能报告,问答等方面的贡献。所有类型的贡献都为成为
 Kylin Committer 铺平了道路。每个人都有机会,尤å…
¶æ˜¯é‚£äº›æœ‰åˆ†æžå’Œè§£å†³æ–¹æ¡ˆèƒŒæ™¯çš„,因
为缺少来自于用户和解决方案视角的内容。</p>
+
+<h2 id="section">源分支</h2>
+<p>代码和文档都在 Git 源代ç 
æŽ§åˆ¶ä¹‹ä¸‹ã€‚注意不同分支的用途。</p>
+
+<ul>
+  <li><code 
class="highlighter-rouge">master</code>:新功能的主开发分支</li>
+  <li><code class="highlighter-rouge">2.[n].x</code>:一些 2.x 
主要版本的维护分支</li>
+  <li><code class="highlighter-rouge">3.[n].x</code>:一些 3.x 
主要版本的维护分支</li>
+  <li><code class="highlighter-rouge">document</code>: 文档分支</li>
+</ul>
+
+<h2 id="section-1">组件及拥有者</h2>
+<p>Apache Kylin 有几
个子组件。为了更好地帮助社区的发展,我们为每个组件安排了一个或多个组件负责人。</p>
+
+<ul>
+  <li>
+    <p>组件负责人是志愿者
(组件领域的专家)。负责人需要成为 Apache Kylin 提交者或 
PMC。</p>
+  </li>
+  <li>
+    <p>负责人将尝试审查其组件范围内的补丁。</p>
+  </li>
+  <li>
+    <p>负责人可以根据他的愿望和社区需求进行轮换。</p>
+  </li>
+  <li>
+    <p>在提名或投票新提交者时,提名者
需要说明候选人可以成为哪个组件的负责人。</p>
+  </li>
+  <li>
+    <p>如果您已经是 Apache Kylin 提交者或 PMC 
成员并希望成为组件负责人的志愿者,请给 dev 
列表写信,我们将为您注册。</p>
+  </li>
+  <li>
+    <p>所有项目计划,决策仍由 Apache Kylin PMC 管理。</p>
+  </li>
+  <li>
+    <p>如果您认为组件列表需要更新(添加,删
除,重命名等),请给 dev 列表写信,我们将对其进行审æ 
¸ã€‚</p>
+  </li>
+</ul>
+
+<p>组件负责人列在了这个 Apache Kylin <a 
href="https://issues.apache.org/jira/projects/KYLIN?selectedItem=com.atlassian.jira.jira-projects-plugin:components-page";>JIRA
 components page</a> 页面中的 Description 字段位置。负责人列在 
“Description” 字段中而不是 “Component Lead” 字段中,因
为后者仅允许我们列出一个人,然而其鼓励组件å…
·æœ‰å¤šä¸ªè´Ÿè´£äººã€‚</p>
+
+<h2 id="section-2">选择一个任务</h2>
+<p>这里有新创建的任务等待被完成,由 JIRA 追踪。为了让å…
¶å®¹æ˜“被搜索,这里有一些过滤条件。</p>
+
+<ul>
+  <li>由李扬管理的<a 
href="https://issues.apache.org/jira/issues/?filter=12339895";>任务列表</a>。</li>
+  <li>由 Ted Yu 创建的<a 
href="https://issues.apache.org/jira/issues/?filter=12341496";>任务列表</a>,重要的小的
 bugs 且其中一些很容易被修复。</li>
+  <li>您也可以在 Kylin JIRA 中搜索标签 “newbie”。</li>
+</ul>
+
+<p>在做大任务之前别忘了在<a 
href="/community/index.html">邮箱列表</a>中讨论。</p>
+
+<p>如果为 bug 或功能创建了新的 
JIRA,请记住为社区提供足够的信息:</p>
+
+<ul>
+  <li>问题或功能的良好摘要</li>
+  <li>详细说明,可能包括:
+    <ul>
+      <li>这个问题发生的环境</li>
+      <li>重现问题的步骤</li>
+      <li>错误跟踪或日志文件(作为附件)</li>
+      <li>model 或 cube 的元数据</li>
+    </ul>
+  </li>
+  <li>相关组件:我们将根据此选择安排审核人员。</li>
+  <li>受影响的版本:您正在使用的 Kylin 版本。</li>
+</ul>
+
+<h2 id="section-3">进行代码更改</h2>
+<ul>
+  <li><a href="/cn/development40/dev_env.html">搭建开发环境</a></li>
+  <li>提出 JIRA,描述功能/提升/bug</li>
+  <li>在邮件列表或 issue 评论中与å…
¶ä»–人讨论,确保提议的更改符合其他人正在做的事情
以及为项目规划的内容</li>
+  <li>在您的 fork 中进行修改
+    <ul>
+      <li>目前没有严格的代码æ 
·å¼ï¼Œä½†ä¸€èˆ¬è§„则与现有文件保持一致。例如,对 java 
文件使用 4 空格缩进。</li>
+      <li>尽可能为代码更改添加测试用例。</li>
+      <li>确保 “mvn clean package” 和 “mvn test” 
能够获得成功。</li>
+      <li>充分的单元测试和集成测试是代码更改的必
要部分。</li>
+    </ul>
+  </li>
+  <li><a href="/cn/development40/howto_test.html">运行测试</a> 
以确保您的更改质量良好且不会破坏任何内
容。如果您的补丁生成不正确或您的代码不符合代ç 
æŒ‡å—,则可能会要求您重做某些工作。</li>
+  <li>生成补丁并将其附加到相关的 JIRA。</li>
+</ul>
+
+<h2 id="patch">生成 Patch</h2>
+<ul>
+  <li>使用 <code 
class="highlighter-rouge">submit-patch.py</code>(推荐)创建 
patches,上传到 jira 并可选择在 Review Board 上创建/更新评论。 
Patch 名称自动格式化为(JIRA).(分支名称).(补丁号).patch,遵循 
Yetus 的命名规则。</li>
+</ul>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>$ 
./dev-support/submit-patch.py -jid KYLIN-xxxxx -b master -srb
+</code></pre>
+</div>
+
+<ul>
+  <li>用 -h æ 
‡å¿—可以了解此脚本的详细用法信息。最有用的选项是:
+    <ul>
+      <li>-b BRANCH, –branch BRANCH : 指定用于生成 diff 
的基本分支。如果未指定,则使用跟踪分支。如果没有跟踪分支,则会抛出错误。</li>
+      <li>-jid JIRA_ID, –jira-id JIRA_ID : 如果使用,则从 jira 
中的附件推断下一个补丁版本并上传新补丁。脚本将要求 
jira 用户名/密ç 
è¿›è¡Œèº«ä»½éªŒè¯ã€‚如果未设置,则将补丁命名为 .patch。</li>
+    </ul>
+  </li>
+  <li>默认情况下,它还会创建/更新 review 
board。要跳过该操作,请使用 -srb 选项。它使用 jira 
中的“Issue Links”来确定审核请求是否已存在。如果没有审æ 
¸è¯·æ±‚,则创建一个新请求并使用 jira 摘要,patch 说明等填充
所有必填字段。此外,还将此评论的链接添加到 jira。</li>
+  <li>
+    <p>安装需要的 python 依赖,从 master 分支执行 <code 
class="highlighter-rouge">pip install -r 
dev-support/python-requirements.txt</code>。</p>
+  </li>
+  <li>或者,您也可以手动生成 patch。请首先使用 <code 
class="highlighter-rouge">git rebase 
-i</code>,将较小的提交组合(squash)为一个较大的提交。然后使用
 <code class="highlighter-rouge">git format-patch</code> 命令生成 
patch,有关详细指南,请参阅<a 
href="https://ariejan.net/2009/10/26/how-to-create-and-apply-a-patch-with-git/";>如何使用
 Git 创建和应用补丁</a>。</li>
+</ul>
+
+<h2 id="section-4">代码审查</h2>
+<p>审核人员需要从以下角度审核 patch:</p>
+
+<ul>
+  <li><em>功能性</em>:patch 必须解决问题,并在提交审æ 
¸ä¹‹å‰å·²ç»è¿‡è´¡çŒ®è€…的验证。</li>
+  <li><em>测试范围</em>:更改必须由 UT 
或集成测试覆盖,否则无法维护。执行案例包括 GUI,shell 
脚本等。</li>
+  <li><em>性能</em>:改变不应该降低 Kylin 的性能。</li>
+  <li><em>元数据兼容性</em>:更改应支持旧å…
ƒæ•°æ®å®šä¹‰ã€‚否则,需要元数据迁移工具和文档。</li>
+  <li><em>API 兼容性</em>:更改不应该破坏公共 API 
的功能和行为;如果需要用新 API 替换旧 
API,请在那里打印警告消息。</li>
+  <li><em>文档</em>:如果需要同时更新 Kylin 
文档,请创建另一个 JIRA,并将 “Document” 
作为要跟踪的组件。在 JIRA 文档中,附加 “文档” 
分支的文档更改 patch。</li>
+</ul>
+
+<p>不符合上述规则的补丁可能无法合并。</p>
+
+<h2 id="patch-1-">Patch +1 政策</h2>
+
+<p>在提交之前,适合单个组件范围的修补程序至少需要一个组件负责人的
 +1。如果负责人不在 — 在忙或其他 — 
两个非负责人(即两个提交者)的 +1,就足够了。</p>
+
+<p>跨组件的 patch 在提交之前至少需要两个 +1,最好由 
x-component patch 涉及的组件负责人的 +1。</p>
+
+<p>任何人都可以在 patch 上 -1,任何 -1 
都可以否决补丁;在解决 -1 的理由之前,它不能被提交。</p>
+
+<h2 id="patch-1">应用 Patch</h2>
+<ul>
+  <li>Committer 将审核 JIRA 中的 Pull Requests 和 Patches 
的正确性,性能,设计,编码风格,测试覆盖率;</li>
+  <li>必要时进行讨论和修改;</li>
+  <li>Committer 将代码合并到目标分支中
+    <ul>
+      <li>对于 git patch,请使用 “git am -s -3 patch-file” 
命令进行应用;</li>
+      <li>如果是来自 github Pull Request,则需要添加 “This 
closing#” 作为提交消息的一部分。这将允许 ASF Git bot 关闭 
PR;</li>
+      <li>使用 <code class="highlighter-rouge">git rebase</code> 
确保合并结果是提交的简化。</li>
+    </ul>
+  </li>
+</ul>
+
+<h2 id="section-5">进行文档更改</h2>
+<p>查看<a href="/cn/development40/howto_docs.html">如何写文档</a>。</p>
+
+
+                                                       </article>
+                                               </div>
+                                       </div>
+                               </div>
+                               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<div class="col-md-4 col-lg-4 col-xs-12 col-sm-12 aside1 visible-sm visible-xs 
visible-md visible-lg" id="nside1" style=" margin-top: 5em;float:right;">
+    <ul class="nav nav-pills nav-stacked">
+    
+    <li><a href="#title开发指南" data-toggle="collapse" 
class="navtitle">开发指南</a></li>
+    <div class="collapse in">
+       <div class="list-group" id="list1">
+    <ul>
+    
+
+
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/index.html" class="list-group-item-lay 
pjaxlink">开发快速指南</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/dev_env.html" class="list-group-item-lay 
pjaxlink">搭建开发环境</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/coding_naming_convention.html" 
class="list-group-item-lay pjaxlink">编码和命名惯例</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_test.html" class="list-group-item-lay 
pjaxlink">如何测试</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_contribute.html" 
class="list-group-item-lay pjaxlink">如何贡献</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_become_apache_committer.html" 
class="list-group-item-lay pjaxlink">如何成为 Apache Committer</a></li>     
 
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_docs.html" class="list-group-item-lay 
pjaxlink">如何写文档</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/doc_spec.html" class="list-group-item-lay 
pjaxlink">Kylin 文档撰写规范</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_package.html" 
class="list-group-item-lay pjaxlink">如何打二进制包</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_release.html" 
class="list-group-item-lay pjaxlink">如何发布</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/plugin_arch.html" 
class="list-group-item-lay pjaxlink">插件架构</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/web_tech.html" class="list-group-item-lay 
pjaxlink">Kylin Web 摘要</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/about_temp_files.html" 
class="list-group-item-lay pjaxlink">关于临时文件</a></li>      
+      
+
+
+
+
+
+        <ul>
+  </div>
+</div>
+    
+
+    </ul>
+</div>
+                       </div>
+               </div>          
+               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<footer id="underfooter">
+    <div>
+        <div class="row">
+            <div class="col-md-12 widget">
+                <div class="widget-body">
+                    <div class="footer-img">
+                        <a href="http://www.apache.org";>
+                            <img id="asf-logo" height="78px" alt="Apache 
Software Foundation" src="/assets/images/apache_footer.png">
+                        </a>
+                    </div>
+                    <p style="padding-top: 11px;">
+                        The contents of this website are © 2015 Apache 
Software Foundation under the terms of the 
+                        <a href="http://www.apache.org/licenses/LICENSE-2.0";> 
Apache License v2 </a>. 
+                    </p>
+                    <p style="margin-bottom: 11px;">    
+                        Apache Kylin and its logo are trademarks of the Apache 
Software Foundation.
+                    </div>
+
+                </div>
+            </div>
+        </div>
+        <!-- /row of widgets -->
+
+    </div>
+    <div></div>
+
+</footer>
+
+       <script src="/assets/js/jquery-1.9.1.min.js"></script> 
+       <script src="/assets/js/bootstrap.min.js"></script> 
+       <script src="/assets/js/main.js"></script>
+       </body>
+</html>

Added: kylin/site/cn/development40/howto_docs.html
URL: 
http://svn.apache.org/viewvc/kylin/site/cn/development40/howto_docs.html?rev=1891303&view=auto
==============================================================================
--- kylin/site/cn/development40/howto_docs.html (added)
+++ kylin/site/cn/development40/howto_docs.html Tue Jul  6 07:50:56 2021
@@ -0,0 +1,1064 @@
+<!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<!doctype html>
+<html>
+       <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+
+  <title>Apache Kylin | 如何写文档</title>
+  <meta name="description" content="Apache Kylin Home">
+  <meta name="author"      content="Apache Kylin">
+  <link rel="shortcut icon" href="fav.png" type="image/png">
+
+
+
+<link rel="stylesheet" href="/assets/css/animate.css">
+<!-- Bootstrap -->
+<link rel="stylesheet" href="/assets/css/bootstrap.min.css">
+
+<!-- Fonts -->
+<!-- <link rel="stylesheet" 
href="http://fonts.googleapis.com/css?family=Alice|Open+Sans:400,300,700"> -->
+
+<!-- Icons -->
+<link rel="stylesheet" href="/assets/css/font-awesome.min.css">
+
+  <!-- Custom styles -->
+  <link rel="stylesheet" href="/assets/css/styles.css">
+  <link rel="stylesheet" href="/assets/css/docs.css">
+
+  <link rel="canonical" 
href="http://kylin.apache.org/cn/development40/howto_docs.html";>
+  <link rel="alternate" type="application/rss+xml" title="Apache Kylin" 
href="http://kylin.apache.org/feed.xml"; />
+
+<!--[if lt IE 9]> <script src="assets/js/html5shiv.js"></script> <![endif]-->
+<!-- Global site tag (gtag.js) - Google Analytics -->
+<script async 
src="https://www.googletagmanager.com/gtag/js?id=UA-120788561-1";></script>
+<script>
+  window.dataLayer = window.dataLayer || [];
+  function gtag(){dataLayer.push(arguments);}
+  gtag('js', new Date());
+
+  gtag('config', 'UA-120788561-1');
+</script>
+<script type="text/javascript" src="/assets/js/jquery-1.9.1.min.js"></script>
+<script type="text/javascript" src="/assets/js/nside.js"></script> </script>
+<script type="text/javascript" src="/assets/js/nnav.js"></script> </script>
+<script>
+var _hmt = _hmt || [];
+(function() {
+  var hm = document.createElement("script");
+  hm.src = "https://hm.baidu.com/hm.js?bdc5e03add430c0b72cc0eb91eabfa99";;
+  var s = document.getElementsByTagName("script")[0]; 
+  s.parentNode.insertBefore(hm, s);
+})();
+</script>
+</head>
+
+       <body>
+               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<header id="header" >
+  <!-- Main Menu -->
+  <nav class="navbar navbar-default" role="navigation" id="nav-wrapper">
+    <div class="container-fluid" id="nav">
+      <!-- Brand and toggle get grouped for better mobile display -->
+      <div class="navbar-header">
+        <img class="navbar-logo" width="46" src="/assets/images/kylin_logo.png 
"></img> 
+        
+        <button type="button" class="navbar-toggle collapsed" 
data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+          <span class="sr-only">Toggle navigation</span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+        </button>
+        <ul class="nav icon-navbar">
+            <li><a href="https://twitter.com/apachekylin"; target="_blank" 
class="fa fa-twitter fa-lg"  title="Twitter: @ApacheKylin" ></a></li>
+            <li><a href="https://github.com/apache/kylin"; target="_blank" 
class="fa fa-github-alt fa-lg" title="Github: apache/kylin" ></a></li>          
+            <li><a href="https://www.facebook.com/kylinio"; target="_blank" 
class="fa fa-facebook fa-lg" title="Facebook: kylin.io" ></a></li>    
+        </ul>
+      </div>
+
+      <!-- Collect the nav links, forms, and other content for toggling -->
+      <div class="navbar-collapse collapse" id="bs-example-navbar-collapse-1">
+        <ul class="nav navbar-nav">
+            <li><a href="/cn">首页</a></li>
+            <li><a href="/cn/docs" >文档</a></li>
+            <li><a href="/cn/download">下载</a></li>
+            <li><a href="/cn/community" >社区</a></li>
+            <li><a href="/cn/development" >开发</a></li>
+            <li><a href="/cn/blog">博客</a></li>
+            <li><a href="/" >English</a></li>           
+        </ul>
+        
+
+      </div><!-- /.navbar-collapse -->
+    </div><!-- /.container-fluid -->
+  </nav>
+
+  <div id="head" class="parallax normal-header" >
+    <div class="text-center header-apache">
+      <a href="http://apache.org/foundation/contributing.html"; title="Support 
Apache" style="margin-left: 150px;">
+        <div>
+          <img src="https://www.apache.org/images/SupportApache-small.png";>
+        </div>
+      </a>
+    </div>  
+  </div>
+
+ </header>
+
+               
+               <div class="container">
+                       <div class="row"  style="clear:both;">
+                               
+                               <div class="col-md-8 col-lg-8 col-xs-12 
col-sm-12 aside2" style="float: right;">
+                                       <div id="container" class="docs">
+                                               <div id="pjax">
+                                                       <h1 
class="post-title">如何写文档</h1>
+                                                       <article 
class="post-content" >
+                                                       <p>我们以 MD æ 
¼å¼ç¼–写文档并使用 <a href="http://jekyllrb.com";>Jekyll</a> 转换为 
HTML。Jekyll 生成的 HTML 上传到 apache SVN 并成为 Kylin 
网站。所有 MD 源文件都在 git 中管理,因此可以清
楚地跟踪所有更改和贡献者。</p>
+
+<h2 id="section">工作前</h2>
+
+<p>在您添加
或修改文档前,请部署文档编译所需的环境,我们提供以下两种方法:</p>
+
+<ul>
+  <li><a 
href="#本地部署文档编译环境">本地部署文档编译环境</a></li>
+  <li><a href="#使用 Docker 部署文档编译环境">使用 Docker 
部署文档编译环境(推荐)</a></li>
+</ul>
+
+<h3 id="span-idspan"><span 
id="本地部署文档编译环境">本地部署文档编译环境</span></h3>
+
+<p>在您添加或修改文档前请安装以下工具:</p>
+
+<ol>
+  <li>首先,确保 Ruby 和 Gem 能在您的机器上工作
+    <ul>
+      <li>对于 Mac 用户,请参考<a 
href="https://github.com/sstephenson/rbenv#homebrew-on-mac-os-x";>这个</a>来搭建
 ruby 环境。</li>
+      <li>对于 Windows 用户,使用 <a 
href="http://rubyinstaller.org/downloads/";>ruby installer</a>。</li>
+      <li>对于 China 用户,考虑使用一个<a 
href="https://ruby.taobao.org/";>本地 gem 
仓库</a>以防止网络问题。</li>
+    </ul>
+  </li>
+  <li>然后,安装 <a 
href="http://jekyllrb.com";>Jekyll</a>,以及需要的插件
+    <ul>
+      <li><code class="highlighter-rouge">gem install jekyll 
jekyll-multiple-languages kramdown rouge</code></li>
+      <li><strong>注意</strong>:一些特定的 jekyll 和 
jekyll-multiple-languages 版本不能一起使用(使用 jekyll 3.0.1 和 
jekyll-multiple-languages 2.0.3 时我遇到一个 “undefined method” 
错误)。这种情况下,<code class="highlighter-rouge">jekyll 2.5.3</code> 
和 <code class="highlighter-rouge">jekyll-multiple-languages 1.0.8</code> 
是已知可运行的版本。</li>
+      <li>例如,使用 <code class="highlighter-rouge">gem install jekyll 
--version "=2.5.3"</code> 来安装具体的版本。</li>
+      <li><strong>注意</strong>:对于 Mac 用户,如果 gem 安装
时遇到类似这样的错误 ‘ERROR:  While executing gem … 
(Gem::FilePermissionError)’。您可以使用 ‘brew install ruby’ 
的方式解决这个问题,然后重启您的终端。</li>
+    </ul>
+  </li>
+  <li>您可以选择任何 markdown 编辑器</li>
+</ol>
+
+<p>下面是一个可以工作的 gem 列表。如果 jekyll 安装
成为问题,请坚持使用这些版本。</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>$ gem list
+
+...
+jekyll (2.5.3)
+jekyll-coffeescript (1.0.1)
+jekyll-gist (1.4.0)
+jekyll-multiple-languages (1.0.8)
+jekyll-paginate (1.1.0)
+jekyll-sass-converter (1.4.0)
+jekyll-watch (1.3.1)
+json (1.8.1)
+kramdown (1.9.0)
+...
+rouge (1.10.1)
+...
+</code></pre>
+</div>
+
+<h3 id="span-id-docker--docker-span"><span id="使用 Docker 
部署文档编译环境">使用 Docker 部署文档编译环境</span></h3>
+
+<p>最新版的 kylin 发布提供了 
dockerfile,来减少构建复杂性使用 docker 和 Makefile 能调用 
docker 命令。</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>$ pwd
+/Users/&lt;username&gt;/kylin/website
+$ make docker.build
+docker build -f Dockerfile -t kylin-document:latest .
+Sending build context to Docker daemon  82.44MB
+Step 1/3 : FROM jekyll/jekyll:2.5.3
+ ---&gt; e81842c29599
+Step 2/3 : RUN gem install jekyll-multiple-languages -v 1.0.11
+ ---&gt; Using cache
+ ---&gt; e9e8b0f1d388
+Step 3/3 : RUN gem install rouge -v 3.0.0
+ ---&gt; Using cache
+ ---&gt; 1bd42c6b93c0
+Successfully built 1bd42c6b93c0
+Successfully tagged kylin-document:latest
+$ make runserver
+docker run --volume="/Users/&lt;username&gt;/kylin/website:/srv/jekyll" -p 
4000:4000 --rm -it kylin-document:latest jekyll server --watch
+Configuration file: /srv/jekyll/_config.yml
+            Source: /srv/jekyll
+       Destination: /srv/jekyll/_site
+      Generating...
+...
+</code></pre>
+</div>
+
+<h2 id="jekyll">关于 Jekyll</h2>
+<p>Jekyll 是一个用于从源文本和主题生成静态 HTML 网站的 Ruby 
脚本,HTML 在部署到 Web 服务器之前生成。Jekyll 恰好也是 
GitHub 页面背后的引擎。</p>
+
+<p>Apache Kylin 的网站和文档使用 Jekyll 来管理和生成,可在 <a 
href="http://kylin.apache.org";>http://kylin.apache.org</a> 上看到最终内
容。</p>
+
+<h2 id="multi-language">Multi-Language</h2>
+<p>要草拟中文版文档或翻译现有文档,只需添加
或复制该文档,名称以 .cn.md 作为后缀。它将在 /cn 
文件夹下生成与 html 同名的文件。<br />
+要添加其他语言,请更新 _config.yml 
并遵循与中文版相同的模式。</p>
+
+<h2 id="kylin-">Kylin 文档结构以及导航菜单</h2>
+
+<p><a href="https://github.com/apache/kylin/tree/document/website";>作为 
Jekyll 源的 Kylin 网站</a>是在 <code 
class="highlighter-rouge">doucment</code> 分支下维护的。</p>
+
+<ol>
+  <li><strong>Home Page</strong>:<em>“index.md”</em> 文档的主页</li>
+  <li><strong>Getting Started</strong>:<em>“gettingstarted”</em> 生成 
Apache Kylin 的文档,包括 FAQ,术语</li>
+  <li><strong>Installation</strong>:<em>“install”</em> Apache Kylin 
安装指南</li>
+  <li><strong>Tutorial</strong>:<em>“tutorial”</em> å…
³äºŽç”¨æˆ·å¦‚何使用 Apache Kylin 的教程</li>
+  <li><strong>How To</strong>:<em>“howto”</em> 
更细节的帮助指南</li>
+  <li><strong>Development</strong>:<em>“development”</em> 为了开发者
贡献,集成其它应用和扩展 Apache Kylin</li>
+  <li><strong>Others</strong>:其它文档。</li>
+</ol>
+
+<p>菜单由 Jekyll 集合管理:</p>
+
+<ul>
+  <li><strong>_data/docs.yml</strong>:英文版本菜单结构</li>
+  <li><strong>_data/docs-cn.yml</strong>:中文版本菜单结构</li>
+  <li><strong>add new menu item</strong>:添加新的条目:在相å…
³æ–‡ä»¶å¤¹ä¸‹åˆ›å»ºæ–°æ–‡æ¡£ï¼Œä¾‹å¦‚ howto_example.md。添加如下的前æ 
‡è®°ï¼š</li>
+</ul>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>---
+layout: docs
+title:  How to expamle
+categories: howto
+permalink: /docs/howto/howto_example.html
+version: v0.7.2
+since: v0.7.2
+---
+</code></pre>
+</div>
+
+<p>将链接更改为完全链接<br />
+然后将条目添加到 docs.yml,如:</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>- title: How To
+  docs:
+  - howto/howto_contribute
+  - howto/howto_jdbc
+  - howto/howto_example
+</code></pre>
+</div>
+
+<h2 id="section-1">如何编写文档</h2>
+<p>使用任何 markdown 编辑器打开文档,草拟内
容并在本地预览。</p>
+
+<p>样例文档:</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>---
+layout: docs
+title:  How to example
+categories: howto
+permalink: /docs/howto/howto_example.html
+version: v0.7.2
+since: v0.7.2
+---
+
+## This is example doc
+The quick brown fox jump over the lazy dog.
+</code></pre>
+</div>
+
+<h2 id="section-2">如何添加图片</h2>
+<p>所有的图片请放到 <em>images</em> 文件夹下,在你
的文件中,请使用以下样式引入图片:</p>
+
+<div class="highlighter-rouge"><pre 
class="highlight"><code>![](/images/Kylin-Web-Tutorial/2 tables.png)
+</code></pre>
+</div>
+
+<h2 id="section-3">如何添加连接</h2>
+<p>使用站点链接的相对路径,例如</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>[REST 
API](docs/development40/rest_api.html). 
+</code></pre>
+</div>
+
+<h2 id="section-4">如何添加代码高亮</h2>
+<p>我们使用 <a href="https://github.com/jneen/rouge";>Rouge</a> 
突出显示代码语法。<br />
+查看此 doc 的源代码以获取更多详细信息示例。</p>
+
+<h2 id="section-5">如何在本地预览</h2>
+<p>您可以在 markdown 编辑器中预览,要检查网站上的确切内
容,请从 <code class="highlighter-rouge">website</code> 文件夹中运行 
Jekyll:</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>jekyll server
+</code></pre>
+</div>
+<p>然后在浏览器中访问 http://127.0.0.1:4000。</p>
+
+<h2 id="committer">如何发布到网站(只适用于 committer)</h2>
+
+<h3 id="section-6">搭建</h3>
+
+<ol>
+  <li><code class="highlighter-rouge">cd website</code></li>
+  <li><code class="highlighter-rouge">svn co 
https://svn.apache.org/repos/asf/kylin/site _site</code></li>
+</ol>
+
+<p><strong>_site</strong> 文件夹是工作目录,将由 maven 或 git 
随时删除,请确保只有当你想要发布到网站时从 svn 
检出。</p>
+
+<h3 id="section-7">本地运行</h3>
+<p>在创建一个 PR 或推送到 git 
仓库之前,您可以通过以下方式在本地预览更改:</p>
+
+<ol>
+  <li><code class="highlighter-rouge">cd website</code></li>
+  <li><code class="highlighter-rouge">jekyll s</code></li>
+  <li>在您的浏览器打开 <a 
href="http://127.0.0.1:4000";>http://127.0.0.1:4000</a></li>
+</ol>
+
+<h3 id="section-8">推到网站</h3>
+
+<ol>
+  <li>拷贝 jekyll 生成的 <code class="highlighter-rouge">_site</code> 到 
svn 的 <code class="highlighter-rouge">website/_site</code></li>
+  <li><code class="highlighter-rouge">cd website/_site</code></li>
+  <li><code class="highlighter-rouge">svn status</code></li>
+  <li>您需要使用 <code class="highlighter-rouge">svn add</code> 添加
任意新的文件</li>
+  <li><code class="highlighter-rouge">svn commit -m 'UPDATE 
MESSAGE'</code></li>
+</ol>
+
+<p>在几分钟内,svnpubsub 应该开始且您将能够在 <a 
href="http://kylin.apache.org/";>http://kylin.apache.org</a> 看到结果。</p>
+
+
+                                                       </article>
+                                               </div>
+                                       </div>
+                               </div>
+                               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<div class="col-md-4 col-lg-4 col-xs-12 col-sm-12 aside1 visible-sm visible-xs 
visible-md visible-lg" id="nside1" style=" margin-top: 5em;float:right;">
+    <ul class="nav nav-pills nav-stacked">
+    
+    <li><a href="#title开发指南" data-toggle="collapse" 
class="navtitle">开发指南</a></li>
+    <div class="collapse in">
+       <div class="list-group" id="list1">
+    <ul>
+    
+
+
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/index.html" class="list-group-item-lay 
pjaxlink">开发快速指南</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/dev_env.html" class="list-group-item-lay 
pjaxlink">搭建开发环境</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/coding_naming_convention.html" 
class="list-group-item-lay pjaxlink">编码和命名惯例</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_test.html" class="list-group-item-lay 
pjaxlink">如何测试</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_contribute.html" 
class="list-group-item-lay pjaxlink">如何贡献</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_become_apache_committer.html" 
class="list-group-item-lay pjaxlink">如何成为 Apache Committer</a></li>     
 
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_docs.html" class="list-group-item-lay 
pjaxlink">如何写文档</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/doc_spec.html" class="list-group-item-lay 
pjaxlink">Kylin 文档撰写规范</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_package.html" 
class="list-group-item-lay pjaxlink">如何打二进制包</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_release.html" 
class="list-group-item-lay pjaxlink">如何发布</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/plugin_arch.html" 
class="list-group-item-lay pjaxlink">插件架构</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/web_tech.html" class="list-group-item-lay 
pjaxlink">Kylin Web 摘要</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/about_temp_files.html" 
class="list-group-item-lay pjaxlink">关于临时文件</a></li>      
+      
+
+
+
+
+
+        <ul>
+  </div>
+</div>
+    
+
+    </ul>
+</div>
+                       </div>
+               </div>          
+               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<footer id="underfooter">
+    <div>
+        <div class="row">
+            <div class="col-md-12 widget">
+                <div class="widget-body">
+                    <div class="footer-img">
+                        <a href="http://www.apache.org";>
+                            <img id="asf-logo" height="78px" alt="Apache 
Software Foundation" src="/assets/images/apache_footer.png">
+                        </a>
+                    </div>
+                    <p style="padding-top: 11px;">
+                        The contents of this website are © 2015 Apache 
Software Foundation under the terms of the 
+                        <a href="http://www.apache.org/licenses/LICENSE-2.0";> 
Apache License v2 </a>. 
+                    </p>
+                    <p style="margin-bottom: 11px;">    
+                        Apache Kylin and its logo are trademarks of the Apache 
Software Foundation.
+                    </div>
+
+                </div>
+            </div>
+        </div>
+        <!-- /row of widgets -->
+
+    </div>
+    <div></div>
+
+</footer>
+
+       <script src="/assets/js/jquery-1.9.1.min.js"></script> 
+       <script src="/assets/js/bootstrap.min.js"></script> 
+       <script src="/assets/js/main.js"></script>
+       </body>
+</html>

Added: kylin/site/cn/development40/howto_package.html
URL: 
http://svn.apache.org/viewvc/kylin/site/cn/development40/howto_package.html?rev=1891303&view=auto
==============================================================================
--- kylin/site/cn/development40/howto_package.html (added)
+++ kylin/site/cn/development40/howto_package.html Tue Jul  6 07:50:56 2021
@@ -0,0 +1,877 @@
+<!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<!doctype html>
+<html>
+       <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+
+  <title>Apache Kylin | 如何打二进制包</title>
+  <meta name="description" content="Apache Kylin Home">
+  <meta name="author"      content="Apache Kylin">
+  <link rel="shortcut icon" href="fav.png" type="image/png">
+
+
+
+<link rel="stylesheet" href="/assets/css/animate.css">
+<!-- Bootstrap -->
+<link rel="stylesheet" href="/assets/css/bootstrap.min.css">
+
+<!-- Fonts -->
+<!-- <link rel="stylesheet" 
href="http://fonts.googleapis.com/css?family=Alice|Open+Sans:400,300,700"> -->
+
+<!-- Icons -->
+<link rel="stylesheet" href="/assets/css/font-awesome.min.css">
+
+  <!-- Custom styles -->
+  <link rel="stylesheet" href="/assets/css/styles.css">
+  <link rel="stylesheet" href="/assets/css/docs.css">
+
+  <link rel="canonical" 
href="http://kylin.apache.org/cn/development40/howto_package.html";>
+  <link rel="alternate" type="application/rss+xml" title="Apache Kylin" 
href="http://kylin.apache.org/feed.xml"; />
+
+<!--[if lt IE 9]> <script src="assets/js/html5shiv.js"></script> <![endif]-->
+<!-- Global site tag (gtag.js) - Google Analytics -->
+<script async 
src="https://www.googletagmanager.com/gtag/js?id=UA-120788561-1";></script>
+<script>
+  window.dataLayer = window.dataLayer || [];
+  function gtag(){dataLayer.push(arguments);}
+  gtag('js', new Date());
+
+  gtag('config', 'UA-120788561-1');
+</script>
+<script type="text/javascript" src="/assets/js/jquery-1.9.1.min.js"></script>
+<script type="text/javascript" src="/assets/js/nside.js"></script> </script>
+<script type="text/javascript" src="/assets/js/nnav.js"></script> </script>
+<script>
+var _hmt = _hmt || [];
+(function() {
+  var hm = document.createElement("script");
+  hm.src = "https://hm.baidu.com/hm.js?bdc5e03add430c0b72cc0eb91eabfa99";;
+  var s = document.getElementsByTagName("script")[0]; 
+  s.parentNode.insertBefore(hm, s);
+})();
+</script>
+</head>
+
+       <body>
+               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<header id="header" >
+  <!-- Main Menu -->
+  <nav class="navbar navbar-default" role="navigation" id="nav-wrapper">
+    <div class="container-fluid" id="nav">
+      <!-- Brand and toggle get grouped for better mobile display -->
+      <div class="navbar-header">
+        <img class="navbar-logo" width="46" src="/assets/images/kylin_logo.png 
"></img> 
+        
+        <button type="button" class="navbar-toggle collapsed" 
data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+          <span class="sr-only">Toggle navigation</span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+        </button>
+        <ul class="nav icon-navbar">
+            <li><a href="https://twitter.com/apachekylin"; target="_blank" 
class="fa fa-twitter fa-lg"  title="Twitter: @ApacheKylin" ></a></li>
+            <li><a href="https://github.com/apache/kylin"; target="_blank" 
class="fa fa-github-alt fa-lg" title="Github: apache/kylin" ></a></li>          
+            <li><a href="https://www.facebook.com/kylinio"; target="_blank" 
class="fa fa-facebook fa-lg" title="Facebook: kylin.io" ></a></li>    
+        </ul>
+      </div>
+
+      <!-- Collect the nav links, forms, and other content for toggling -->
+      <div class="navbar-collapse collapse" id="bs-example-navbar-collapse-1">
+        <ul class="nav navbar-nav">
+            <li><a href="/cn">首页</a></li>
+            <li><a href="/cn/docs" >文档</a></li>
+            <li><a href="/cn/download">下载</a></li>
+            <li><a href="/cn/community" >社区</a></li>
+            <li><a href="/cn/development" >开发</a></li>
+            <li><a href="/cn/blog">博客</a></li>
+            <li><a href="/" >English</a></li>           
+        </ul>
+        
+
+      </div><!-- /.navbar-collapse -->
+    </div><!-- /.container-fluid -->
+  </nav>
+
+  <div id="head" class="parallax normal-header" >
+    <div class="text-center header-apache">
+      <a href="http://apache.org/foundation/contributing.html"; title="Support 
Apache" style="margin-left: 150px;">
+        <div>
+          <img src="https://www.apache.org/images/SupportApache-small.png";>
+        </div>
+      </a>
+    </div>  
+  </div>
+
+ </header>
+
+               
+               <div class="container">
+                       <div class="row"  style="clear:both;">
+                               
+                               <div class="col-md-8 col-lg-8 col-xs-12 
col-sm-12 aside2" style="float: right;">
+                                       <div id="container" class="docs">
+                                               <div id="pjax">
+                                                       <h1 
class="post-title">如何打二进制包</h1>
+                                                       <article 
class="post-content" >
+                                                       <h3 
id="section">生成二进制包</h3>
+<p>本文档讲述的是如何从源码构建 Kylin4 的二进制包</p>
+
+<h4 id="section-1">下载源码</h4>
+<p>您可以从 github 仓库下载 Apache Kylin 源码。</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>git clone 
https://github.com/apache/kylin kylin
+</code></pre>
+</div>
+
+<h4 id="section-2">构建二进制包</h4>
+
+<p>为了生成二进制包,需要预先准备好 <strong>maven</strong> 和 
<strong>npm</strong>。</p>
+
+<p><strong>(可选)</strong> 如果您在代理服务器后面,在运行 
./script/package.sh 之前,需要将代理信息告知 npm 和 bower:</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>export 
http_proxy=http://your-proxy-host:port
+npm config set proxy http://your-proxy-host:port
+</code></pre>
+</div>
+
+<h5 id="section-3">运行打包命令</h5>
+<div class="highlighter-rouge"><pre class="highlight"><code>cd kylin
+build/script/package.sh
+</code></pre>
+</div>
+
+                                                       </article>
+                                               </div>
+                                       </div>
+                               </div>
+                               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<div class="col-md-4 col-lg-4 col-xs-12 col-sm-12 aside1 visible-sm visible-xs 
visible-md visible-lg" id="nside1" style=" margin-top: 5em;float:right;">
+    <ul class="nav nav-pills nav-stacked">
+    
+    <li><a href="#title开发指南" data-toggle="collapse" 
class="navtitle">开发指南</a></li>
+    <div class="collapse in">
+       <div class="list-group" id="list1">
+    <ul>
+    
+
+
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/index.html" class="list-group-item-lay 
pjaxlink">开发快速指南</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/dev_env.html" class="list-group-item-lay 
pjaxlink">搭建开发环境</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/coding_naming_convention.html" 
class="list-group-item-lay pjaxlink">编码和命名惯例</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_test.html" class="list-group-item-lay 
pjaxlink">如何测试</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_contribute.html" 
class="list-group-item-lay pjaxlink">如何贡献</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_become_apache_committer.html" 
class="list-group-item-lay pjaxlink">如何成为 Apache Committer</a></li>     
 
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_docs.html" class="list-group-item-lay 
pjaxlink">如何写文档</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/doc_spec.html" class="list-group-item-lay 
pjaxlink">Kylin 文档撰写规范</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_package.html" 
class="list-group-item-lay pjaxlink">如何打二进制包</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/howto_release.html" 
class="list-group-item-lay pjaxlink">如何发布</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/plugin_arch.html" 
class="list-group-item-lay pjaxlink">插件架构</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/web_tech.html" class="list-group-item-lay 
pjaxlink">Kylin Web 摘要</a></li>      
+      
+
+
+   
+  
+
+  
+    
+  
+
+
+
+  
+    
+      <li class="navlist">
+        <a href="/cn/development40/about_temp_files.html" 
class="list-group-item-lay pjaxlink">关于临时文件</a></li>      
+      
+
+
+
+
+
+        <ul>
+  </div>
+</div>
+    
+
+    </ul>
+</div>
+                       </div>
+               </div>          
+               <!--
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements.  See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership.  The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License.  You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+-->
+
+<footer id="underfooter">
+    <div>
+        <div class="row">
+            <div class="col-md-12 widget">
+                <div class="widget-body">
+                    <div class="footer-img">
+                        <a href="http://www.apache.org";>
+                            <img id="asf-logo" height="78px" alt="Apache 
Software Foundation" src="/assets/images/apache_footer.png">
+                        </a>
+                    </div>
+                    <p style="padding-top: 11px;">
+                        The contents of this website are © 2015 Apache 
Software Foundation under the terms of the 
+                        <a href="http://www.apache.org/licenses/LICENSE-2.0";> 
Apache License v2 </a>. 
+                    </p>
+                    <p style="margin-bottom: 11px;">    
+                        Apache Kylin and its logo are trademarks of the Apache 
Software Foundation.
+                    </div>
+
+                </div>
+            </div>
+        </div>
+        <!-- /row of widgets -->
+
+    </div>
+    <div></div>
+
+</footer>
+
+       <script src="/assets/js/jquery-1.9.1.min.js"></script> 
+       <script src="/assets/js/bootstrap.min.js"></script> 
+       <script src="/assets/js/main.js"></script>
+       </body>
+</html>


Reply via email to