В даний час існує безліч інструментів для створення нотаток, один із яких привернув мою увагу - це новий, потужний і відкритий код Оформлення документів, що є реальною альтернативою власним програмам цієї галузі.
Що таке документи?
Паперова робота це альтернатива з відкритим кодом для створення нотаток, вона підтримує Evernote, Microsoft OneNote і Google Keep.
Паперова робота це написано на PHP, використовуючи фреймворк Ларавел 4. Побудований поверх AngularJS y Bootstrap 3, сВін пропонує сучасний веб-інтерфейс користувача, а також відкритий API для інтеграції сторонніх розробників.
Для внутрішньої частини він зберігає все у базі даних MySQL. З такими загальними вимогами (Linux, Apache, MySQL, PHP), Паперова робота він зможе працювати не тільки на виділених серверах, але і на малих та середніх пристроях NAS (Synology, QNAP тощо).
Як протестувати демонстраційний документ
Ми можемо протестувати демонстраційне оформлення «Паперових робіт», отримавши доступ до примірників вакансій в Інтернеті, наданих Піщана буря y Cloudron. Ви можете спробувати Оформлення документів в Піщана буря (без входу в систему) або Оформлення документів у Cloudron (ім'я користувача: cloudron, пароль: cloudron).
Щовечора о 3 ранку (за центральноєвропейським часом) база даних скидається та відтворюється, а останні оновлення на GitHub розгортаються.
Не соромтеся створювати / змінювати / видаляти облікові записи, блокноти та нотатки. Ця демонстрація може бути використана для сильного тестування без будь-яких проблем.
Вимоги до встановлення документів
- php5
- MySQL
- nginx, лампа ...
- витися
- nodejs
Як встановити документи
Встановіть документи на Ubuntu 14.10
Це допоможе вам крок за кроком встановити LEMP сервер та оформлення документів. Цей посібник був написаний та протестований на Ubuntu 14.10, який також може працювати зі старими версіями.
Встановити залежності
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
Якщо ви плануєте використовувати MySQL, рекомендується безпечно налаштувати його:
/usr/bin/mysql_secure_installation
Щоб увімкнути mcrypt у файлах конфігурації PHP, вам потрібно буде додати внизу конфігурації для php5-cli та php5-fpm:
extension=mcrypt.so
vi /etc/php5/fpm/php.ini
vi /etc/php5/cli/php.ini
встановити композитор
curl -sS https://getcomposer.org/installer | php
запустити композитор, не вказавши шлях
mv composer.phar /usr/local/bin/composer
Створити каталог для встановлення Паперова робота
mkdir /var/www/
cd /var/www/
скачати Паперова робота використання мерзотник:
git clone https://github.com/twostairs/paperwork.git
Перейдіть до каталогу інтерфейсу:
cd ./paperwork/frontend/
Запустіть "встановлення композитора" та / або "оновлення композитора". Це встановить всі необхідні залежності.
composer install
Тепер ви повинні розмістити свої облікові дані MySQL у frontend / app / config / database.php. Для локальної інсталяції базу даних паперів можна налаштувати на роботу із параметрами за замовчуванням:
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
Після виконання цих кроків запустіть завдання міграції, які заповнюють базу даних:
php artisan migrate
Змініть дозволи на оформлення документів у веб-каталозі на запущеного користувача nginx:
chown www-data:www-data -R /var/www/
Відредагуйте налаштування сайту за замовчуванням, щоб вони відповідали: / 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;
}
}
Встановити npm:
wget https://www.npmjs.org/install.sh
bash ./install.sh
Встановіть ковток:
npm install -g gulp bower
Встановіть залежності проекту npm
npm install
Встановіть залежності bower та запустіть завдання за замовчуванням
bower install
gulp
Перезапустіть Nginx та php
service nginx restart
service php5-fpm restart
Ми можемо отримати доступ localhost:8888
і почніть насолоджуватися Паперова робота
Встановіть документи на Debian 7
Це допоможе вам крок за кроком встановити LEMP сервер та оформлення документів. Цей посібник був написаний і протестований на Debian 7, який також може працювати зі старими версіями.
Ми повинні додати бекпорти сховища, необхідні для встановлення Node.js до файлу /etc/apt/sources.list:
deb http://http.debian.net/debian wheezy-backports main
Встановити залежності
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
Якщо ви плануєте використовувати MySQL, рекомендується безпечно налаштувати його:
/usr/bin/mysql_secure_installation
Встановіть композитор
curl -sS https://getcomposer.org/installer | php
запустити композитор, не вказавши шлях
mv composer.phar /usr/local/bin/composer
Створити каталог для встановлення Паперова робота:
mkdir /var/www/
cd /var/www/
скачати Паперова робота використання мерзотник:
git clone https://github.com/twostairs/paperwork.git
Перейдіть до каталогу інтерфейсу:
cd ./paperwork/frontend/
Запустіть "встановлення композитора" та / або "оновлення композитора". Це встановить необхідні залежності.
composer install
Ми повинні підключити документи до вашого SQL Server. Створіть "database.json" і скопіюйте файл "default_database.json":
cp app/storage/config/default_database.json app/storage/config/database.json
Або введіть облікові дані вашого SQL-сервера в "database.json", для простої установки на вашому локальному сервері ми можемо створити базу даних, яка працює з конфігурацією за замовчуванням:
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
Після виконання цих кроків запустіть завдання міграції, які заповнюють базу даних:
php artisan migrate
Змініть дозволи на оформлення документів у веб-каталозі на запущеного користувача nginx:
chown www-data:www-data -R /var/www/
Відредагуйте налаштування сайту за замовчуванням, щоб вони відповідали: / 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;
}
}
встановити npm
wget https://www.npmjs.org/install.sh
bash ./install.sh
встановіть ковток і капот
npm install -g gulp bower
Встановіть необхідні залежності npm для проекту
npm install
Встановіть залежності Bower та запустіть необхідні завдання
bower install
gulp
Перезапустіть Nginx та php
service nginx restart
service php5-fpm restart
Оновити документи, запустити (з / інтерфейсу)
sudo php artisan paperwork:update
Паперова документація
Документацію щодо API можна знайти за адресою docs. paperwork.apiary.io або за допомогою пасіки.apib від офіційне сховище документів. Документи оформляються, тож очікуються подальші зміни.
Сприяти оформленню документів
Для участі у оформленні документів ви можете використовувати наступне git-гілка. Тож для розробки вам потрібно клонувати сховище в Github, і отримати нову гілку. Перевірте зміни розгалуження, а потім надішліть оновлення до гілки розробки.
Якщо ви зацікавлені в цьому проекті і хочете зробити свій внесок, ви можете зв’язатися з розробником marius@paperwork.rocks) або Twitter (@devilx) -
Існує канал IRC # paperwork на freenode.net, і є група сітка.