Cách ghi chú bằng Giấy tờ

Hiện nay có rất nhiều công cụ để ghi chú, một công cụ khiến tôi chú ý là mã nguồn mở mới, mạnh mẽ và Thủ tục giấy tờ, là một giải pháp thay thế thực sự cho các ứng dụng độc quyền của lĩnh vực này.

Giấy tờ là gì?

thủ tục giấy tờ là một giải pháp thay thế mã nguồn mở để ghi chú, nó hỗ trợ Evernote, Microsoft OneNote & Google Keep.

giấy tờ

giấy tờ

thủ tục giấy tờ nó được viết bằng PHP, sử dụng khuôn khổ Laravel 4. Được xây dựng trên đầu trang của AngularJS y Bootstrap 3, pNó cung cấp giao diện người dùng web hiện đại, cũng như một API mở để tích hợp bên thứ ba.

Đối với phần back-end, nó lưu trữ mọi thứ trong cơ sở dữ liệu MySQL. Với những yêu cầu chung như vậy (Linux, Apache, MySQL, PHP), thủ tục giấy tờ nó sẽ có thể chạy không chỉ trên các máy chủ chuyên dụng mà còn trên các thiết bị NAS vừa và nhỏ (Synology, QNAP, v.v.).

Cách kiểm tra bản trình diễn Giấy tờ

Chúng tôi có thể kiểm tra bản demo của Paperwork bằng cách truy cập các phiên bản việc làm trực tuyến được cung cấp bởi  Bảo cát y đám mây.  Bạn co thể thử Thủ tục giấy tờ trong Bão cát (mà không cần đăng nhập) hoặc Thủ tục giấy tờ trong Cloudron (tên người dùng: cloudron, mật khẩu: cloudron).

Mỗi đêm vào lúc 3 giờ sáng (CET), cơ sở dữ liệu được xóa và tạo lại, đồng thời ra mắt các bản cập nhật mới nhất trên GitHub.

Thoải mái tạo / sửa đổi / xóa tài khoản, sổ ghi chép và ghi chú. Bản demo này có thể được sử dụng để thử nghiệm mạnh mẽ mà không gặp bất kỳ vấn đề gì.

Yêu cầu để cài đặt Paperwork

  • php5
  • mysql
  • nginx, đèn ...
  • quăn lại
  • nútjs

Cách cài đặt Paperwork

Cài đặt Paperwork trên Ubuntu 14.10

Điều này sẽ hướng dẫn bạn từng bước cách cài đặt Máy chủ LEMP và các thủ tục giấy tờ. Hướng dẫn này được viết và thử nghiệm trên Ubuntu 14.10, có thể hoạt động với các phiên bản cũ hơn.


Cài đặt phần phụ thuộc

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ếu bạn đang có kế hoạch sử dụng MySQL, bạn nên cấu hình nó một cách an toàn:

/usr/bin/mysql_secure_installation

Để bật mcrypt trong các tệp cấu hình PHP, bạn sẽ cần thêm phần sau vào cuối cấu hình cho php5-cli và php5-fpm:

extension=mcrypt.so

vi /etc/php5/fpm/php.ini
vi /etc/php5/cli/php.ini

cài đặt nhà soạn nhạc

curl -sS https://getcomposer.org/installer | php

chạy trình soạn nhạc mà không chỉ định đường dẫn

mv composer.phar /usr/local/bin/composer

Tạo thư mục để cài đặt thủ tục giấy tờ

mkdir /var/www/
cd /var/www/

tải về thủ tục giấy tờ sử dụng git:

git clone https://github.com/twostairs/paperwork.git

Đi tới thư mục giao diện người dùng:

 cd ./paperwork/frontend/

Chạy "cài đặt trình soạn nhạc" và / hoặc "cập nhật trình soạn nhạc". Điều này sẽ cài đặt tất cả các phụ thuộc cần thiết.

composer install

Bây giờ, bạn phải đặt thông tin đăng nhập MySQL của mình vào frontend / app / config / database.php. Để cài đặt cục bộ, cơ sở dữ liệu thủ tục giấy tờ có thể được cấu hình để hoạt động với các cài đặt mặc định:

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

Sau khi hoàn thành các bước này, hãy chạy các tác vụ di chuyển, tác vụ này sẽ điền vào cơ sở dữ liệu:

php artisan migrate

Thay đổi quyền Paperwork trên thư mục web thành nginx người dùng đang chạy:

chown www-data:www-data -R /var/www/

Chỉnh sửa cài đặt trang web mặc định để phù hợp với: / 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;

        }

}

Cài đặt npm:

 wget https://www.npmjs.org/install.sh
 bash ./install.sh

Cài đặt gulp và bower:

 npm install -g gulp bower

Cài đặt phần phụ thuộc npm của dự án

 npm install

Cài đặt phụ thuộc bower và chạy các tác vụ mặc định

 bower install
 gulp

