From a1b265c318dbda4a213cec930785b81e4c0f7d2b Mon Sep 17 00:00:00 2001
From: elmot <elmot@vaadin.com>
Date: Fri, 25 Sep 2015 16:40:44 +0300
Subject: Framework documentation IN

Change-Id: I767477c1fc3745f9e1f58075fe30c9ac8da63581
---
 .../getting-started-netbeans.asciidoc              | 61 ++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 documentation/getting-started/getting-started-netbeans.asciidoc

(limited to 'documentation/getting-started/getting-started-netbeans.asciidoc')

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.
+
+
+
+
-- 
cgit v1.2.3

