Saltar al contenido

Puedes utilizar Pegotes de dos formas: como desarrollador o como usuario final. La primera es a partir del código fuente, la segunda a partir de un paquete de instalación.

Si solamente deseas utilizar Pegotes ve directo al paso 5.

1 - Instalar Java Development Kit

Primeramente necesitas instalar el Java Development Kit:

$ apt-get install openjdk-7-jdk
$ java -version

Actualmente estoy desarrollando Pegotes con el JDK 7, sin embargo debería funcionar sin problemas con la versión 6.

2 - Instalar Play framework

Una vez tengas Java debes instalar el framework con que se desarrolla Pegotes: Play 2. Puedes descargarlo desde http://www.playframework.org/download. Dentro del paquete descargado encontrarás las instrucciones para su instalación.

Actualmente estoy desarrollando Pegotes con la versión 2.1.0 de Play.

3 - Personalización (opcional)

Recuerda que Pegotes es Software Libre, y una de sus cuatro libertades te permite modificarlo y ajustarlo a tus necesidades.

La forma más fácil de hacerlo es cambiando las hojas de estilos (CSS). Los CSS de Pegotes están escritos en LESS, un lenguaje que al compilarlo se obtiene como resultado CSS. Son fácilmene identificables por su extensión .less y se encuentran en el directorio app/assets/stylesheets. Una de las ventajas de utilizar LESS en lugar de CSS desde un principio es que durante el desarrollo de la aplicación Play auto compila los .less y si se le pide también los minifica.

Otra forma de personalizar Pegotes es modificando sus archivos de vistas, que están en app/views y con extensión .scala.html. Estas vistas están compuestas por código Html y código Scala. Si has tenido experiencias previas con motores de plantillas Html encontrarás familiar la sintaxis. Te resultará útil leer la documentación de Play acerca del motor de plantillas

Una vez modifiques los .less o los .scala.html deberás compilar la aplicación.

4 - Compilar la aplicación

El próximo paso es compilar Pegotes. Para eso abre una terminal en el directorio raíz de la aplicación y ejecuta lo siguiente:

$ play dist

El comando anterior creará un archivo Pegotes-1.0-SNAPSHOT.zip dentro del directorio target/universal relativo al directorio del proyecto. Este archivo contiene la aplicación compilada y lista para ejecutar.

5 - Ejecutar la aplicación

Una vez tengas el archivo con la aplicación compilada descomprímelo en un directorio en el que tengas permiso de lectura y de escritura:

$ unzip Pegotes-1.0-SNAPSHOT.zip

Luego entra en el directorio bin dentro de la aplicación descomprimida, asegúrate de que el archivo pegotes tiene permiso de ejecución, y ejecútalo:

$ cd Pegotes-1.0-SNAPSHOT/bin
$ chmod a+x pegotes
$ ./pegotes

Si utilizas Windows debes ejecutar el archivo pegotes.bat en lugar de pegotes.

Esto iniciará la aplicación. Una vez iniciada podrás utilizarla accediendo a http://localhost:9000