วิธีการติดตั้ง Raneto บน Ubuntu 17.10

• ข้อกำหนดเบื้องต้น
• เข้าสู่ระบบ
• กำลังติดตั้ง Node.js & PM2
• การติดตั้ง Raneto
• การกำหนดค่าเพิ่มเติม
• การเพิ่มหน้า
• การเพิ่มหมวดหมู่

Raneto เป็นฐานความรู้ฟรีและโอเพนซอร์ซที่สร้างขึ้นบน Node.js ซึ่งง่ายต่อการติดตั้งและใช้งานรวมถึงดูแลจัดการได้ง่าย หมวดหมู่และหน้าถูกเขียนใน Markdown ซึ่งทำให้ง่ายต่อการแก้ไข หาก Markdown ไม่ใช่สิ่งที่คุณต้องการ Raneto ยังอนุญาตให้คุณใช้ HTML

ข้อกำหนดเบื้องต้น

• ติดตั้ง VPS พร้อม Ubuntu 17.10
• SSH เข้าถึง VPS ของคุณ
• ความเข้าใจพื้นฐานของเทอร์มินัล Linux

เข้าสู่ระบบ

ก่อนอื่นเราต้องลงชื่อเข้าใช้เซิร์ฟเวอร์ของเราโดยใช้ SSH หากต้องการทำสิ่งนี้ให้เปิดไคลเอนต์ SSH ที่คุณโปรดปราน

ssh root@SERVER_IP

หลังจากป้อนรหัสผ่านของคุณ (คุณสามารถรับได้จากแดชบอร์ด Vultr) คุณจะเข้าสู่ระบบ VPS ของคุณ

กำลังติดตั้ง Node.js & PM2

Raneto รันบน Node.js ซึ่งเป็นรันไทม์และกรอบงานจาวาสคริปต์ ในบทช่วยสอนนี้เราจะใช้ Node.js v8 เนื่องจากการสนับสนุนระยะยาว เริ่มการติดตั้งโดยพิมพ์คำสั่งต่อไปนี้

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -

หลังจากสคริปต์นี้ทำงานเสร็จสิ้นคุณสามารถเรียกใช้การติดตั้งหลัก

sudo apt-get install -y nodejs

เมื่อโปรแกรมติดตั้งนี้เสร็จสิ้นคุณจะมีสำเนา Node.js ที่ติดตั้งอยู่บน VPS ของคุณ ต่อไปเราจะติดตั้ง PM2 ซึ่งเป็นผู้จัดการกระบวนการสำหรับ Node.js ที่ทำให้การรัน Raneto (และแอปพลิเคชัน Node.js อื่น ๆ อีกมากมาย) ง่ายขึ้น

npm install pm2 -g

ตอนนี้เรามีซอฟต์แวร์ทั้งหมดที่เราต้องติดตั้ง Raneto แล้ว

การติดตั้ง Raneto

เราจะใช้ Git เพื่อโคลนที่เก็บ Raneto ไปยังเซิร์ฟเวอร์ของเรา

git clone https://github.com/gilbitron/Raneto.git

Ranetoนี้จะสร้างโฟลเดอร์ที่เรียกว่า เข้าสู่โฟลเดอร์

cd Raneto

ติดตั้ง NPM

npm install

เรียกใช้ Gulp โดยพิมพ์ดังต่อไปนี้

npm run gulp

เมื่อ Gulp ทำงานเสร็จแล้วเราสามารถเริ่มต้นแอปพลิเคชันของเราโดยใช้หนึ่งในสองคำสั่งต่อไปนี้

npm start
# or
npm example/server.js

ตอนนี้คุณจะสามารถเข้าถึงการติดตั้ง Raneto SERVER_IP:3000ใหม่ของคุณได้โดยไปที่ ส่วนที่เหลือของบทช่วยสอนนี้จะสอนวิธีกำหนดค่า Raneto ให้สร้างหน้าใหม่เพิ่มหมวดหมู่ปรับการเรียงลำดับเพิ่มโฮมเพจที่กำหนดเองและแก้ไขเทมเพลต

