Tani ekzistojnë mjete të shumta për të mbajtur shënime, një që më ka tërhequr vëmendjen është burimi i ri, i fuqishëm dhe i hapur Dokumente, e cila është një alternativë e vërtetë për zbatimet e pronarit të kësaj zone.
Çfarë është dokumentet?
shkresa është një alternativë me burim të hapur për marrjen e shënimeve, mbështet Evernote, Microsoft OneNote & Google Keep.
shkresa është shkruar në PHP, duke përdorur kornizën laravel 4. Ndërtuar në krye të AngularJS y Bootstrap 3, fAi siguron një ndërfaqe moderne të përdoruesit të uebit, si dhe një API të hapur për integrimin e palëve të treta.
Për pjesën e prapme, ajo ruan gjithçka në një bazë të dhënash MySQL. Me kërkesa të tilla të zakonshme (Linux, Apache, MySQL, PHP), shkresa Do të jetë në gjendje të ekzekutohet jo vetëm në servera të dedikuar, por edhe në pajisje të vogla dhe të mesme NAS (Synology, QNAP, etj.).
Si të provoni një demo të dokumenteve
Ne mund të provojmë një demo të dokumenteve duke hyrë në rastet e punës në internet të ofruara nga stuhi rëre y Cloudron. Mund ta provosh Dokumente në stuhi rëre (pa u futur) ose Shkresa në Cloudron (emri i përdoruesit: cloudron, fjalëkalimi: cloudron).
Çdo natë në 3 të mëngjesit (CET), baza e të dhënave bie dhe rikrijohet, dhe azhurnimet më të fundit për GitHub janë botuar.
Mos ngurroni të krijoni / modifikoni / fshini llogari, fletore dhe shënime. Kjo demonstrim mund të përdoret për prova të forta pa ndonjë problem.
Kërkesat për të instaluar dokumentet
- php5
- MySQL
- nginx, llambë ...
- përdridhem
- nodejs
Si të instaloni dokumentet
Instaloni dokumente në Ubuntu 14.10
Kjo do t'ju udhëzojë hap pas hapi se si të instaloni një Serveri LEMP dhe dokumentet. Ky udhëzues është shkruar dhe testuar në Ubuntu 14.10 i cili mund të funksionojë edhe me versione të vjetra.
Instaloni varësi
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
Nëse po planifikoni të përdorni MySQL, rekomandohet që ta konfiguroni në mënyrë të sigurt:
/usr/bin/mysql_secure_installation
Për të aktivizuar mcrypt në skedarët e konfigurimit të PHP, do të duhet të shtoni sa vijon në fund të konfigurimit për php5-cli dhe php5-fpm:
extension=mcrypt.so
vi /etc/php5/fpm/php.ini
vi /etc/php5/cli/php.ini
instaloni kompozitorin
curl -sS https://getcomposer.org/installer | php
drejtoni kompozitorin pa specifikuar rrugën
mv composer.phar /usr/local/bin/composer
Krijoni direktori për ta instaluar shkresa
mkdir /var/www/
cd /var/www/
download shkresa përdorim git:
git clone https://github.com/twostairs/paperwork.git
Shko tek direktoria e frontit:
cd ./paperwork/frontend/
Ekzekutoni "instalimin e kompozitorit" dhe / ose "azhurnimin e kompozitorit". Kjo do të instalojë të gjitha varësitë e nevojshme.
composer install
Tani, duhet të vendosni kredencialet tuaja MySQL në frontend / app / config / database.php. Për instalim lokal, një bazë të dhënash dokumentesh mund të konfigurohet për të punuar me cilësimet e paracaktuara:
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
Pas përfundimit të këtyre hapave, ekzekutoni detyrat e migrimit, të cilat mbushin bazën e të dhënave:
php artisan migrate
Ndryshoni lejet e dokumenteve në direktorinë në internet në përdoruesin që punon nginx:
chown www-data:www-data -R /var/www/
Redaktoni cilësimet e parazgjedhura të faqes që të përputhen: / 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;
}
}
Instaloni npm:
wget https://www.npmjs.org/install.sh
bash ./install.sh
Instaloni gllënjkë dhe kthesë:
npm install -g gulp bower
Instaloni varësitë e npm të projektit
npm install
Instaloni varësitë e bower dhe ekzekutoni detyrat e paracaktuara
bower install
gulp
Rinisni Nginx dhe php
service nginx restart
service php5-fpm restart
Ne mund të hyjmë localhost:8888
dhe fillo të shijosh shkresa
Instaloni dokumente në Debian 7
Kjo do t'ju udhëzojë hap pas hapi se si të instaloni një Serveri LEMP dhe dokumentet. Ky udhëzues është shkruar dhe testuar në Debian 7 i cili mund të funksionojë edhe me versione të vjetra.
Ne duhet të shtojmë backports të depove, të nevojshme për të instaluar Node.js në skedarin /etc/apt/sources.list:
deb http://http.debian.net/debian wheezy-backports main
Instaloni varësi
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
Nëse po planifikoni të përdorni MySQL, rekomandohet që ta konfiguroni në mënyrë të sigurt:
/usr/bin/mysql_secure_installation
Instalo kompozitorin
curl -sS https://getcomposer.org/installer | php
drejtoni kompozitorin pa specifikuar rrugën
mv composer.phar /usr/local/bin/composer
Krijoni direktori për ta instaluar shkresa:
mkdir /var/www/
cd /var/www/
download shkresa përdorim git:
git clone https://github.com/twostairs/paperwork.git
Shko tek direktoria e frontit:
cd ./paperwork/frontend/
Ekzekutoni "instalimin e kompozitorit" dhe / ose "azhurnimin e kompozitorit". Kjo do të instalojë varësitë e nevojshme.
composer install
Ne duhet të lidhim dokumentet me serverin tuaj SQL. Krijoni "database.json" dhe kopjoni skedarin "default_database.json":
cp app/storage/config/default_database.json app/storage/config/database.json
Ose, futni kredencialet e serverit tuaj SQL në "database.json", për një instalim të thjeshtë në serverin tuaj lokal, ne mund të krijojmë një bazë të dhënash që punon me konfigurimin e paracaktuar:
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
Pas përfundimit të këtyre hapave, ekzekutoni detyrat e migrimit, të cilat mbushin bazën e të dhënave:
php artisan migrate
Ndryshoni lejet e dokumenteve në direktorinë në internet në përdoruesin që punon nginx:
chown www-data:www-data -R /var/www/
Redaktoni cilësimet e parazgjedhura të faqes që të përputhen: / 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;
}
}
instalo npm
wget https://www.npmjs.org/install.sh
bash ./install.sh
instaloni gllënjkë dhe përkulje
npm install -g gulp bower
Instaloni varësitë e kërkuara nga npm për projektin
npm install
Instaloni varësitë e bower dhe drejtoni detyrat e nevojshme
bower install
gulp
Rinisni Nginx dhe php
service nginx restart
service php5-fpm restart
Përditësoni dokumentet, ekzekutoni (nga / frontend)
sudo php artisan paperwork:update
Dokumentacioni i dokumenteve
Dokumentacioni i API mund të gjendet në dokumente.shkrime.pafieria.io ose duke përdorur bletarin.apib nga depo zyrtare e dokumenteve. Dokumentet janë në zhvillim e sipër, kështu që priten ndryshime të mëtejshme.
Kontribuoni në dokumentet
Për të kontribuar në dokumentet mund të përdorni sa më poshtë dega e git. Kështu që për tu zhvilluar, duhet të klononi depon Github, dhe për të marrë një degë të re. Vlerësoni ndryshimet e degëzimit dhe më pas shtyni azhurnimet në degën e zhvillimit.
Nëse jeni të interesuar për këtë projekt dhe doni të kontribuoni, mund të kontaktoni zhvilluesin marius@paperwork.rocks) ose Twitter (@devilx) -
Ekziston një kanal IRC #workwork në freenode.net dhe ekziston një grup vezullim.