svn commit: r1880966 - in /kylin/site: cn/development/howto_docs.html cn/docs/tutorial/query_pushdown.html development/howto_docs.html docs/tutorial/query_pushdown.html feed.xml

Tue, 18 Aug 2020 07:08:25 -0700 

Author: lidong
Date: Tue Aug 18 14:08:14 2020
New Revision: 1880966

URL: http://svn.apache.org/viewvc?rev=1880966&view=rev
Log:
Optimize pushdown document

Modified:
    kylin/site/cn/development/howto_docs.html
    kylin/site/cn/docs/tutorial/query_pushdown.html
    kylin/site/development/howto_docs.html
    kylin/site/docs/tutorial/query_pushdown.html
    kylin/site/feed.xml

Modified: kylin/site/cn/development/howto_docs.html
URL: 
http://svn.apache.org/viewvc/kylin/site/cn/development/howto_docs.html?rev=1880966&r1=1880965&r2=1880966&view=diff
==============================================================================
--- kylin/site/cn/development/howto_docs.html (original)
+++ kylin/site/cn/development/howto_docs.html Tue Aug 18 14:08:14 2020
@@ -183,6 +183,15 @@ var _hmt = _hmt || [];
 
 <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>
@@ -196,11 +205,8 @@ var _hmt = _hmt || [];
   <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> 
是已知可运行的版本。
-        <ul>
-          <li>例如. 使用 <code class="highlighter-rouge">gem install 
jekyll --version "=2.5.3"</code> 来安装具体的版本。</li>
-        </ul>
-      </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>
@@ -227,7 +233,7 @@ rouge (1.10.1)
 </code></pre>
 </div>
 
-<h2 id="docker-">使用 Docker 为文档编译</h2>
+<h3 id="span-id-docker--docker-span"><span id="使用 Docker 
部署文档编译环境">使用 Docker 部署文档编译环境</span></h3>
 
 <p>最新版的 kylin 发布提供了 
dockerfile，来减少构建复杂性使用 docker 和 Makefile 能调用 
docker 命令。</p>
 
@@ -265,7 +271,7 @@ Configuration file: /srv/jekyll/_config.
 <p>要草拟中文版文档或翻译现有文档，只需添加
或复制该文档，名称以 .cn.md 作为后缀。它将在 /cn 
文件夹下生成与 html 同名的文件。<br />
 要添加其他语言，请更新 _config.yml 
并遵循与中文版相同的模式。</p>
 
-<h1 id="kylin-">Kylin 文档结构以及导航菜单</h1>
+<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>
 
@@ -309,7 +315,7 @@ since: v0.7.2
 </code></pre>
 </div>
 
-<h1 id="section-1">如何编写文档</h1>
+<h2 id="section-1">如何编写文档</h2>
 <p>使用任何 markdown 编辑器打开文档，草拟内
容并在本地预览。</p>
 
 <p>样例文档：</p>
@@ -325,35 +331,31 @@ since: v0.7.2
 
 ## This is example doc
 The quick brown fox jump over the lazy dog.
-
 </code></pre>
 </div>
 
-<h1 id="section-2">如何添加图片</h1>
+<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>
 
-<h1 id="section-3">如何添加连接</h1>
+<h2 id="section-3">如何添加连接</h2>
 <p>使用站点链接的相对路径，例如</p>
 
 <div class="highlighter-rouge"><pre class="highlight"><code>[REST 
API](docs/development/rest_api.html). 
-
 </code></pre>
 </div>
 
-<h1 id="section-4">如何添加代码高亮</h1>
+<h2 id="section-4">如何添加代码高亮</h2>
 <p>我们使用 <a href="https://github.com/jneen/rouge";>Rouge</a> 
突出显示代码语法。<br />
 查看此 doc 的源代码以获取更多详细信息示例。</p>
 
-<h1 id="section-5">如何在本地预览</h1>
+<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>

Modified: kylin/site/cn/docs/tutorial/query_pushdown.html
URL: 
http://svn.apache.org/viewvc/kylin/site/cn/docs/tutorial/query_pushdown.html?rev=1880966&r1=1880965&r2=1880966&view=diff
==============================================================================
--- kylin/site/cn/docs/tutorial/query_pushdown.html (original)
+++ kylin/site/cn/docs/tutorial/query_pushdown.html Tue Aug 18 14:08:14 2020
@@ -189,7 +189,8 @@ var _hmt = _hmt || [];
 
 <ol>
   <li>
