วิธีจดบันทึกด้วย Paperwork

ปัจจุบันมีเครื่องมือสำหรับจดบันทึกมากมายเครื่องมือที่ดึงดูดความสนใจของฉันคือโอเพ่นซอร์สใหม่ที่ทรงพลัง เอกสาร ซึ่งเป็นทางเลือกที่แท้จริงสำหรับการใช้งานที่เป็นกรรมสิทธิ์ของพื้นที่นี้

Paperwork คืออะไร?

เอกสาร เป็นทางเลือกโอเพ่นซอร์สสำหรับการจดบันทึกรองรับ Evernote, Microsoft OneNote และ Google Keep

เอกสาร มันเขียนด้วย PHP โดยใช้กรอบ ลาราเวล 4. สร้างขึ้นด้านบนของ AngularJS y Bootstrap 3, หน้ามีอินเทอร์เฟซผู้ใช้บนเว็บที่ทันสมัยตลอดจน API แบบเปิดสำหรับการรวมบุคคลที่สาม

สำหรับส่วนหลังจะเก็บทุกอย่างไว้ในฐานข้อมูล MySQL. ด้วยข้อกำหนดทั่วไปดังกล่าว (Linux, Apache, MySQL, PHP) เอกสาร มันจะสามารถทำงานได้ไม่เพียง แต่บนเซิร์ฟเวอร์เฉพาะเท่านั้น แต่ยังสามารถทำงานบนอุปกรณ์ NAS ขนาดเล็กและขนาดกลาง (Synology, QNAP และอื่น ๆ )

วิธีทดสอบการสาธิตงานเอกสาร

เราสามารถทดสอบการสาธิตงานเอกสารได้โดยเข้าถึงอินสแตนซ์งานออนไลน์ที่จัดเตรียมโดย  พายุในทะเลทราย y คลาวรอน.  คุณสามารถลอง เอกสารในพายุทราย (โดยไม่ต้องเข้าสู่ระบบ) หรือ เอกสารใน Cloudron (ชื่อผู้ใช้: cloudron, รหัสผ่าน: cloudron)

ทุกคืนเวลาตีสาม (CET) ฐานข้อมูลจะถูกทิ้งและถูกสร้างขึ้นใหม่และการอัปเดตล่าสุดของ GitHub จะถูกเปิดตัว

อย่าลังเลที่จะสร้าง / แก้ไข / ลบบัญชีสมุดบันทึกและบันทึกย่อ การสาธิตนี้สามารถใช้สำหรับการทดสอบที่แข็งแกร่งโดยไม่มีปัญหาใด ๆ

ข้อกำหนดในการติดตั้ง Paperwork

• php5
• MySQL
• nginx, โคมไฟ ...
• โค้ง
• nodejs

วิธีการติดตั้ง Paperwork

ติดตั้ง 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

ติดตั้งอึกและ bower:

 npm install -g gulp bower

ติดตั้งการอ้างอิง npm ของโปรเจ็กต์

 npm install

ติดตั้ง bower dependencies และรันงานเริ่มต้น

 bower install
 gulp

รีสตาร์ท Nginx และ php

service nginx restart
service php5-fpm restart

เราสามารถเข้าถึง localhost:8888 และเริ่มเพลิดเพลิน เอกสาร

ติดตั้ง Paperwork บน 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

เราต้องเชื่อมต่อ Paperwork กับ 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

ติดตั้งอึกและ bower

 npm install -g gulp bower

ติดตั้งการอ้างอิง npm ที่จำเป็นสำหรับโครงการ

 npm install

ติดตั้ง bower dependencies และรันงานที่จำเป็น

 bower install
 gulp

รีสตาร์ท Nginx และ php

service nginx restart
service php5-fpm restart

อัปเดตเอกสารเรียกใช้ (จาก / ส่วนหน้า)

  sudo php artisan paperwork:update

เอกสารเอกสาร

สามารถดูเอกสาร API ได้ที่ docs.paperwork.apiary.io หรือใช้ apiary.apib จาก ที่เก็บเอกสารอย่างเป็นทางการ. เอกสารอยู่ระหว่างการพัฒนาดังนั้นคาดว่าจะมีการเปลี่ยนแปลงเพิ่มเติม

มีส่วนร่วมในงานเอกสาร

ในการมีส่วนร่วมในงานเอกสารคุณสามารถใช้สิ่งต่อไปนี้ สาขาคอมไพล์. ดังนั้นในการพัฒนาคุณต้องโคลนที่เก็บใน Githubและรับสาขาใหม่ ตรวจสอบการเปลี่ยนแปลงการแยกสาขาจากนั้นส่งการอัปเดตไปยังสาขาการพัฒนา

หากคุณสนใจโครงการนี้และต้องการมีส่วนร่วมคุณสามารถติดต่อผู้พัฒนา marius@paperwork.rocks) หรือ Twitter (@devilx) -

มีช่อง IRC #paperwork บน freenode.net และมีกลุ่ม ตะแกรง.