כיצד לרשום הערות עם ניירת

נכון לעכשיו ישנם כלים רבים לרישום הערות, אחד שתפס את תשומת ליבי הוא הקוד החדש, החזק והפתוח ניירת, המהווה אלטרנטיבה אמיתית ליישומים הקנייניים של אזור זה.

מה זה ניירת?

נייר היא חלופה קוד פתוח לרישום הערות, והיא תומכת ב- Evernote, Microsoft OneNote ו- Google Keep.

נייר זה כתוב ב- PHP, באמצעות המסגרת לאראבל 4. בנוי על גבי AngularJS y Bootstrap 3, עמ 'הוא מספק ממשק משתמש מודרני באינטרנט, כמו גם ממשק API פתוח לשילוב צד שלישי.

עבור החלק האחורי הוא מאחסן הכל במסד נתונים MySQL. עם דרישות נפוצות כל כך (לינוקס, אפאצ'י, MySQL, PHP), נייר היא תוכל לרוץ לא רק על שרתים ייעודיים, אלא גם על מכשירי NAS קטנים ובינוניים (Synology, QNAP וכו ').

כיצד לבדוק הדגמת ניירת

אנו יכולים לבדוק הדגמה של ניירת על ידי גישה למופעי עבודה מקוונים המסופקים על ידי  סוּפַת חוֹל y קלאודרון.  אתה יכול לנסות ניירת בסופת חול (בלי להתחבר) או ניירת בקולרון (שם משתמש: cloudron, סיסמה: cloudron).

כל לילה בשעה 3 בבוקר (CET), מסד הנתונים נשמט ומשוחזר, והעדכונים האחרונים ב- GitHub מועברים.

אתם מוזמנים ליצור / לשנות / למחוק חשבונות, מחברות והערות. ניתן להשתמש בהדגמה זו לבדיקות חזקות ללא כל בעיה.

דרישות להתקנת ניירת

• php5
• MySQL
• nginx, מנורה ...
• תלתל
• nodejs

כיצד להתקין ניירת

התקן ניירת באובונטו 14.10

זה ינחה אותך שלב אחר שלב כיצד להתקין שרת LEMP וניירת. מדריך זה נכתב ונבדק באובונטו 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

עבור לספריית ה- frontend:

 cd ./paperwork/frontend/

הפעל "התקנת מלחין" ו / או "עדכון מלחין". זה יתקין את כל התלות הדרושה.

composer install

כעת עליך לשים את אישורי MySQL שלך בחזית front / 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 and 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

עבור לספריית ה- frontend:

 cd ./paperwork/frontend/

הפעל "התקנת מלחין" ו / או "עדכון מלחין". זה יתקין את התלות הדרושה.

composer install

עלינו לחבר ניירת לשרת ה- SQL שלך. צור "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 install
 gulp

הפעל מחדש את Nginx ו- php

service nginx restart
service php5-fpm restart

עדכן ניירת, הפעל (מ- / frontend)

  sudo php artisan paperwork:update

תיעוד ניירת

ניתן למצוא את תיעוד ה- API בכתובת docs.paperwork.apiary.io או באמצעות המכוורת. apib מ מאגר ניירת רשמי. הניירת נמצאת בפיתוח, ולכן צפויות שינויים נוספים.

תורמים לניירת

כדי לתרום לניירת אתה יכול להשתמש בהמשך ענף git. אז כדי להתפתח, עליך לשכפל את המאגר פנימה GitHub, וקבל סניף חדש. אמת את השינויים בסניף ואז דחף עדכונים לענף המפתח.

אם אתה מעוניין בפרויקט זה ורוצה לתרום, תוכל ליצור קשר עם המפתח marius@paperwork.rocks) או לטוויטר (@devilx) -

יש ערוץ IRC # paperwork ב- freenode.net ויש קבוצה גיטר.