-    <p>修改配置文件<code 
class="highlighter-rouge">kylin.properties</code>打开Query 
Pushdown注释掉的配置项<code 
class="highlighter-rouge">kylin.query.pushdown.runner-class-name</code>，设置为<code
 
class="highlighter-rouge">org.apache.kylin.query.adhoc.PushDownRunnerJdbcImpl</code></p>
+    <p>修改配置文件<code 
class="highlighter-rouge">kylin.properties</code>打开Query 
Pushdown注释掉的配置项<code 
class="highlighter-rouge">kylin.query.pushdown.runner-class-name</code>，设置为<code
 
class="highlighter-rouge">org.apache.kylin.query.adhoc.PushDownRunnerJdbcImpl</code>；<br
 />
+如果你需要将查询下压到presto，请将这项配置设置为<code 
class="highlighter-rouge">org.apache.kylin.query.pushdown.PushdownRunnerSDKImpl</code>，å
…¶ä½™é…ç½®å‚见本页末尾的<a href="#pushdown-to-presto">Pushdown to 
Presto</a>中的介绍。</p>
   </li>
   <li>
     <p>在配置文件<code 
class="highlighter-rouge">kylin.properties</code>添加如下é…
ç½®é¡¹ã€‚若不设置，将使用默认é…
ç½®é¡¹ã€‚请不要忘记将”hiveserver”和”10000”替换成环境中Hive运行的主机和端口。</p>
@@ -224,7 +225,11 @@ var _hmt = _hmt || [];
 
 <div class="highlight"><pre><code class="language-groff" 
data-lang="groff">kylin.query.pushdown.runner-class-name=org.apache.kylin.query.adhoc.PushDownRunnerJdbcImpl
 kylin.query.pushdown.jdbc.url=jdbc:hive2://hiveserver:10000/default 
kylin.query.pushdown.jdbc.driver=org.apache.hive.jdbc.HiveDriver 
kylin.query.pushdown.jdbc.username=hive kylin.query.pushdown.jdbc.password= 
kylin.query.pushdown.jdbc.pool-max-total=8 
kylin.query.pushdown.jdbc.pool-max-idle=8 
kylin.query.pushdown.jdbc.pool-min-idle=0</code></pre></div>
 
-<p>然后，重启Kylin</p>
+<ol>
+  <li>当 Pushdown 到的查询引擎不是<code 
class="highlighter-rouge">Hive</code> 时，请将对应查询引擎的 JDBC 
驱动放在 $KYLIN_HOME/ext 
目录下，没有此目录时请自行创建。</li>
+</ol>
+
+<p>然后，重启Kylin。</p>
 
 <h4 id="section-2">下压至多个引擎</h4>
 <p>自 v3.0.0 
起，开始支持通过JDBC下压至多个引擎进行查询。<br />
@@ -276,6 +281,7 @@ kylin.query.pushdown.jdbc.driver=com.fac
 kylin.query.pushdown.jdbc.username={USER_NAME}
 kylin.query.pushdown.jdbc.password={PASSWORD}</code></pre></div>
 
+<p>并且，请自行下载 Presto 的 JDBC 驱动 presto-jdbc-xxx.jar 
放置在 $KYLIN_HOME/ext 目录下，没有此目录时请自行创建。</p>
 
                                                        </article>
                                                </div>

Modified: kylin/site/development/howto_docs.html
URL: 
http://svn.apache.org/viewvc/kylin/site/development/howto_docs.html?rev=1880966&r1=1880965&r2=1880966&view=diff
==============================================================================
--- kylin/site/development/howto_docs.html (original)
+++ kylin/site/development/howto_docs.html Tue Aug 18 14:08:14 2020
@@ -8403,6 +8403,15 @@ var _hmt = _hmt || [];
 
 <h2 id="before-your-work">Before your work</h2>
 
