Как делать заметки с помощью документов

В настоящее время существует множество инструментов для создания заметок, один из которых привлек мое внимание - это новый мощный инструмент с открытым исходным кодом. Оформление документации, что является реальной альтернативой проприетарным приложениям в этой области.

Что такое оформление документов?

Оформление документации это альтернатива с открытым исходным кодом для создания заметок, она поддерживает Evernote, Microsoft OneNote и Google Keep.

оформление документации

оформление документации

Оформление документации он написан на PHP с использованием фреймворка Laravel 4. Построен на вершине AngularJS y Bootstrap 3, стр.Он предоставляет современный веб-интерфейс, а также открытый API для сторонней интеграции.

Для серверной части он хранит все в базе данных MySQL. С такими общими требованиями (Linux, Apache, MySQL, PHP), Оформление документации Он сможет работать не только на выделенных серверах, но и на небольших и средних NAS-устройствах (Synology, QNAP и т. Д.).

Как протестировать демонстрацию работы с документами

Мы можем протестировать демонстрацию работы с документами, открыв онлайн-экземпляры вакансий, предоставленные  Песчаная буря y Cloudron.  Можешь попробовать Оформление документов в песчаной буре (без входа в систему) или Оформление документов в Cloudron (имя пользователя: cloudron, пароль: cloudron).

Каждую ночь в 3 часа ночи (CET) база данных удаляется и создается заново, а также выкатываются последние обновления на GitHub.

Не стесняйтесь создавать / изменять / удалять учетные записи, записные книжки и заметки. Эту демонстрацию можно без проблем использовать для строгого тестирования.

Требования для установки документов

  • php5
  • mysql
  • nginx, лампа ...
  • виться
  • nodejs

Как установить документы

Установите Paperwork на 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" и / или "composer update". Это установит все необходимые зависимости.

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

Установите gulp и bower:

 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" и / или "composer update". Это установит необходимые зависимости.

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

установить gulp и bower

 npm install -g gulp bower

Установите необходимые зависимости npm для проекта

 npm install

Установите зависимости bower и запустите необходимые задачи

 bower install
 gulp

Перезагрузите Nginx и php

service nginx restart
service php5-fpm restart

Обновите документы, запустите (из / frontend)

  sudo php artisan paperwork:update

Документация по оформлению документов

Документацию по API можно найти по адресу docs.paperwork.apiary.io или используя apiary.apib из официальное хранилище документов. Оформление документов находится в стадии разработки, поэтому ожидаются дальнейшие изменения.

Участвуйте в оформлении документов

Чтобы внести свой вклад в оформление документов, вы можете использовать следующие ветка git. Итак, для разработки вам нужно клонировать репозиторий в Github, и получите новую ветку. Подтвердите изменения ветвления, а затем отправьте обновления в ветвь разработки.

Если вы заинтересованы в этом проекте и хотите внести свой вклад, вы можете связаться с разработчиком marius@paperwork.rocks) или в Twitter (@devilx) -

На freenode.net есть IRC-канал # paperwork и есть группа сетка.


Содержание статьи соответствует нашим принципам редакционная этика. Чтобы сообщить об ошибке, нажмите здесь.

Будьте первым, чтобы комментировать

Оставьте свой комментарий

Ваш электронный адрес не будет опубликован. Обязательные для заполнения поля помечены *

*

*

  1. Ответственный за данные: Мигель Анхель Гатон
  2. Назначение данных: контроль спама, управление комментариями.
  3. Легитимация: ваше согласие
  4. Передача данных: данные не будут переданы третьим лицам, кроме как по закону.
  5. Хранение данных: база данных, размещенная в Occentus Networks (ЕС)
  6. Права: в любое время вы можете ограничить, восстановить и удалить свою информацию.