This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-baremaps-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new b9d8ab5 Automatic Site Publish by Buildbot
b9d8ab5 is described below
commit b9d8ab55e2399b32087017dc9bc9212cf5874ade
Author: buildbot <[email protected]>
AuthorDate: Sat Feb 4 22:44:35 2023 +0000
Automatic Site Publish by Buildbot
---
.../how-to-build-with-maven/index.html | 49 +++++++++++++++++-----
output/sitemap.xml | 2 +-
2 files changed, 39 insertions(+), 12 deletions(-)
diff --git a/output/developer-manual/how-to-build-with-maven/index.html
b/output/developer-manual/how-to-build-with-maven/index.html
index 5e880ba..b8ba3e4 100644
--- a/output/developer-manual/how-to-build-with-maven/index.html
+++ b/output/developer-manual/how-to-build-with-maven/index.html
@@ -98,26 +98,53 @@
<article class="eight columns">
<h1 id="how-to-build-with-maven">How to Build with Maven</h1>
-<blockquote>
- <p>If you are using Windows, you will need to use mvnw.cmd instead of ./mvnw
and use set instead of export to set the environment variable.</p>
-</blockquote>
+<p>This guide describes the basics of compiling Baremaps from source. In order
to run Apache Baremaps, you first need to install Java 17 or a later version.
+<a href="https://sdkman.io/"; target="_blank">SDKMAN</a> provides a convenient
Command Line Interface (CLI) to install and upgrade Java. We also suggest you
use the most recent version of Maven
+to compile <a href="https://maven.apache.org/download.cgi"; target="_blank">(at
least 3.x.x)</a>.</p>
-<p>Navigate to the root directory of your project.</p>
+<h3 id="linux-or-osx">Linux or OSX</h3>
-<p>To to build the project without running the tests run the command:</p>
+<p>To start you can run the command <code class="language-plaintext
highlighter-rouge">mvn clean package</code> from the root folder of the
Baremaps project. Upon successful
+compilation you should see something similar to the following output in your
terminal.</p>
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>[INFO] Building zip:
/path-to-project/baremaps/baremaps-cli/target/baremaps.zip
+[INFO] ------------------------------------------------------------------------
+[INFO] Reactor Summary for baremaps 0.7.1-SNAPSHOT:
+[INFO]
+[INFO] baremaps ........................................... SUCCESS [ 4.172 s]
+[INFO] baremaps-core ...................................... SUCCESS [ 59.018 s]
+[INFO] baremaps-benchmark ................................. SUCCESS [ 1.775 s]
+[INFO] baremaps-ogcapi .................................... SUCCESS [ 9.796 s]
+[INFO] baremaps-server .................................... SUCCESS [ 0.787 s]
+[INFO] baremaps-cli ....................................... SUCCESS [ 20.687 s]
+[INFO] ------------------------------------------------------------------------
+</code></pre></div></div>
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>./mvnw clean install -DskipTests
+<p>It is important to note the first line in the output above that notes where
the location of the <code class="language-plaintext
highlighter-rouge">baremaps.zip</code> file resides.
+Referencing the location of the <code class="language-plaintext
highlighter-rouge">baremaps.zip</code> file, you can run the following to unzip
+and place Baremaps into your <code class="language-plaintext
highlighter-rouge">PATH</code></p>
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>$ unzip
/path-to-project/baremaps/baremaps-cli/target/baremaps.zip
+$ export PATH=$PATH:`pwd`/baremaps/bin
</code></pre></div></div>
-<p>To unzip the distribution, run the command:</p>
+<p>Executing the <code class="language-plaintext
highlighter-rouge">baremaps</code> command should now result in an output
similar to the following:</p>
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>unzip ./baremaps-cli/target/baremaps.zip
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>Usage: baremaps [COMMAND]
+A toolkit for producing vector tiles.
+Commands:
+ import Import OpenStreetMap data in the Postgresql database.
+ update Update OpenStreetMap data in the Postgresql database.
+ export Export vector tiles from the Postgresql database.
+ serve Serve vector tiles from the the Postgresql database.
</code></pre></div></div>
-<p>To add the distribution to your system’s PATH environment variable, run the
command:</p>
+<p>From here, head into <a
href="/getting-started/installing-postgis/">Installing PostGIS</a> if you plan
to work with vector tiles.</p>
-<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>export PATH=$PATH:pwd/baremaps
-</code></pre></div></div>
+<p>If you want to work on <a href="/examples/geocoding/">Geocoding</a> or
+<a href="/examples/ip-to-location/">IP to location</a>, head directly into the
related examples.</p>
+
+<h3 id="windows">Windows</h3>
+
+<p>If you are using Windows, you will need to use <code
class="language-plaintext highlighter-rouge">mvnw.cmd</code> instead of <code
class="language-plaintext highlighter-rouge">./mvnw</code> and use set instead
of export to set the environment variable.</p>
<p><a class="edit"
href="https://github.com/apache/incubator-baremaps-site/edit/main/developer-manual/how-to-build-with-maven/index.md";><i
class="fas fa-edit"></i> Improve this page</a></p>
</article>
diff --git a/output/sitemap.xml b/output/sitemap.xml
index 89b717f..6a66f56 100644
--- a/output/sitemap.xml
+++ b/output/sitemap.xml
@@ -74,6 +74,6 @@
</url>
<url>
<loc>/assets/demo.html</loc>
-<lastmod>2023-01-26T22:49:55+00:00</lastmod>
+<lastmod>2023-02-04T22:44:33+00:00</lastmod>
</url>
</urlset>
