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.
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.
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.
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.
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.
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