Sa kasalukuyan maraming mga tool para sa pagkuha ng mga tala, ang isa na nakakuha ng aking pansin ay ang bago, malakas at bukas na mapagkukunan Mga papeles, na kung saan ay isang tunay na kahalili sa pagmamay-ari na mga aplikasyon ng lugar na ito.
Ano ang papeles?
Papeles ay isang bukas na alternatibong mapagkukunan para sa pagkuha ng tala, sinusuportahan nito ang Evernote, Microsoft OneNote at Google Keep.
Papeles nakasulat ito sa PHP, gamit ang balangkas laravel 4. Itinayo sa tuktok ng AngularJS y Bootstrap 3, pNagbibigay ito ng isang modernong interface ng gumagamit ng web, pati na rin isang bukas na API para sa pagsasama ng third-party.
Para sa back-end na bahagi ay iniimbak nito ang lahat sa isang database MySQL. Na may tulad mga karaniwang kinakailangan (Linux, Apache, MySQL, PHP), Papeles magagawa nitong patakbuhin hindi lamang sa mga nakalaang server, kundi pati na rin sa maliliit at katamtamang aparato ng NAS (Synology, QNAP, atbp.).
Paano subukan ang isang demo ng Papel
Maaari naming subukan ang isang demo ng Papel sa pamamagitan ng pag-access sa mga pagkakataon sa online na trabaho na ibinigay ng Sandstorm y Cloudron. Maaari mong subukan Mga papeles sa Sandstorm (nang walang pag-log in) o Mga papeles sa Cloudron (username: cloudron, password: cloudron).
Tuwing gabi sa 3am (CET), ang database ay nahulog at muling nilikha, at ang pinakabagong mga pag-update sa GitHub ay inilunsad.
Huwag mag-atubiling lumikha / magbago / magtanggal ng mga account, notebook at tala. Ang demo na ito ay maaaring magamit para sa malakas na pagsubok nang walang anumang problema.
Mga kinakailangan upang mai-install ang papeles
- php5
- MySQL
- nginx, lampara ...
- kulutan
- NodeJS
Paano mag-install ng Papel
I-install ang Paperwork sa Ubuntu 14.10
Gagabayan ka nito hakbang-hakbang kung paano i-install ang a LEMP server at mga gawaing papel. Ang gabay na ito ay nakasulat at nasubok sa Ubuntu 14.10 na maaaring gumana sa mga mas lumang bersyon din.
Mag-install ng mga dependency
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
Kung nagpaplano kang gamitin ang MySQL, inirerekumenda na ligtas mong i-configure ito:
/usr/bin/mysql_secure_installation
Upang paganahin ang mcrypt sa mga file ng pagsasaayos ng PHP, kakailanganin mong idagdag ang sumusunod sa ilalim ng pagsasaayos para sa php5-Palem at php5-fpm:
extension=mcrypt.so
vi /etc/php5/fpm/php.ini
vi /etc/php5/cli/php.ini
i-install ang kompositor
curl -sS https://getcomposer.org/installer | php
patakbuhin ang kompositor nang hindi tinukoy ang landas
mv composer.phar /usr/local/bin/composer
Lumikha ng direktoryo upang mai-install Papeles
mkdir /var/www/
cd /var/www/
I-download ang Papeles paggamit pumunta:
git clone https://github.com/twostairs/paperwork.git
Pumunta sa direktoryo ng frontend:
cd ./paperwork/frontend/
Patakbuhin ang "pag-install ng kompositor" at / o "pag-update ng kompositor". I-install nito ang lahat ng kinakailangang mga dependency.
composer install
Ngayon, dapat mong ilagay ang iyong mga kredensyal ng MySQL sa frontend / app / config / database.php. Para sa lokal na pag-install, ang isang papeles na database ay maaaring mai-configure upang gumana sa mga default na setting:
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
Matapos makumpleto ang mga hakbang na ito, patakbuhin ang mga gawain sa paglipat, na kung saan ang populasyon ng database:
php artisan migrate
Baguhin ang mga pahintulot sa Papelwork sa web-direktoryo sa tumatakbo na user nginx:
chown www-data:www-data -R /var/www/
I-edit ang mga default na setting ng site upang tumugma sa: / etc / nginx / mga site-magagamit / 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;
}
}
I-install ang npm:
wget https://www.npmjs.org/install.sh
bash ./install.sh
I-install ang gulp at bower:
npm install -g gulp bower
Mag-install ng mga dependency ng proyekto ng npm
npm install
Mag-install ng mga dependency ng bower at patakbuhin ang mga default na gawain
bower install
gulp
I-restart ang Nginx at php
service nginx restart
service php5-fpm restart
Maaari naming ma-access localhost:8888
at magsimulang mag-enjoy Papeles
I-install ang Mga papeles sa Debian 7
Gagabayan ka nito hakbang-hakbang kung paano i-install ang a LEMP server at mga gawaing papel. Ang gabay na ito ay nakasulat at nasubok sa Debian 7 na maaaring gumana sa mga mas lumang bersyon din.
Dapat naming idagdag ang mga repository backport, kinakailangan upang mai-install ang Node.js sa /etc/apt/source.list file:
deb http://http.debian.net/debian wheezy-backports main
Mag-install ng mga dependency
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
Kung nagpaplano kang gamitin ang MySQL, inirerekumenda na ligtas mong i-configure ito:
/usr/bin/mysql_secure_installation
Mag-install ng kompositor
curl -sS https://getcomposer.org/installer | php
patakbuhin ang kompositor nang hindi tinukoy ang landas
mv composer.phar /usr/local/bin/composer
Lumikha ng direktoryo upang mai-install Papeles:
mkdir /var/www/
cd /var/www/
I-download ang Papeles paggamit pumunta:
git clone https://github.com/twostairs/paperwork.git
Pumunta sa direktoryo ng frontend:
cd ./paperwork/frontend/
Patakbuhin ang "pag-install ng kompositor" at / o "pag-update ng kompositor". I-install nito ang mga kinakailangang pagpapakandili.
composer install
Dapat naming ikonekta ang Mga papeles sa iyong SQL Server. Lumikha ng "database.json" at kopyahin ang file na "default_database.json":
cp app/storage/config/default_database.json app/storage/config/database.json
O, ipasok ang iyong mga kredensyal sa SQL server sa "database.json", para sa isang simpleng pag-install sa iyong lokal na server, maaari kaming magtaguyod ng isang database na gagana sa default na pagsasaayos:
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
Matapos makumpleto ang mga hakbang na ito, patakbuhin ang mga gawain sa paglipat, na kung saan ang populasyon ng database:
php artisan migrate
Baguhin ang mga pahintulot sa Papelwork sa web-direktoryo sa tumatakbo na user nginx:
chown www-data:www-data -R /var/www/
I-edit ang mga default na setting ng site upang tumugma sa: / etc / nginx / mga site-magagamit / 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;
}
}
i-install ang npm
wget https://www.npmjs.org/install.sh
bash ./install.sh
i-install ang gulp at bower
npm install -g gulp bower
I-install ang kinakailangang mga dependency ng npm para sa proyekto
npm install
Mag-install ng mga dependency ng bower at patakbuhin ang mga kinakailangang gawain
bower install
gulp
I-restart ang Nginx at php
service nginx restart
service php5-fpm restart
I-update ang Papel, patakbuhin (mula sa / frontend)
sudo php artisan paperwork:update
Dokumentasyon ng papeles
Ang dokumentasyon ng API ay matatagpuan sa dokumentong papeles.apiary.io o gamit ang apiary.apib mula sa opisyal na imbakan ng papel. Ang papeles ay nasa ilalim ng pag-unlad, kaya't inaasahan ang karagdagang mga pagbabago.
Mag-ambag sa papeles
Upang magbigay ng kontribusyon sa papeles maaari mong gamitin ang sumusunod sangay ng git. Kaya upang makabuo, kailangan mong i-clone ang imbakan sa Github, at kumuha ng bagong sangay. Patunayan ang mga pagbabago sa sumasanga at pagkatapos ay itulak ang mga pag-update sa nabuong sangay.
Kung interesado ka sa proyektong ito at nais mong mag-ambag, maaari kang makipag-ugnay sa nag-develop marius@paperwork.rocks) o Twitter (@devilx) -
Mayroong isang IRC channel # paperwork sa freenode.net at mayroong isang pangkat grid.