Pegotes es un pastebin hecho con el objetivo de generar un tráfico de red mínimo. Para lograrlo, ofrece una interfaz gráfica liviana y varias APIs que permiten acceder al servicio sin necesidad de una interfaz gráfica.
Además de las funciones básicas de cualquier pastebin (guardar texto y asociarlo a una URL a través de una interfaz gráfica), Pegotes agrega las siguientes (por ahora):
- API Xml
- API Json
- API texto plano
- Adaptable a distintas resoluciones de pantalla: desde móviles hasta PCs
- Disponible en español, inglés, francés, alemán, portugués, ruso, italiano y esperanto
- Twitter: Si quieres mantenerte informado del progreso del desarrollo de Pegotes puedes seguirme en Twitter.
- Dreamcatchers: Si estás en Cuba, puedes aportar nuevas ideas a través de la red social Dreamcatchers
Hay varias formas en las que puedes ser útil en este proyecto, estas son algunas:
Probar la aplicación en tu entrono de trabajo particular: puede parecer trivial, pero esto ayudaría a detectar y corregir problemas de compatibilidad con navegadores, máquinas virtuales, servidores frontend, y muchos otros que no imagino aún.
Sugerir nuevas ideas: ¿Tienes una idea genial para Pegotes? Contáctame, quizá pronto esté trabajando en ella.
Escribir código: No tienes que ser un veterano en Java para implementar nuevas funcionalidades, corregir bugs, etc. Sería útil que antes de pensar en escribir código para Pegotes tuvieras una noción de cómo funciona Play 2: su forma de hacer las cosas se aparta un poco de las "Buenas Prácticas" para programar en Java. Varias formas de contribuir con código pueden ser:
- **Clientes para las APIs**: Esto es algo que pienso hacer cuando Pegotes alcance un grado de terminación aceptable, pero tú pudieras hacerlo antes. Personalmente, desearía que existieran clientes integrados en forma de plugins con los principales IDEs, como Eclipse, NetBeans, VisualStudio, y otros para la línea de comandos de los sistemas operativos.
- **Nuevas APIs**: Inicialmente incluí sólo tres APIs porque me parecieron las más utilizadas. Sin embargo es posible que te sea mejor utilizar una distinta a las tres existentes y desees implementarla. Seguramente otros que también las utilicen agradecerán tu aporte.
- **Casos de prueba**: Una parte importante del código son los casos de prueba. Diseñarlos e implementarlos correctamente, y darles mantenimiento sería de gran ayuda para mantener Pegotes libre de errores.
Escribir documentación: Es importante tener una buena documentación que indique cómo sacarle el máximo provecho a Pegotes. Los usuarios y desarrolladores la agradecerán.
Traducir la interfaz a otros idiomas: Para que Pegotes sea fácil de utilizar para la mayorías de las personas su interfaz debe estar disponible en varios idiomas.
Apoyar el depliegue: Normalmente utilizo una conexión a Internet extremadamante lenta (a veces más que navegar me ahogo :)). Apreciaría muchísimo que me ayudaras a poner las versiones estables de Pegotes (ya compiladas) en lugares desde los que los usuarios finales puedan descargarlas, como Source Forge.
Si te decides a colaborar deja una idea en Dreamcatchers o escríbeme a juan.mejias [arroba] reduc.edu.cu
Actualmente estoy trabajando en cómo poner Pegotes en Heroku para que puedas verlo funcionando antes de instalarlo.
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 utiizar Pegotes ve directo al paso 5.
Primeramente necesitas instalar el Java Development Kit:
$ apt-get install openjdk-7-jdk
$ java -versionActualmente 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.2.1 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 distEl 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.zipLuego entra en el directorio de la aplicación descomprimida, asegúrate de que el archivo start tiene permiso de ejecución, y ejecútalo:
$ cd pegotes-1.0-SNAPSHOT
$ chmod +x start
$ ./start
Esto iniciará el servidor de la aplicación. Una vez iniciado podrás utilizar la aplicación accediendo a localhost por el puerto 9000
Pegotes es desarrollado por Juan Carlos Mejías Rodríguez [email protected] y otros colaboradores. Para más información lee el archivo COPYING.