Cómo tomar notas con Paperwork

En la actualidad existen numerosas herramientas para la toma de nota, una que me ha llamado mucho la atención es la nueva, poderosa y de código abierto Paperwork, la cuál es una alternativa real a las aplicaciones privativas de este rubro.

¿Qué es Paperwork?

Paperwork es una alternativa de código abierto para la toma de notas, soporta Evernote, Microsoft OneNote & Google Keep.

paperwork

paperwork

Paperwork está escrito en PHP, utilizando el framework Laravel 4. Construido encima de AngularJS y Bootstrap 3,  proporciona una moderna interfaz web de usuario, así como una API abierta para la integración de terceros.

Para la parte de back-end almacena todo en una base de datos MySQL. Con tales requisitos comunes (Linux, Apache, MySQL, PHP), Paperwork será capaz de ejecutarse no sólo en servidores dedicados, sino también en los pequeños y medianos dispositivos NAS (Synology, QNAP , etc.) .

Cómo probar una demo de Paperwork

Podemos probar una demo de Paperwork accediendo a instancias de trabajo online proporcionadas por  Sandstorm y Cloudron.  Puedes probar Paperwork en Sandstorm (sin iniciar sesión) o Paperwork en Cloudron (nombre de usuario: cloudron, contraseña : cloudron).

Todas las noches a las 3 am (CET),  se elimina la base de datos y se vuelve a  crear, y las últimas actualizaciones en GitHub se despliegan.

Siéntase libre para crear / modificar / eliminar cuentas, cuadernos y notas. Esta demostración se puede utilizar para hacer pruebas  fuertes sin ningún tipo de problema.

Requisitos para  instalar Paperwork

  • php5
  • mysql
  • nginx, lamp …
  • curl
  • nodejs

Cómo instalar Paperwork

Instalar Paperwork en Ubuntu 14.10

Esto le guiará paso a paso cómo instalar un servidor LEMP y paperwork. Esta guía fue escrita y probada en Ubuntu 14.10 que puede funcionar con versiones anteriores también.


Instalar las dependencias

apt-get update
apt-get install mysql-server php5-mysql nginx php5-fpm curl wget git php5-cli php5-gd php5-mcrypt nodejs nodejs-legacy

Si usted está planeando usar MySQL, se recomienda que lo configure de forma segura:

/usr/bin/mysql_secure_installation

Habilitar mcrypt en los archivos de configuración de PHP, tendrá que añadir lo siguiente en la parte inferior de la configuración para  php5-cli y php5-fpm:

extension=mcrypt.so

vi /etc/php5/fpm/php.ini
vi /etc/php5/cli/php.ini

instalar composer

curl -sS https://getcomposer.org/installer | php

ejecutar composer sin especificar la ruta

mv composer.phar /usr/local/bin/composer

Crea el directorio para instalar Paperwork

mkdir /var/www/
cd /var/www/

Descargar Paperwork usando git:

git clone https://github.com/twostairs/paperwork.git

Ir al directorio frontend:

 cd ./paperwork/frontend/

Ejecutar «composer install» y/o «composer update». Esto instalará todas las dependencias necesarias.

composer install

Ahora, usted debe poner sus credenciales de MySQL enfrontend/app/config/database.php. Para la instalación local, se puede configurar una base de datos de paperwork para que trabaje con la configuración por defecto:

DROP DATABASE IF EXISTS paperwork;
CREATE DATABASE IF NOT EXISTS paperwork DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT ALL PRIVILEGES ON paperwork.* TO 'paperwork'@'localhost' IDENTIFIED BY 'paperwork' WITH GRANT OPTION;
FLUSH PRIVILEGES;
quit

Una vez completados estos pasos, ejecute las tareas de migración, que llenan la base de datos:

php artisan migrate

Cambiar los permisos de Paperwork en el web-directory a el user nginx que se está ejecutando:

chown www-data:www-data -R /var/www/

Editar la configuración por defecto del  sitio para que concuerde con: /etc/nginx/sites-available/default

server {
        listen   80;
        # listen 443 ssl;

        root /var/www/paperwork/frontend/public;
        index index.php index.html index.htm;

        server_name example.com;

        # server_name example.com;
        # ssl_certificate /etc/nginx/ssl/server.crt;
        # ssl_certificate_key /etc/nginx/ssl/server.key;

        location / {
                try_files $uri $uri/ /index.php;
        }

        error_page 404 /404.html;

        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
              root /usr/share/nginx/www;
        }

        # pass the PHP scripts to FastCGI server listening on the php-fpm socket
        location ~ \.php$ {
                try_files $uri =404;
                fastcgi_pass unix:/var/run/php5-fpm.sock;
                fastcgi_index index.php;
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                include fastcgi_params;

        }

}

Instalar npm:

 wget https://www.npmjs.org/install.sh
 bash ./install.sh

Instalar gulp y bower:

 npm install -g gulp bower

Instalar las  dependencias npm del proyecto

 npm install

