How To Use The Archetypes

In this page the procedure to install and use the entando-archetypes project is described.

• Open your terminal
• Create an empty directory for your project

mkdir ~/my_new_project

• Move to a directory of your choosing

cd ~/my_new_project

• clone in the following sequence entando-core, entando-components, entando-archetypesprojects:

git clone https://github.com/entando/entando-core
git clone https://github.com/entando/entando-components
git clone https://github.com/entando/entando-archetypes

• Install, in the following sequence, the entando-core, entando-components, entando-archetypes projects:

cd entando-core
mvn clean install -DskipTests

cd entando-components 
mvn clean install -DskipTests

cd entando-archetypes 
mvn clean install -DskipTests

• Create an empty directory and generate a test web application:

 $ mvn archetype:generate -Dfilter=entando

The following options are showed:

1: remote -> org.entando.entando:entando-archetype-bundle-content (Archetype of Bundle for Content Type)
2: remote -> org.entando.entando:entando-archetype-bundle-misc (Archetype of Bundle for Generic Misc related to Entando old version projects)
3: remote -> org.entando.entando:entando-archetype-bundle-page-generic (Archetype of Bundle for Generic Page related to Entando old version projects)
4: remote -> org.entando.entando:entando-archetype-bundle-showlet-generic (Archetype of Bundle for Generic Showlet related to Entando old version projects)
5: remote -> org.entando.entando:entando-archetype-bundle-theme-generic (Archetype of Bundle for Theme)
6: remote -> org.entando.entando:entando-archetype-bundle-widget-generic (Archetype of Bundle for Widget)
7: remote -> org.entando.entando:entando-archetype-plugin-generic (Archetype of Widget)
8: remote -> org.entando.entando:entando-archetype-portal-bootstrap (Archetype of Entando portal based on Twitter Bootstrap)
9: remote -> org.entando.entando:entando-archetype-portal-generic (Archetype of generic Entando portal)

NOTE: If the Entando projects are updated into Maven Central Repository, options could change.

• Now you can choose the archetype:

If you want to create your new portal application based on Bootstrap, you have to type the number 9:

Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): : 9

• Choose the version project:

Choose org.entando.entando:entando-archetype-portal-generic version: 
1: 2.4.0
2: 2.4.0.1
3: 3.0.0
4: 3.0.0-01
5: 3.0.0-02
6: 3.2.0
7: 3.2.0-01
8: 4.0.0
9: 4.0.0-01
10: 4.2.0-SNAPSHOT
11: 4.2.0-TP1

• If you want to join, for instance, with the latest version of the Entando source code, you should choose the number 11:

Choose a number: 11: 11

• Type your groupId. It is generally unique amongst an organization or a project. You can type "mycompany".

Define value for property 'groupId': : mycompany

• Define the artifactId. It is generally the name of your project:

Define value for property 'artifactId': : myportalexample

• The following instructions are showed:

Define value for property 'version':  1.0-SNAPSHOT: : 
Define value for property 'package':  mycompany: : 
Confirm properties configuration:
groupId: mycompany
artifactId: myportalexample
version: 1.0-SNAPSHOT
package: mycompany
 Y: : 

Finally, type Y.

Your Entando portal based on Boostrap, has been built successflully!

As described in [Getting Started] (https://github.com/entando/entando-core/wiki/Getting-Started) page of [entando-core] (https://github.com/entando/entando-core) project, you can:

• Enter the newly created folder of your myportalexample project
• Launch Jetty