summaryrefslogtreecommitdiffstats
path: root/documentation/getting-started/getting-started-netbeans.asciidoc
diff options
context:
space:
mode:
authorMarkus Koivisto <markus@vaadin.com>2016-01-22 14:55:18 +0200
committerMarkus Koivisto <markus@vaadin.com>2016-01-22 14:55:18 +0200
commit99d6de546c74f0eed230ea8253dda6b85109d2e7 (patch)
tree10fc21c557566fe3241e6e13499df18d80f8dcb2 /documentation/getting-started/getting-started-netbeans.asciidoc
parent610736d9f373d4b37fd39ff8f90aabd13eab7926 (diff)
downloadvaadin-framework-99d6de546c74f0eed230ea8253dda6b85109d2e7.tar.gz
vaadin-framework-99d6de546c74f0eed230ea8253dda6b85109d2e7.zip
Add documentation to master branch
Change-Id: I2504bb10f1ae73ec0cbc08b7ba5a88925caa1674
Diffstat (limited to 'documentation/getting-started/getting-started-netbeans.asciidoc')
-rw-r--r--documentation/getting-started/getting-started-netbeans.asciidoc61
1 files changed, 61 insertions, 0 deletions
diff --git a/documentation/getting-started/getting-started-netbeans.asciidoc b/documentation/getting-started/getting-started-netbeans.asciidoc
new file mode 100644
index 0000000000..6e2fa660de
--- /dev/null
+++ b/documentation/getting-started/getting-started-netbeans.asciidoc
@@ -0,0 +1,61 @@
+---
+title: Creating a Project with NetBeans IDE
+order: 7
+layout: page
+---
+
+[[getting-started.netbeans]]
+= Creating a Project with NetBeans IDE
+
+The easiest way to develop Vaadin application with the NetBeans IDE is to use
+the Vaadin Plugin for NetBeans. It allows you to create new Vaadin projects
+easily and provides many features for working on a project. You can download the
+plugin at http://plugins.netbeans.org/plugin/50531/vaadin-plug-in-for-netbeans.
+The download page contains a link to a plugin features overview in NetBeans
+Wiki.
+
+Without the plugin, you can most easily create a Vaadin project as a Maven
+project using a Vaadin archetype. You can also create a Vaadin project as a
+regular web application project, but it requires many manual steps to install
+all the Vaadin libraries, create the UI class, configure the servlet, create
+theme, and so on.
+
+[[getting-started.netbeans.maven]]
+== Maven Project from a Vaadin Archetype
+
+Creating a Maven project with a Vaadin archetype creates an application skeleton
+with a UI class and project theme, defines the [filename]#web.xml# deployment
+descriptor, and also retrieves the latest Vaadin library automatically.
+
+. Select "File > New Project".
+
+. Select "Maven > Project from Archetype" and click [guibutton]#Next#.
+
+. Find [literal]#++vaadin-archetype-application++#, select it, and click
+[guilabel]#Next#.
+
+. In the [guilabel]#Name and Location# step, enter [guilabel]#Project Name#, which
+is recommended to be only lower-case alphabetics, as it is used also as a
+suggestion for the Java package name of the project. Modify the other parameters
+for your project and click [guibutton]#Finish#.
+
++
+[[figure.getting-started.netbeans.maven.new-project]]
+.Adding a New Maven Project in NetBeans
+image::img/netbeans-maven-newproject-name.png[]
+
+
+Creating the project can take a while as Maven loads all the needed
+dependencies. Once created, you can run it by right-clicking on the project in
+the [guilabel]#Projects# view and selecting [guilabel]#Run#. In the
+[guilabel]#Select deployment server# window that opens, select
+[guilabel]#Glassfish# or [guilabel]#Apache Tomcat#, and click [guibutton]#OK#.
+If all goes well, NetBeans starts the server in port 8080 and, depending on your
+system configuration, launches the default browser to display the web
+application. If not, you can open it manually, for example, at
+http://localhost:8080/myproject. The project name is used by default as the
+context path of the application.
+
+
+
+