This is an automated email from the ASF dual-hosted git repository.
aradzinski pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-nlpcraft-website.git
The following commit(s) were added to refs/heads/master by this push:
new 4a3c6c5 WIP.
4a3c6c5 is described below
commit 4a3c6c516e185beeb4d3dc3b2b736a7a6c3263d0
Author: Aaron Radzinski <[email protected]>
AuthorDate: Fri Jun 11 13:24:14 2021 -0700
WIP.
---
_includes/latest_ver_blog_warn.html | 25 ++++++++
blogs/composable_named_entities.html | 1 +
blogs/nlpcraft-idl-intent-definition-language.html | 1 +
blogs/quick_intro_apache_nlpcraft.html | 5 +-
blogs/short_term_memory.html | 1 +
server-and-probe.html | 73 ++++++++++++----------
6 files changed, 68 insertions(+), 38 deletions(-)
diff --git a/_includes/latest_ver_blog_warn.html
b/_includes/latest_ver_blog_warn.html
new file mode 100644
index 0000000..c46cfed
--- /dev/null
+++ b/_includes/latest_ver_blog_warn.html
@@ -0,0 +1,25 @@
+<!--
+ 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="bq success">
+ <p><b>Latest Version</b></p>
+ <p>
+ At the moment of this writing, the project undergoes incubation at <a
target=asf href="https://apache.org/";>Apache Software Foundation</a>, the
+ <a href="/download.html">latest version</a> of NLPCraft is
<b>{{site.latest_version}}</b>. In some rare cases, APIs might have changed
+ since the this article was written. Consult the latest <a
href="/docs.html">documentation</a> for up to date information.
+ </p>
+</div>
\ No newline at end of file
diff --git a/blogs/composable_named_entities.html
b/blogs/composable_named_entities.html
index b3488e0..b6cbf6d 100644
--- a/blogs/composable_named_entities.html
+++ b/blogs/composable_named_entities.html
@@ -29,6 +29,7 @@ publish_date: January 20, 2021
<div class="bq info">
This blog is an English adaptation of Sergey Kamov's <a target=habr
href="https://habr.com/ru/post/530878/";>blog</a> written in Russian.
</div>
+ {% include latest_ver_blog_warn.html %}
<p>
Most of the NLP tasks start with the basic challenge - how to find or
detect something in the text. Whether
you are designing a search engine, conversational interface or some
sort of classificator you will likely
diff --git a/blogs/nlpcraft-idl-intent-definition-language.html
b/blogs/nlpcraft-idl-intent-definition-language.html
index 3db798a..d2c6994 100644
--- a/blogs/nlpcraft-idl-intent-definition-language.html
+++ b/blogs/nlpcraft-idl-intent-definition-language.html
@@ -29,6 +29,7 @@ publish_date: June 3, 2021
<div class="bq info">
This blog is an English adaptation of Sergey Kamov's <a target=habr
href="https://habr.com/ru/post/559716";>blog</a> written in Russian.
</div>
+ {% include latest_ver_blog_warn.html %}
<p>
This article is a second part of the article <a target=habr
href="https://habr.com/ru/post/534034/";>Проектируем интенты с Apache
NLPCraft</a>
<img alt="" style="vertical-align: baseline"
src="/images/ru-flag-16.png"> and contains a detailed description of
diff --git a/blogs/quick_intro_apache_nlpcraft.html
b/blogs/quick_intro_apache_nlpcraft.html
index 71f69a0..f3cb800 100644
--- a/blogs/quick_intro_apache_nlpcraft.html
+++ b/blogs/quick_intro_apache_nlpcraft.html
@@ -36,10 +36,7 @@ publish_date: November 16, 2020
unambiguously straightforward - provide an efficient & highly
productive API to develop advanced NLP-based
interfaces for modern applications.
</p>
- <div class="bq info">
- At the moment of this writing, the project undergoes incubation at <a
target=asf href="https://apache.org/";>Apache Software Foundation</a>, the
- <a href="/download.html">latest version</a> of NLPCraft is
<b>{{site.latest_version}}</b>.
- </div>
+ {% include latest_ver_blog_warn.html %}
</section>
<section>
<h2 class="section-title">Overview <a href="#"><i class="top-link fas
fa-fw fa-angle-double-up"></i></a></h2>
diff --git a/blogs/short_term_memory.html b/blogs/short_term_memory.html
index 9d5484d..b661bd7 100644
--- a/blogs/short_term_memory.html
+++ b/blogs/short_term_memory.html
@@ -26,6 +26,7 @@ publish_date: July 26, 2019
-->
<section>
+ {% include latest_ver_blog_warn.html %}
<p>
In this blog, I'll try to give a high-level overview of STM -
Short-Term Memory, a technique used to
maintain conversational context in NLPCraft. Maintaining the proper
conversation context - remembering
diff --git a/server-and-probe.html b/server-and-probe.html
index 4f17e6b..197c06e 100644
--- a/server-and-probe.html
+++ b/server-and-probe.html
@@ -136,14 +136,12 @@ id: server_and_probe
Make sure to provide correct path to
<code>apache-nlpcraft-incubating-<b>{{site.latest_version}}</b>-all-deps.jar</code>
file.
</li>
<li>
- Class <code>org.apache.nlpcraft.NCStart</code> is a
common entry point for all NLPCraft runtime components.
- </li>
- <li>
- Class <code>org.apache.nlpcraft.NCStart</code> should
be used to star REST server from IDE.
+ Class <code>org.apache.nlpcraft.NCStart</code> is a
common entry point for all NLPCraft runtime components and
+ can be used to start REST server from IDE.
</li>
</ul>
<p>
- Parameters:
+ <b>Parameters</b>:
</p>
<dl>
<dt>
@@ -172,6 +170,41 @@ id: server_and_probe
where <code>path</code> is an absolute path to the
Ignite configuration file.
</dd>
</dl>
+ <p>
+ <b>VM Options</b>:
+ </p>
+ <p>
+ NLPCraft REST server uses Apache Ignite 2.x as its
distributed in-memory computing plane. Apache Ignite
+ <a target=_new
href="https://apacheignite.readme.io/docs/getting-started#running-ignite-with-java-11-and-later-versions";>requires</a>
+ the following additional JVM options to be used when
running Apache Ignite 2.x on JDK 11:
+ </p>
+ <pre class="brush: text">
+ --add-opens=java.base/jdk.internal.misc=ALL-UNNAMED
+ --add-opens=java.base/sun.nio.ch=ALL-UNNAMED
+ --add-opens=java.base/java.nio=ALL-UNNAMED
+ --add-opens=java.base/java.io=ALL-UNNAMED
+ --add-opens=java.base/java.util=ALL-UNNAMED
+ --add-opens=java.base/java.lang=ALL-UNNAMED
+
--add-opens=java.management/com.sun.jmx.mbeanserver=ALL-UNNAMED
+
--add-opens=jdk.internal.jvmstat/sun.jvmstat.monitor=ALL-UNNAMED
+
--add-opens=java.base/sun.reflect.generics.reflectiveObjects=ALL-UNNAMED
+
--add-opens=jdk.management/com.sun.management.internal=ALL-UNNAMED
+ --illegal-access=permit
+ </pre>
+ <p>
+ <b>NOTES:</b>
+ </p>
+ <ul>
+ <li>
+ <a
href="/tools/script.html"><code>nlpcraft.{sh|cmd}</code></a> script
automatically uses
+ these options for <code>start-server</code> command.
+ </li>
+ </ul>
+ <div class="bq success">
+ Since this list of required VM options is long it is
rather impractical and inconvenient to use it from the
+ command line. It is <b>highly recommended</b> to either
use IDE or <a href="/tools/script.html"><code>nlpcraft.{sh|cmd}</code></a>
script
+ to manage REST server lifecycle.
+ </div>
</div>
<div class="tab-pane fade show" id="nav-srv-docker"
role="tabpanel">
<p></p>
@@ -208,34 +241,6 @@ id: server_and_probe
The abnormally long GC pauses (over 5s) can be caused by the
excessive memory swapping performed by OS due to
insufficient JVM heap memory.
</p>
- <h2 class="section-sub-title">Apache Ignite 2.x and JDK 11 <a
href="#"><i class="top-link fas fa-fw fa-angle-double-up"></i></a></h2>
- <p>
- NLPCraft REST server uses Apache Ignite 2.x as its distributed
in-memory computing plane. Apache Ignite
- <a target=_new
href="https://apacheignite.readme.io/docs/getting-started#running-ignite-with-java-11-and-later-versions";>recommends</a>
- the following additional JVM options to be used when running
Apache Ignite 2.x on JDK 11:
- </p>
- <pre class="brush: text">
---add-opens=java.base/jdk.internal.misc=ALL-UNNAMED
---add-opens=java.base/sun.nio.ch=ALL-UNNAMED
---add-opens=java.base/java.nio=ALL-UNNAMED
---add-opens=java.base/java.io=ALL-UNNAMED
---add-opens=java.base/java.util=ALL-UNNAMED
---add-opens=java.base/java.lang=ALL-UNNAMED
---add-opens=java.management/com.sun.jmx.mbeanserver=ALL-UNNAMED
---add-opens=jdk.internal.jvmstat/sun.jvmstat.monitor=ALL-UNNAMED
---add-opens=java.base/sun.reflect.generics.reflectiveObjects=ALL-UNNAMED
---add-opens=jdk.management/com.sun.management.internal=ALL-UNNAMED
---illegal-access=permit
- </pre>
- <p>
- <b>NOTES:</b>
- </p>
- <ul>
- <li>
- <a
href="/tools/script.html"><code>nlpcraft.{sh|cmd}</code></a> script
automatically uses
- these options for <code>start-server</code> command.
- </li>
- </ul>
</section>
<section id="probe">
<h2 class="section-title">Data Probe <a href="#"><i class="top-link
fas fa-fw fa-angle-double-up"></i></a></h2>
@@ -307,7 +312,7 @@ id: server_and_probe
</li>
</ul>
<p>
- Parameters:
+ <b>Parameters:</b>
</p>
<dl>
<dt>