+<p>Before you add or edit documentation, please deploy the document 
compilation environment. We provide two ways:</p>
+
+<ul>
+  <li><a href="#Deploy a local document compilation environment">Deploy a 
local document compilation environment</a></li>
+  <li><a href="#Use Docker to deploy document compilation environment">Use 
Docker to deploy document compilation environment</a></li>
+</ul>
+
+<h3 
id="span-iddeploy-a-local-document-compilation-environmentdeploy-a-local-document-compilation-environmentspan"><span
 id="Deploy a local document compilation environment">Deploy a local document 
compilation environment</span></h3>
+
 <p>Install following tools before you add or edit documentation:</p>
 
 <ol>
@@ -8447,7 +8456,7 @@ rouge (1.10.1)
 </code></pre>
 </div>
 
-<h2 id="use-docker-for-document-compile">Use Docker for document compile</h2>
+<h3 
id="span-iduse-docker-to-deploy-document-compilation-environmentuse-docker-to-deploy-document-compilation-environmentspan"><span
 id="Use Docker to deploy document compilation environment">Use Docker to 
deploy document compilation environment</span></h3>
 
 <p>The latest kylin release provides dockerfile, to reduce build complexity 
using docker and Makefile can call docker command.</p>
 
@@ -8485,7 +8494,7 @@ Configuration file: /srv/jekyll/_config.
 <p>To draft Chinese version document or translate existing one, just add or 
copy that doc and name with .cn.md as sufffix. It will generate under /cn 
folder with same name as html file.  <br />
 To add other language, please update _config.yml and follow the same pattern 
as Chinese version.</p>
 
-<h1 id="kylin-document-structure-and-navigation-menu">Kylin document structure 
and navigation menu</h1>
+<h2 id="kylin-document-structure-and-navigation-menu">Kylin document structure 
and navigation menu</h2>
 
 <p>The Kylin <a 
href="https://github.com/apache/kylin/tree/document/website";>website as the 
Jekyll source</a> is maintained under the <code 
class="highlighter-rouge">doucment</code> branch.</p>
 
@@ -8529,7 +8538,7 @@ Then add item to docs.yml like:</p>
 </code></pre>
 </div>
 
-<h1 id="how-to-edit-document">How to edit document</h1>
+<h2 id="how-to-edit-document">How to edit document</h2>
 <p>Open doc with any markdown editor, draft content and preview in local.</p>
 
 <p>Sample Doc:</p>
@@ -8545,35 +8554,31 @@ since: v0.7.2
 
 ## This is example doc
 The quick brown fox jump over the lazy dog.
-
 </code></pre>
 </div>
 
-<h1 id="how-to-add-image">How to add image</h1>
+<h2 id="how-to-add-image">How to add image</h2>
 <p>All impage please put under <em>images</em> folder, in your document, 
please using below sample to include image:</p>
 
 <div class="highlighter-rouge"><pre 
class="highlight"><code>![](/images/Kylin-Web-Tutorial/2 tables.png)
-
 </code></pre>
 </div>
 
-<h1 id="how-to-add-link">How to add link</h1>
+<h2 id="how-to-add-link">How to add link</h2>
 <p>Using relative path for site links, for example:</p>
 
 <div class="highlighter-rouge"><pre class="highlight"><code>[REST 
API](docs/development/rest_api.html). 
-
 </code></pre>
 </div>
 
-<h1 id="how-to-add-code-highlight">How to add code highlight</h1>
+<h2 id="how-to-add-code-highlight">How to add code highlight</h2>
 <p>We are using <a href="https://github.com/jneen/rouge";>Rouge</a> to 
highlight code syntax.<br />
 check this doc’s source code for more detail sample.</p>
 
-<h1 id="how-to-preview-in-your-local">How to preview in your local</h1>
+<h2 id="how-to-preview-in-your-local">How to preview in your local</h2>
 <p>You can preview in your markdown editor, to check exactly what it will 
looks like on website, please run Jekyll from <code 
class="highlighter-rouge">website</code> folder:</p>
 
 <div class="highlighter-rouge"><pre class="highlight"><code>jekyll server
-
 </code></pre>
 </div>
 <p>Then access http://127.0.0.1:4000 in your browser.</p>

