În prezent există numeroase instrumente pentru a lua notițe, unul care mi-a atras atenția este noul, puternic și open source Hârtii, care este o alternativă reală la aplicațiile proprietare din acest domeniu.
Ce este Hârtia?
hârtiile este o alternativă open source pentru luarea de note, acceptă Evernote, Microsoft OneNote și Google Keep.
hârtiile Este scris în PHP, folosind framework-ul laravel 4. Construit deasupra AngularJS y Bootstrap 3, poferă o interfață web modernă pentru utilizator, precum și un API deschis pentru integrarea terților.
Pentru partea back-end, acesta stochează totul într-o bază de date MySQL. Cu astfel de cerințe comune (Linux, Apache, MySQL, PHP), hârtiile Va putea rula nu numai pe servere dedicate, ci și pe dispozitive NAS mici și medii (Synology, QNAP etc.).
Cum să încerci o demonstrație a documentelor
Putem încerca o demonstrație de documentare accesând instanțe de lucru online furnizate de Furtună de nisip y Cloudron. Poti incerca Hârtii în Sandstorm (fără a te autentifica) sau Hârtii în Cloudron (nume de utilizator: cloudron, parolă: cloudron).
În fiecare noapte, la ora 3 am (CET), baza de date este ștearsă și recreată, iar cele mai recente actualizări de pe GitHub sunt implementate.
Simțiți-vă liber să creați/modificați/ștergeți conturi, caiete și note. Această demonstrație poate fi folosită pentru a face teste puternice fără probleme.
Cerințe pentru a instala Paperwork
- php5
- MySQL
- nginx, lampă...
- răsuci
- nodejs
Cum se instalează Paperwork
Instalați Paperwork pe Ubuntu 14.10
Acest lucru vă va ghida pas cu pas cum să instalați un Server LEMP și actele. Acest ghid a fost scris și testat pe Ubuntu 14.10, care poate funcționa și cu versiuni mai vechi.
Instalați dependențe
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
Dacă intenționați să utilizați MySQL, este recomandat să îl configurați în siguranță:
/usr/bin/mysql_secure_installation
Pentru a activa mcrypt în fișierele de configurare PHP, va trebui să adăugați următoarele în partea de jos a configurației pentru php5-cli și php5-fpm:
extension=mcrypt.so
vi /etc/php5/fpm/php.ini
vi /etc/php5/cli/php.ini
instalați compozitorul
curl -sS https://getcomposer.org/installer | php
rulați compozitorul fără a specifica calea
mv composer.phar /usr/local/bin/composer
Creați directorul de instalat hârtiile
mkdir /var/www/
cd /var/www/
descărcare hârtiile utilizând merge:
git clone https://github.com/twostairs/paperwork.git
Accesați directorul frontend:
cd ./paperwork/frontend/
Rulați „composer install” și/sau „composer update”. Acest lucru va instala toate dependențele necesare.
composer install
Acum, trebuie să vă puneți acreditările MySQL în frontend/app/config/database.php. Pentru instalarea locală, o bază de date de documente poate fi configurată să funcționeze cu configurația implicită:
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
Odată finalizați acești pași, executați sarcinile de migrare, care populează baza de date:
php artisan migrate
Schimbați permisiunile pentru documente din directorul web la utilizatorul nginx care rulează:
chown www-data:www-data -R /var/www/
Editați configurația implicită a site-ului pentru a se potrivi cu: /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;
}
}
Instalați npm:
wget https://www.npmjs.org/install.sh
bash ./install.sh
Instalați gulp și bower:
npm install -g gulp bower
Instalați dependențele npm ale proiectului
npm install
Instalați dependențe Bower și rulați sarcini implicite
bower install
gulp
Reporniți Nginx și php
service nginx restart
service php5-fpm restart
Putem accesa localhost:8888
și începe să te bucuri hârtiile
Instalați Paperwork pe Debian 7
Acest lucru vă va ghida pas cu pas cum să instalați un Server LEMP și actele. Acest ghid a fost scris și testat pe Debian 7, care poate funcționa și cu versiuni mai vechi.
Trebuie să adăugăm depozitul backports, necesar pentru a instala Node.js în fișierul /etc/apt/sources.list:
deb http://http.debian.net/debian wheezy-backports main
Instalați dependențe
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
Dacă intenționați să utilizați MySQL, este recomandat să îl configurați în siguranță:
/usr/bin/mysql_secure_installation
Instalați compozitorul
curl -sS https://getcomposer.org/installer | php
rulați compozitorul fără a specifica calea
mv composer.phar /usr/local/bin/composer
Creați directorul de instalat hârtiile:
mkdir /var/www/
cd /var/www/
descărcare hârtiile utilizând merge:
git clone https://github.com/twostairs/paperwork.git
Accesați directorul frontend:
cd ./paperwork/frontend/
Rulați „composer install” și/sau „composer update”. Acest lucru va instala dependențele necesare.
composer install
Trebuie să conectăm Documentele la serverul dvs. SQL. Creați „database.json” și copiați fișierul „default_database.json”:
cp app/storage/config/default_database.json app/storage/config/database.json
Sau, introduceți acreditările serverului SQL în „database.json”, pentru o instalare simplă pe serverul local, putem stabili o bază de date care funcționează cu configurația implicită:
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
Odată finalizați acești pași, executați sarcinile de migrare, care populează baza de date:
php artisan migrate
Schimbați permisiunile pentru documente din directorul web la utilizatorul nginx care rulează:
chown www-data:www-data -R /var/www/
Editați configurația implicită a site-ului pentru a se potrivi cu: /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;
}
}
instalați npm
wget https://www.npmjs.org/install.sh
bash ./install.sh
instalați gulp și bower
npm install -g gulp bower
Instalați dependențele npm necesare pentru proiect
npm install
Instalați dependențe Bower și executați sarcinile necesare
bower install
gulp
Reporniți Nginx și php
service nginx restart
service php5-fpm restart
Actualizați documentele, rulați (de pe /frontend)
sudo php artisan paperwork:update
Documentație pentru documente
Documentația API poate fi găsită la docs.paperwork.apiary.io sau folosind stupina.apib al depozitul oficial de documente. Documentele sunt în faza de dezvoltare, așa că sunt așteptate noi schimbări.
Contribuiți la documente
Pentru a contribui la Documente, puteți folosi următoarele ramură git. Deci, pentru a dezvolta, trebuie să clonați depozitul în Githubși obțineți o nouă sucursală. Validați modificările de ramificare și apoi împingeți actualizările în ramura de dezvoltare.
Dacă sunteți interesat de acest proiect și doriți să contribui, puteți contacta dezvoltatorul marius@paperwork.rocks) sau Twitter (@devilx) -
Există un canal IRC #paperwork pe freenode.net și există un grup grilă.