[doc] Update SourceForge.net URLs due to rename to LibrePlan
FEA: ItEr75S03CommunityMaterial
This commit is contained in:
Manuel Rego Casasnovas
parent
d2ce89dd14
commit
d49b0c18c4
5 changed files with 215 additions and 16 deletions
9
HACKING
9
HACKING
|
|
@ -72,10 +72,11 @@ Debian/Ubuntu
|
|||
|
||||
* Download source code::
|
||||
|
||||
$ git clone git://navalplan.git.sourceforge.net/gitroot/navalplan/navalplan
|
||||
$ git clone git://libreplan.git.sourceforge.net/gitroot/libreplan/libreplan
|
||||
|
||||
* Compile project::
|
||||
|
||||
$ cd libreplan/
|
||||
$ mvn clean install
|
||||
|
||||
* Launch application::
|
||||
|
|
@ -121,10 +122,11 @@ Fedora
|
|||
|
||||
* Download source code::
|
||||
|
||||
$ git clone git://navalplan.git.sourceforge.net/gitroot/navalplan/navalplan
|
||||
$ git clone git://libreplan.git.sourceforge.net/gitroot/libreplan/libreplan
|
||||
|
||||
* Compile project::
|
||||
|
||||
$ cd libreplan/
|
||||
$ mvn clean install
|
||||
|
||||
* Launch application::
|
||||
|
|
@ -181,10 +183,11 @@ openSUSE
|
|||
|
||||
* Download source code::
|
||||
|
||||
$ git clone git://navalplan.git.sourceforge.net/gitroot/navalplan/navalplan
|
||||
$ git clone git://libreplan.git.sourceforge.net/gitroot/libreplan/libreplan
|
||||
|
||||
* Compile project::
|
||||
|
||||
$ cd libreplan/
|
||||
$ mvn clean install
|
||||
|
||||
* Launch application::
|
||||
|
|
|
|||
12
INSTALL
12
INSTALL
|
|
@ -29,13 +29,13 @@ Debian packages
|
|||
~~~~~~~~~~~~~~~
|
||||
|
||||
There are Debian packages for Squeeze (i386 and amd64), you can download them
|
||||
from: http://sourceforge.net/projects/navalplan/files/LibrePlan/
|
||||
from: http://sourceforge.net/projects/libreplan/files/LibrePlan/
|
||||
|
||||
Instructions:
|
||||
|
||||
* Download the package::
|
||||
|
||||
$ wget http://downloads.sourceforge.net/project/navalplan/files/LibrePlan/libreplan_1.2.0-1_amd64.deb
|
||||
$ wget http://downloads.sourceforge.net/project/libreplan/files/LibrePlan/libreplan_1.2.0-1_amd64.deb
|
||||
|
||||
* Install package::
|
||||
|
||||
|
|
@ -73,7 +73,7 @@ Debian/Ubuntu
|
|||
|
||||
* Download database installation script::
|
||||
|
||||
$ wget -O install.sql http://downloads.sourceforge.net/project/navalplan/LibrePlan/install_1.2.0.sql
|
||||
$ wget -O install.sql http://downloads.sourceforge.net/project/librelplan/LibrePlan/install_1.2.0.sql
|
||||
|
||||
* Create database structure::
|
||||
|
||||
|
|
@ -81,7 +81,7 @@ Debian/Ubuntu
|
|||
|
||||
* Download ``.war`` file from SourceForge.net::
|
||||
|
||||
$ wget -O libreplan.war http://downloads.sourceforge.net/project/navalplan/LibrePlan/libreplan_1.2.0.war
|
||||
$ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/LibrePlan/libreplan_1.2.0.war
|
||||
|
||||
* Create a new file ``/etc/tomcat6/Catalina/localhost/libreplan.xml`` (file
|
||||
name has to match with ``.war`` name) with database configuration for
|
||||
|
|
@ -180,7 +180,7 @@ openSUSE
|
|||
|
||||
* Download database installation script::
|
||||
|
||||
$ wget -O install.sql http://downloads.sourceforge.net/project/navalplan/LibrePlan/install_1.2.0.sql
|
||||
$ wget -O install.sql http://downloads.sourceforge.net/project/libreplan/LibrePlan/install_1.2.0.sql
|
||||
|
||||
* Create database structure::
|
||||
|
||||
|
|
@ -188,7 +188,7 @@ openSUSE
|
|||
|
||||
* Download ``.war`` file from SourceForge.net::
|
||||
|
||||
$ wget -O libreplan.war http://downloads.sourceforge.net/project/navalplan/LibrePlan/libreplan_1.2.0.war
|
||||
$ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/LibrePlan/libreplan_1.2.0.war
|
||||
|
||||
* Create a new file ``/etc/tomcat6/Catalina/localhost/libreplan.xml`` (file
|
||||
name has to match with ``.war`` name) with database configuration for
|
||||
|
|
|
|||
4
README
4
README
|
|
@ -126,10 +126,10 @@ Availability
|
|||
------------
|
||||
|
||||
The cutting-edge version of this project is always available from the Git
|
||||
repository at http://navalplan.git.sourceforge.net/.
|
||||
repository at http://libreplan.git.sourceforge.net/.
|
||||
|
||||
Released versions are available at
|
||||
http://sourceforge.net/projects/navalplan/files.
|
||||
http://sourceforge.net/projects/libreplan/files/.
|
||||
|
||||
|
||||
Webpage
|
||||
|
|
|
|||
10
UPDATE
10
UPDATE
|
|
@ -26,7 +26,7 @@ Instructions:
|
|||
|
||||
* Download the new package::
|
||||
|
||||
$ wget http://downloads.sourceforge.net/project/navalplan/NavalPlan/navalplan_1.1.1-1_amd64.deb
|
||||
$ wget http://downloads.sourceforge.net/project/libreplan/NavalPlan/navalplan_1.1.1-1_amd64.deb
|
||||
|
||||
* Install package::
|
||||
|
||||
|
|
@ -51,7 +51,7 @@ Debian/Ubuntu
|
|||
are upgrading from *LibrePlan 1.0.4* to *LibrePlan 1.1.1* you should download
|
||||
``upgrade_1.1.0.sql``::
|
||||
|
||||
$ wget http://downloads.sourceforge.net/project/navalplan/NavalPlan/upgrade_1.1.0.sql
|
||||
$ wget http://downloads.sourceforge.net/project/libreplan/NavalPlan/upgrade_1.1.0.sql
|
||||
|
||||
* Upgrade database::
|
||||
|
||||
|
|
@ -59,7 +59,7 @@ Debian/Ubuntu
|
|||
|
||||
* Download ``.war`` file of new version from SourceForge.net::
|
||||
|
||||
$ wget -O libreplan.war http://downloads.sourceforge.net/project/navalplan/NavalPlan/navalplan_1.1.1.war
|
||||
$ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/NavalPlan/navalplan_1.1.1.war
|
||||
|
||||
* Backup current deployed application::
|
||||
|
||||
|
|
@ -87,7 +87,7 @@ openSUSE
|
|||
are upgrading from *LibrePlan 1.0.4* to *LibrePlan 1.1.1* you should download
|
||||
``upgrade_1.1.0.sql``::
|
||||
|
||||
$ wget http://downloads.sourceforge.net/project/navalplan/NavalPlan/upgrade_1.1.0.sql
|
||||
$ wget http://downloads.sourceforge.net/project/libreplan/NavalPlan/upgrade_1.1.0.sql
|
||||
|
||||
* Upgrade database::
|
||||
|
||||
|
|
@ -95,7 +95,7 @@ openSUSE
|
|||
|
||||
* Download ``.war`` file of new version from SourceForge.net::
|
||||
|
||||
$ wget -O libreplan.war http://downloads.sourceforge.net/project/navalplan/NavalPlan/navalplan_1.1.1.war
|
||||
$ wget -O libreplan.war http://downloads.sourceforge.net/project/libreplan/NavalPlan/navalplan_1.1.1.war
|
||||
|
||||
* Backup current deployed application::
|
||||
|
||||
|
|
|
|||
196
doc/src/technical/howto-start-development-with-eclipse.rst
Normal file
196
doc/src/technical/howto-start-development-with-eclipse.rst
Normal file
|
|
@ -0,0 +1,196 @@
|
|||
How To Start Development With Eclipse
|
||||
=====================================
|
||||
|
||||
.. sectnum::
|
||||
|
||||
:Author: Manuel Rego Casasnovas
|
||||
:Contact: rego@igalia.com
|
||||
:Date: 16/12/2011
|
||||
:Copyright:
|
||||
Some rights reserved. This document is distributed under the Creative
|
||||
Commons Attribution-ShareAlike 3.0 licence, available in
|
||||
http://creativecommons.org/licenses/by-sa/3.0/.
|
||||
:Abstract:
|
||||
Quick guide to start the development of LibrePlan_ using Eclipse_ IDE.
|
||||
As this is the most common way of work among LibrePlan developers team.
|
||||
|
||||
.. contents:: Table of Contents
|
||||
|
||||
|
||||
Download LibrePlan source code
|
||||
------------------------------
|
||||
|
||||
You need to download LibrePlan_ source code to start hacking on it. You have two
|
||||
options:
|
||||
|
||||
a) Clone Git repository (recommended)::
|
||||
|
||||
$ git clone git://libreplan.git.sourceforge.net/gitroot/libreplan/libreplan libreplan
|
||||
|
||||
b) Download last version source code::
|
||||
|
||||
$ wget http://downloads.sourceforge.net/project/libreplan/files/LibrePlan/libreplan_1.2.0.tar.gz
|
||||
$ tar -xzvf libreplan_1.2.0.tar.gz
|
||||
|
||||
You should review ``HACKING`` file to check that you have installed all the
|
||||
requirements.
|
||||
|
||||
|
||||
Download Eclipse Java EE
|
||||
------------------------
|
||||
|
||||
* Go to download Eclipse page: http://www.eclipse.org/downloads/
|
||||
|
||||
* Download Eclipse IDE for **Java EE Developers** for your architecture
|
||||
|
||||
.. figure:: img/libreplan-download-eclipse.png
|
||||
:alt: Eclipse downloads webpage
|
||||
:width: 100%
|
||||
|
||||
Eclipse downloads webpage
|
||||
|
||||
|
||||
Install Ecliplse
|
||||
----------------
|
||||
|
||||
* Go to ``/opt/`` (or any other folder when you want to install Eclipse)::
|
||||
|
||||
# cd /opt/
|
||||
|
||||
* Uncompress downloaded file and set proper permissions::
|
||||
|
||||
# tar -xzvf ~/Downloads/eclipse-jee-indigo-SR1-linux-gtk-x86_64.tar.gz
|
||||
# chown -R root:root eclipse/
|
||||
|
||||
* Add symbolic link to launch Eclipse::
|
||||
|
||||
# cd /usr/local/bin/
|
||||
# ln -s /opt/eclipse/eclipse
|
||||
|
||||
|
||||
Install Eclipse Maven plugin (m2e)
|
||||
----------------------------------
|
||||
|
||||
* Run Eclipse::
|
||||
|
||||
$ eclipse
|
||||
|
||||
* Choose your workspace folder (or accept the default one) and mark to don't ask
|
||||
about it again
|
||||
|
||||
* Go to *Help* > *Install New Software...*
|
||||
|
||||
* Click in option *Add* and set the following values and click *Ok*:
|
||||
|
||||
* Name: m2e
|
||||
* Location: http://download.eclipse.org/technology/m2e/releases/
|
||||
|
||||
* Click *Next* to install plugin
|
||||
|
||||
.. figure:: img/libreplan-m2e.png
|
||||
:alt: Instal Eclipse Maven plugin (m2e)
|
||||
:width: 100%
|
||||
|
||||
Install Eclipse Maven plugin (m2e)
|
||||
|
||||
* Accept license agreements and click *Finish*
|
||||
|
||||
* Restart Eclipse once plugin installation has finished
|
||||
|
||||
|
||||
Import LibrePlan project
|
||||
------------------------
|
||||
|
||||
* Go to *File* > *Import*
|
||||
|
||||
* Select as import source *Maven* > *Exising Maven Projects* and click *Next*
|
||||
|
||||
.. figure:: img/libreplan-import-maven.png
|
||||
:alt: Import LibrePlan as Maven project
|
||||
:width: 100%
|
||||
|
||||
Import LibrePlan as Maven project
|
||||
|
||||
* Set as *Root Directory* the path where you downloaded LibrePlan source code
|
||||
|
||||
* Then mark all projects and click *Finish*
|
||||
|
||||
.. figure:: img/libreplan-poms.png
|
||||
:alt: Import LibrePlan from existent path
|
||||
:width: 100%
|
||||
|
||||
Import LibrePlan from existent path
|
||||
|
||||
* It is recommended to close ``libreplan`` project (right click over the project
|
||||
and choose *Close*)
|
||||
|
||||
|
||||
Configure project to run
|
||||
------------------------
|
||||
|
||||
* Go to *Run* > *Run Configurations...*
|
||||
|
||||
* Create a new *Maven Build* called *New_configuration*
|
||||
|
||||
* Change the following values:
|
||||
|
||||
* Name: LibrePlan
|
||||
* Base directory: Choose ``libreplan-webapp`` folder in your workspace
|
||||
* Goals: ``jetty:stop jetty:run``
|
||||
* Profiles (optional): ``-userguide,-reports`` (to disable userguide and
|
||||
reports profiles to save compilation time as they are not mandatory to run
|
||||
LibrePlan)
|
||||
* Mark the following checkboxes (recommended):
|
||||
|
||||
* Resolve Workspace artifacts
|
||||
* Update Snapshots
|
||||
* Skip Tests
|
||||
|
||||
.. figure:: img/libreplan-run-configurations.png
|
||||
:alt: Configure how to run LibrePlan in Eclipse
|
||||
:width: 100%
|
||||
|
||||
Configure how to run LibrePlan in Eclipse
|
||||
|
||||
* Click *Run* and application will be available at
|
||||
http://localhost:8080/libreplan-webapp/
|
||||
|
||||
|
||||
Configure Eclipse to follow coding style guidelines
|
||||
---------------------------------------------------
|
||||
|
||||
* Go to *Window* > *Preferences*
|
||||
|
||||
* Look for the different options to use always spaces instead of tabs and use 4
|
||||
spaces size for indentation
|
||||
|
||||
.. figure:: img/libreplan-preferences-tab.png
|
||||
:alt: Eclipse Preferences window
|
||||
:width: 100%
|
||||
|
||||
Eclipse Preferences window
|
||||
|
||||
* Create new profile to follow the coding style guidelines
|
||||
|
||||
.. figure:: img/libreplan-eclipse-profile.png
|
||||
:alt: New profile based on Eclipse default one
|
||||
:width: 100%
|
||||
|
||||
New profile based on Eclipse default one
|
||||
|
||||
* Configure *Save Actions* marking the following options:
|
||||
|
||||
* Perform the selected actions on save
|
||||
* Format source code
|
||||
* Format edited lines
|
||||
* Organize imports
|
||||
|
||||
.. figure:: img/libreplan-preferences-save-actions.png
|
||||
:alt: Save Actions configuration
|
||||
:width: 100%
|
||||
|
||||
Save Actions configuration
|
||||
|
||||
|
||||
.. _LibrePlan: http://www.libreplan.com/
|
||||
.. _Eclipse: http://www.eclipse.org
|
||||
Loading…
Add table
Reference in a new issue