You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2019/09/09 21:42:39 UTC
[isis] 08/11: ISIS-2062: moving helloworld and simpleapp into their
own Antora cpt.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch v2-antora
in repository https://gitbox.apache.org/repos/asf/isis.git
commit 90a53677bca63e03f6ebab3a4458b77e00ebb9f4
Author: Dan Haywood <da...@apache.org>
AuthorDate: Thu Aug 22 13:21:38 2019 +0100
ISIS-2062: moving helloworld and simpleapp into their own Antora cpt.
Moves the common prereq stuff into each so is standalone.
---
.../arch/modules/helloworld/pages/about.adoc | 19 +++++++++++++++++++
.../arch/modules/simpleapp/pages/about.adoc | 19 +++++++++++++++++++
2 files changed, 38 insertions(+)
diff --git a/antora/components/arch/modules/helloworld/pages/about.adoc b/antora/components/arch/modules/helloworld/pages/about.adoc
index 8d779e2..52b4a02 100644
--- a/antora/components/arch/modules/helloworld/pages/about.adoc
+++ b/antora/components/arch/modules/helloworld/pages/about.adoc
@@ -16,6 +16,25 @@ This also creates a minimal application, but provides more structure and example
+== Prerequisites
+
+Apache Isis is a Java based framework, so in terms of prerequisites, you'll need to install:
+
+* Java 8 JDK
+* link:http://maven.apache.org[Apache Maven] 3.5+
+
+You'll probably also want to use an IDE; the Apache Isis committers use either IntelliJ or Eclipse; in the xref:support:dg:ide.adoc[Developers' Guide] we have detailed setup instructions for using these two IDEs.
+If you're a NetBeans user you should have no problems as it too has strong support for Maven.
+
+When building and running within an IDE, you'll also need to configure the Datanucleus enhancer.
+This is implemented as a Maven plugin, so in the case of IntelliJ, it's easy enough to run the enhancer as required.
+It should be just as straightforward for NetBeans too.
+
+For Eclipse the maven integration story is a little less refined.
+All is not lost, however; DataNucleus also has an implementation of the enhancer as an Eclipse plugin, which usually works well enough.
+
+
+
== Generating the App
diff --git a/antora/components/arch/modules/simpleapp/pages/about.adoc b/antora/components/arch/modules/simpleapp/pages/about.adoc
index 20da56f..10ebacf 100644
--- a/antora/components/arch/modules/simpleapp/pages/about.adoc
+++ b/antora/components/arch/modules/simpleapp/pages/about.adoc
@@ -16,6 +16,25 @@ The (non-ASF) Incode Platform's link:http://platform.incode.org/quickstart/quick
====
+== Prerequisites
+
+Apache Isis is a Java based framework, so in terms of prerequisites, you'll need to install:
+
+* Java 8 JDK
+* link:http://maven.apache.org[Apache Maven] 3.5+
+
+You'll probably also want to use an IDE; the Apache Isis committers use either IntelliJ or Eclipse; in the xref:support:dg:ide.adoc[Developers' Guide] we have detailed setup instructions for using these two IDEs.
+If you're a NetBeans user you should have no problems as it too has strong support for Maven.
+
+When building and running within an IDE, you'll also need to configure the Datanucleus enhancer.
+This is implemented as a Maven plugin, so in the case of IntelliJ, it's easy enough to run the enhancer as required.
+It should be just as straightforward for NetBeans too.
+
+For Eclipse the maven integration story is a little less refined.
+All is not lost, however; DataNucleus also has an implementation of the enhancer as an Eclipse plugin, which usually works well enough.
+
+
+
== Generating the App