Instalar dependencias bower y ejecutar las  tareas por defecto

 bower install
 gulp

Reiniciar Nginx y php

service nginx restart
service php5-fpm restart

Podemos acceder a localhost:8888 y comenzar a disfrutar de Paperwork

Instalar Paperwork en Debian 7

Esto le guiará paso a paso cómo instalar un servidor LEMP y paperwork. Esta guía fue escrita y probada en Debian 7 que puede funcionar con versiones anteriores también.

Debemos añadir el backports repositorio, requerido para instalar Node.js al archivo /etc/apt/sources.list:

 deb http://http.debian.net/debian wheezy-backports main

Instalar dependencias

apt-get update
apt-get install mysql-server php5-mysql nginx php5-fpm curl wget git php5-cli php5-gd php5-mcrypt nodejs nodejs-legacy

Si usted está planeando usar MySQL, se recomienda que lo configure de forma segura:

/usr/bin/mysql_secure_installation

Instalar composer

curl -sS https://getcomposer.org/installer | php

ejecutar composer sin especificar la ruta

mv composer.phar /usr/local/bin/composer

Crea el directorio para instalar Paperwork:

mkdir /var/www/
cd /var/www/

Descargar Paperwork usando git:

git clone https://github.com/twostairs/paperwork.git

Ir al directorio frontend:

 cd ./paperwork/frontend/

Ejecutar «composer install» y/o «composer update».  Esto instalará las dependencias necesarias.

composer install

Debemos  conectar Paperwork a  tu SQL Server. Crear «database.json» y copiar el archivo «default_database.json»:

cp app/storage/config/default_database.json app/storage/config/database.json

O bien, introduzca las credenciales de su servidor SQL en «database.json», para una instalación simple en su servidor local, podemos establecer una base de datos que trabaje con la configuración por defecto:

DROP DATABASE IF EXISTS paperwork;
CREATE DATABASE IF NOT EXISTS paperwork DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT ALL PRIVILEGES ON paperwork.* TO 'paperwork'@'localhost' IDENTIFIED BY 'paperwork' WITH GRANT OPTION;
FLUSH PRIVILEGES;
quit

Una vez completados estos pasos, ejecute las tareas de migración, que llenan la base de datos:

php artisan migrate

Cambiar los permisos de Paperwork en el web-directory a el user nginx que se está ejecutando:

chown www-data:www-data -R /var/www/

Editar la configuración por defecto del  sitio para que concuerde con: /etc/nginx/sites-available/default

server {
        listen   80;
        # listen 443 ssl;

        root /var/www/paperwork/frontend/public;
        index index.php index.html index.htm;

        server_name example.com;

        # server_name example.com;
        # ssl_certificate /etc/nginx/ssl/server.crt;
        # ssl_certificate_key /etc/nginx/ssl/server.key;

        location / {
                try_files $uri $uri/ /index.php;
        }

        error_page 404 /404.html;

        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
              root /usr/share/nginx/www;
        }

        # pass the PHP scripts to FastCGI server listening on the php-fpm socket
        location ~ \.php$ {
                try_files $uri =404;
                fastcgi_pass unix:/var/run/php5-fpm.sock;
                fastcgi_index index.php;
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                include fastcgi_params;

        }

}

instalar npm

 wget https://www.npmjs.org/install.sh
 bash ./install.sh

instalar gulp y bower

 npm install -g gulp bower

Instalar las dependencias npm necesarias para el proyecto

 npm install

Instalar dependencias bower y ejecutar las tareas necesarias

 bower install
 gulp

Reiniciar Nginx y php

service nginx restart
service php5-fpm restart

Actualizar Paperwork, ejecutar (from /frontend)

  sudo php artisan paperwork:update

Documentación de Paperwork

La documentación de la API se puede encontrar en docs.paperwork.apiary.io o utilizando el apiary.apib del repositorio oficial de Paperwork.  Paperwork está en fase de desarrollo, por lo que se esperan nuevos cambios.

Contribuir a Paperwork

Para contribuir con Paperwork puedes utilizar la siguiente rama git. Así que para desarrollar, debe clonar el repositorio en Github, y obtenga una nueva rama. Validar los cambios que se ramifican y luego envía las actualizaciones a la rama desarrollarse.

Si está interesado en este proyecto  y desea contribuir, puede comunicarse con e ldesarrollador marius@paperwork.rocks ) o Twitter ( @devilx )-

Hay un canal IRC #paperwork en freenode.net y existe un grupo gitter.


Sé el primero en comentar

Deja tu comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

*

*

  1. Responsable de los datos: Miguel Ángel Gatón
  2. Finalidad de los datos: Controlar el SPAM, gestión de comentarios.
  3. Legitimación: Tu consentimiento
  4. Comunicación de los datos: No se comunicarán los datos a terceros salvo por obligación legal.
  5. Almacenamiento de los datos: Base de datos alojada en Occentus Networks (UE)
  6. Derechos: En cualquier momento puedes limitar, recuperar y borrar tu información.