Khởi động lại Nginx và php

service nginx restart
service php5-fpm restart

Chúng tôi có thể truy cập localhost:8888 và bắt đầu tận hưởng thủ tục giấy tờ

Cài đặt Paperwork trên Debian 7

Điều này sẽ hướng dẫn bạn từng bước cách cài đặt Máy chủ LEMP và các thủ tục giấy tờ. Hướng dẫn này được viết và thử nghiệm trên Debian 7 có thể hoạt động với các phiên bản cũ hơn.

Chúng ta phải thêm các backport của kho lưu trữ, được yêu cầu để cài đặt Node.js vào tệp /etc/apt/sources.list:

 deb http://http.debian.net/debian wheezy-backports main

Cài đặt phần phụ thuộc

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ếu bạn đang có kế hoạch sử dụng MySQL, bạn nên cấu hình nó một cách an toàn:

/usr/bin/mysql_secure_installation

Cài đặt trình soạn nhạc

curl -sS https://getcomposer.org/installer | php

chạy trình soạn nhạc mà không chỉ định đường dẫn

mv composer.phar /usr/local/bin/composer

Tạo thư mục để cài đặt thủ tục giấy tờ:

mkdir /var/www/
cd /var/www/

tải về thủ tục giấy tờ sử dụng git:

git clone https://github.com/twostairs/paperwork.git

Đi tới thư mục giao diện người dùng:

 cd ./paperwork/frontend/

Chạy "cài đặt trình soạn nhạc" và / hoặc "cập nhật trình soạn nhạc". Điều này sẽ cài đặt các phụ thuộc cần thiết.

composer install

Chúng tôi phải kết nối Paperwork với SQL Server của bạn. Tạo "database.json" và sao chép tệp "default_database.json":

cp app/storage/config/default_database.json app/storage/config/database.json

Hoặc, nhập thông tin đăng nhập của máy chủ SQL của bạn vào "database.json", để cài đặt đơn giản trên máy chủ cục bộ của bạn, chúng tôi có thể thiết lập cơ sở dữ liệu hoạt động với cấu hình mặc định:

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

Sau khi hoàn thành các bước này, hãy chạy các tác vụ di chuyển, tác vụ này sẽ điền vào cơ sở dữ liệu:

php artisan migrate

Thay đổi quyền Paperwork trên thư mục web thành nginx người dùng đang chạy:

chown www-data:www-data -R /var/www/

Chỉnh sửa cài đặt trang web mặc định để phù hợp với: / 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;

        }

}

cài đặt npm

 wget https://www.npmjs.org/install.sh
 bash ./install.sh

cài đặt gulp và bower

 npm install -g gulp bower

Cài đặt các phụ thuộc npm bắt buộc cho dự án

 npm install

Cài đặt các phụ thuộc bower và chạy các tác vụ cần thiết

 bower install
 gulp

Khởi động lại Nginx và php

service nginx restart
service php5-fpm restart

Cập nhật thủ tục giấy tờ, chạy (from / frontend)

  sudo php artisan paperwork:update

Hồ sơ thủ tục giấy tờ

Tài liệu API có thể được tìm thấy tại docs.paperwork.apiary.io hoặc sử dụng apiary.apib từ kho lưu trữ thủ tục giấy tờ chính thức. Thủ tục giấy tờ đang được phát triển, vì vậy dự kiến ​​sẽ có những thay đổi tiếp theo.

Đóng góp vào thủ tục giấy tờ

Để đóng góp cho thủ tục giấy tờ, bạn có thể sử dụng chi nhánh git. Vì vậy, để phát triển, bạn phải sao chép kho lưu trữ trong Githubvà có được một chi nhánh mới. Xác thực các thay đổi nhánh và sau đó đẩy các bản cập nhật đến nhánh phát triển.

Nếu bạn quan tâm đến dự án này và muốn đóng góp, bạn có thể liên hệ với nhà phát triển marius@paperwork.rocks) hoặc Twitter (@devilx) -

Có một kênh IRC #paperwork trên freenode.net và có một nhóm lưới.


Để lại bình luận của bạn

địa chỉ email của bạn sẽ không được công bố. Các trường bắt buộc được đánh dấu bằng *

*

*

  1. Chịu trách nhiệm về dữ liệu: Miguel Ángel Gatón
  2. Mục đích của dữ liệu: Kiểm soát SPAM, quản lý bình luận.
  3. Hợp pháp: Sự đồng ý của bạn
  4. Truyền thông dữ liệu: Dữ liệu sẽ không được thông báo cho các bên thứ ba trừ khi có nghĩa vụ pháp lý.
  5. Lưu trữ dữ liệu: Cơ sở dữ liệu do Occentus Networks (EU) lưu trữ
  6. Quyền: Bất cứ lúc nào bạn có thể giới hạn, khôi phục và xóa thông tin của mình.