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.
Índice
¿Qué es Paperwork?
Paperwork es una alternativa de código abierto para la toma de notas, soporta Evernote, Microsoft OneNote & Google Keep.
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