การกำหนดค่าเพิ่มเติม

ตอนนี้คุณมีการติดตั้ง Raneto เริ่มต้นที่โฮสต์บน VPS ของคุณ ก่อนที่คุณจะเริ่มทำสิ่งใดฉันขอแนะนำให้คุณทำการเปลี่ยนแปลงการกำหนดค่าและการตั้งค่าเริ่มต้นเล็กน้อย

ลองดูที่config.default.jsซึ่งอยู่ในexampleโฟลเดอร์ ไฟล์กำหนดค่านี้ค่อนข้างยาว แต่โปรดอย่าเกลื่อนกลาด นี่คือคุณสมบัติที่คุณควรแก้ไข:

• site_title - เปลี่ยนเป็นชื่อเว็บไซต์ของคุณ
• base_url- ควรตั้งค่าเป็น URL ของเว็บไซต์ของคุณ มันสามารถใช้เป็นตัวแปรเมื่อแก้ไขหน้า
• support_email- เปลี่ยนเป็นอีเมลที่ถูกต้อง มันจะแสดงในส่วนท้ายของเว็บไซต์
• copyright - ข้อความส่วนท้าย
• analytics - เพิ่มรหัสติดตาม Google Analytics ที่นี่
• allow_editing - คุณต้องการแก้ไขไฟล์โดยใช้เครื่องมือแก้ไขเว็บหรือไม่?
• authentication_for_read - คุณต้องการให้คนอื่นเข้าสู่ระบบเพื่อดูเว็บไซต์หรือไม่?
• credentials - เพิ่มผู้ใช้ที่นี่หากเปิดใช้งานการเข้าสู่ระบบ
• locale - ภาษา
• datetime_format - รูปแบบของวันที่และเวลา
• home_meta - แก้ไขสิ่งนี้เพื่อเปลี่ยนข้อมูลเมตาของหน้าแรกของคุณ
• table_of_content - Raneto ควรแสดงสารบัญหรือไม่

การใช้ตัวแก้ไขออนไลน์

Raneto มาพร้อมกับอินเทอร์เฟซออนไลน์ที่ใช้งานง่ายสำหรับการจัดการหน้าหมวดหมู่และอื่น ๆ แม้ว่ามันจะไม่อนุญาตให้คุณทำทุกอย่าง แต่ก็มีประโยชน์ถ้าคุณต้องการแก้ไขอย่างรวดเร็วในระหว่างการเดินทาง

คุณสามารถเข้าถึงได้โดยเปิดใช้งานการตั้งค่าในconfig.default.js(ดังกล่าวข้างต้น) จากนั้นไปที่ VPS ของคุณและคลิกที่ปุ่มเข้าสู่ระบบที่มุมขวาบน ป้อนชื่อผู้ใช้และรหัสผ่านของคุณ (คุณสามารถเปลี่ยนได้config.default.js) และคลิกเข้าสู่ระบบ เพียงคลิกที่หน้าที่คุณต้องการแก้ไขคลิกActionsเมนูแบบเลื่อนลงและเลือกการกระทำที่คุณต้องการให้เสร็จ คุณสามารถเพิ่มหน้าได้โดยกด+ปุ่มถัดจากชื่อหมวดหมู่และคุณสามารถสร้างหมวดหมู่โดยใช้ช่องป้อนข้อมูลที่มุมซ้ายบน

การเพิ่มหน้า

การเพิ่มหน้าเป็นเรื่องง่ายเหมือนการสร้าง.mdเอกสารMarkdown ( ) ใหม่ในexample/contentโฟลเดอร์

เมื่อคุณสร้างไฟล์ Markdown ใหม่สิ่งสำคัญคือคุณต้องเพิ่มข้อมูลพื้นฐานบางอย่างลงไปด้านบนของไฟล์ เปิดไฟล์ในโปรแกรมแก้ไขข้อความที่คุณชื่นชอบ เราจำเป็นต้องเพิ่มสิ่งต่อไปนี้ไปยังด้านบนของไฟล์