Modified: kylin/site/docs/tutorial/query_pushdown.html
URL: 
http://svn.apache.org/viewvc/kylin/site/docs/tutorial/query_pushdown.html?rev=1880966&r1=1880965&r2=1880966&view=diff
==============================================================================
--- kylin/site/docs/tutorial/query_pushdown.html (original)
+++ kylin/site/docs/tutorial/query_pushdown.html Tue Aug 18 14:08:14 2020
@@ -8407,9 +8407,12 @@ var _hmt = _hmt || [];
 <h3 id="query-pushdown-config">Query Pushdown config</h3>
 
 <h4 id="pushdown-to-single-engine">Pushdown to single engine</h4>
+<p>Take hive as an example to explain the opening steps:</p>
+
 <ol>
   <li>
-    <p>In Kylin’s installation directory, uncomment configuration item <code 
class="highlighter-rouge">kylin.query.pushdown.runner-class-name</code> of 
config file <code class="highlighter-rouge">kylin.properties</code>, and set it 
to <code 
class="highlighter-rouge">org.apache.kylin.query.adhoc.PushDownRunnerJdbcImpl</code></p>
+    <p>In Kylin’s installation directory, uncomment configuration item <code 
class="highlighter-rouge">kylin.query.pushdown.runner-class-name</code> of 
config file <code class="highlighter-rouge">kylin.properties</code>, and set it 
to <code 
class="highlighter-rouge">org.apache.kylin.query.adhoc.PushDownRunnerJdbcImpl</code>,<br
 />
+If you need to pushdown the query to presto, please set this configuration to 
<code 
class="highlighter-rouge">org.apache.kylin.query.pushdown.PushdownRunnerSDKImpl</code>.
 For other configurations, please refer to <a 
href="#pushdown-to-presto">Pushdown to Presto</a> at the end of this page.</p>
   </li>
   <li>
     <p>Add configuration items below in config file <code 
class="highlighter-rouge">kylin.properties</code>.</p>
@@ -8442,6 +8445,10 @@ var _hmt = _hmt || [];
 
 <p>Here is a sample configuration; remember to change host “hiveserver” 
and port “10000” with your cluster configuraitons.</p>
 
+<ol>
+  <li>When the query engine pushdown to is not <code 
class="highlighter-rouge">Hive</code>, please put the jdbc driver of the 
corresponding query engine in $KYLIN_HOME/ext directory, if there is no such 
directory, please create it yourself.</li>
+</ol>
+
 <p>Then, restart Kylin.</p>
 
 <div class="highlight"><pre><code class="language-groff" 
data-lang="groff">kylin.query.pushdown.runner-class-name=org.apache.kylin.query.adhoc.PushDownRunnerJdbcImpl
@@ -8503,6 +8510,7 @@ kylin.query.pushdown.jdbc.driver=com.fac
 kylin.query.pushdown.jdbc.username={USER_NAME}
 kylin.query.pushdown.jdbc.password={PASSWORD}</code></pre></div>
 
+<p>In addition, please download Presto jdbc driver presto-jdbc-xxx.jar and put 
it in $KYLIN_HOME/ext directory, if there is no such directory, please create 
it yourself.</p>
 
                                                        </article>
                                                </div>

Modified: kylin/site/feed.xml
URL: 
http://svn.apache.org/viewvc/kylin/site/feed.xml?rev=1880966&r1=1880965&r2=1880966&view=diff
==============================================================================
--- kylin/site/feed.xml (original)
+++ kylin/site/feed.xml Tue Aug 18 14:08:14 2020
@@ -19,8 +19,8 @@
     <description>Apache Kylin Home</description>
     <link>http://kylin.apache.org/</link>
     <atom:link href="http://kylin.apache.org/feed.xml"; rel="self" 
type="application/rss+xml"/>
-    <pubDate>Fri, 07 Aug 2020 06:59:12 -0700</pubDate>
-    <lastBuildDate>Fri, 07 Aug 2020 06:59:12 -0700</lastBuildDate>
+    <pubDate>Tue, 18 Aug 2020 06:59:14 -0700</pubDate>
+    <lastBuildDate>Tue, 18 Aug 2020 06:59:14 -0700</lastBuildDate>
     <generator>Jekyll v2.5.3</generator>
     
       <item>

Reply via email to