/*
 Title: Enter your page title here, if none is added, the file-name will be used
 Description: Enter your page's description here (for search engines and the site search feature)
 ShowOnHome: true/false
 */

หากคุณต้องการคุณสามารถใช้ตัวแปรต่อไปนี้ในหน้าเว็บของคุณ:

• %base_url% - สิ่งนี้ช่วยให้คุณพูดถึง URL ของเว็บไซต์ของคุณ
• %image_url% - สิ่งนี้ช่วยให้คุณได้รับ URL พื้นฐานของไดเรกทอรีรูปภาพของคุณ

การเพิ่มหมวดหมู่

คุณสามารถเพิ่มหมวดหมู่ในฐานความรู้ของคุณได้อย่างง่ายดาย เพียงสร้างโฟลเดอร์ใหม่ในexample/contentไดเรกทอรีและวางหน้าที่คุณต้องการให้อยู่ในหมวดหมู่นั้นในโฟลเดอร์นั้น ตัวอย่างเช่นสมมติว่าเราต้องการประเภทที่เรียกว่าhelpมีหน้าเรียกว่าcontact, และhelp-me awesomeไฟล์จะมีลักษณะเช่นนี้:

/example/content/help/contact.md
/example/content/help/help-me.md
/example/content/help/awesome.md

คุณสามารถเพิ่มโฟลเดอร์ย่อยได้มากเท่าที่คุณต้องการภายในหมวดหมู่

หมวดหมู่สามารถมีข้อมูลเมตา สร้างไฟล์ที่เรียกว่าmetaในโฟลเดอร์หมวดหมู่ รองรับแอตทริบิวต์ต่อไปนี้ (ไม่บังคับทั้งหมด):

• ชื่อ - ชื่อเรื่องแทนที่ตามชื่อโฟลเดอร์
• เรียงลำดับ - ช่วยให้คุณสามารถเรียงลำดับของหมวดหมู่ได้เช่นเดียวกับการเรียงลำดับหน้า
• ShowOnHome - จริง / เท็จ

โฮมเพจที่กำหนดเอง

หากคุณต้องการเพิ่มโฮมเพจที่กำหนดเองสิ่งที่คุณต้องทำคือเพิ่มไฟล์ markdown ที่เรียกว่าโฟลเดอร์index.mdของคุณexample/content

เรียงลำดับหน้า

Raneto จัดเรียงหน้าตามตัวอักษรโดยอัตโนมัติ แต่คุณสามารถใช้การจัดเรียงแบบแมนนวลโดยการเพิ่มSortรายการในเมตาของหน้า ค่าของการเรียงลำดับต้องเป็นจำนวนเต็มตัวอย่างเช่น:

Sort: 7

หน้านี้จะปรากฏก่อนหน้าที่มีค่าเรียง 8 หรือมากกว่า แต่หลังจากหน้ามีค่า 6 หรือน้อยกว่า

เปลี่ยนเทมเพลต

หากคุณคุ้นเคยกับ HTML หรือ CSS คุณสามารถเปลี่ยนรูปลักษณ์ของการติดตั้ง Raneto ได้อย่างง่ายดาย Raneto ใช้ Handlebars ซึ่งเป็นภาษาเทมเพลต JavaScript ที่ทำให้การแก้ไข HTML เป็นโมดูล คุณสามารถค้นหาไฟล์ชุดรูปแบบในthemes/defaultโฟลเดอร์ หากคุณต้องการข้อมูลเพิ่มเติมเกี่ยวกับการแก้ไขแม่แบบ Renato คุณสามารถเยี่ยมชมของพวกเขาส่วนช่วยเหลือ เมื่อคุณแก้ไขเทมเพลตเสร็จแล้วตรวจสอบให้แน่ใจว่าคุณได้รีสตาร์ทแอปพลิเคชัน