Node.js CMS & SSG ที่ง่ายที่สุด!
เปลวไฟเล็ก ๆ ในความมืดของข้อผิดพลาด ...
สำคัญ
เอกสารนี้ไม่ได้แสดงถึงคุณสมบัติที่หลากหลายของ Blog-Doc อีกต่อไป กรุณาปรึกษาเอกสารที่ครอบคลุมสำหรับข้อมูลที่ทันสมัยเกี่ยวกับฟังก์ชันการทำงานของ Blog-Doc
ในการติดตั้ง Blog-Doc On Space ให้ตรงหน้าการติดตั้งและคลิกที่ปุ่ม Install App
เมื่อติดตั้งแล้วให้เปิดแอพจากขอบฟ้าของคุณหรือโดยการเข้าถึงอินสแตนซ์ตัวสร้างของแอพและคลิกที่ปุ่ม Open Builder Instance
คุณจะถูกนำไปยังที่อยู่ของแอปและดูในเบราว์เซอร์ของคุณข้อความต่อไปนี้: Route Not Found
ได้โปรดอย่าออกนอกลู่นอกทาง! ฉันได้ลองวิธีอื่น ๆ แต่นี่เป็นวิธีที่ง่ายที่สุดและปลอดภัยที่สุด
ตอนนี้สมมติว่าอินสแตนซ์ของบล็อก DOC ของคุณมีที่อยู่ต่อไปนี้:
https://abc-1-x234.deta.app
ในแถบที่อยู่ของเบราว์เซอร์ของคุณ
เพิ่มหลังจาก /admin-blog-doc-config
ที่อยู่ตอนนี้:
https://abc-1-x234.deta.app/admin-blog-doc-config
, กด Enter
คุณจะถูกเปลี่ยนเส้นทางไปยังหน้าเว็บที่จะแนะนำคุณเกี่ยวกับการตั้งค่าการกำหนดค่าหลักเพื่อเริ่มใช้บล็อก DOC 2 ขั้นตอนง่าย 2 นาที
ในตอนท้ายคุณจะส่งแบบฟอร์มใช้เวลามากที่สุด 30 วินาทีในการอัปโหลดการกำหนดค่าจากนั้นคุณจะถูกเปลี่ยนเส้นทางไปยังที่อยู่เริ่มต้น https://abc-1-x234.deta.app
แล้วดูอีกครั้ง: Route Not Found
อีกครั้งอย่าตกใจ! เพียงเพิ่ม `/pages/documentation`` 'หลังจากที่อยู่ เรียกดูภายในแอพเป็นเวลาหนึ่งนาที (เวลาสำหรับรหัสเพื่อโต้ตอบกับไดรฟ์ที่สร้างขึ้นใหม่) โดยไม่ต้องไปที่เส้นทางบ้านจากนั้นไปที่เส้นทางหลักและเริ่มใช้อินสแตนซ์ของคุณเองของคุณเอง?
ถ้ามันไม่ได้ผลตั้งแต่ครั้งแรกทำอีกครั้งและจะ
siteURL
ก่อนที่จะปรับใช้แอปพลิเคชัน
Nota Bene: URL สด จะต้อง จบลงด้วย Slash /
แน่นอนคุณ ต้อง แก้ไข siteTitle
, siteDescription
และ rssCopyright
ในหน้าการตั้งค่า
คุณ ควร แทนที่ ค่า siteTitle
, siteDescription
และ rssCopyright
ด้วยไซต์ของคุณ
คุณ สามารถ แทนที่ค่า rssSiteLanguage
ด้วยภาษาของเว็บไซต์ของคุณ
รายการรหัสภาษาที่มีอยู่สามารถพบได้ในหน้ารหัสภาษา RSS
⬆กลับไปที่คุณสมบัติ
เช่นเดียวกับฟีด RSS คุณ ต้อง ให้ URL สด ของเว็บไซต์ของคุณในหน้าการตั้งค่าโดยการแก้ไขค่า siteURL
เพื่อสร้างลิงก์ที่ถูกต้องสำหรับแต่ละหน้าโพสต์แท็กและเทมเพลตรวมถึงเส้นทางบล็อก
โปรดจำไว้ว่า URL ของไซต์ จะต้อง จบลงด้วย Slash /
คุณสามารถตรวจสอบแผนผังไซต์ของเว็บไซต์ของคุณภายใต้เส้นทาง /sitemap
⬆กลับไปที่คุณสมบัติ
Blog-Doc มีคุณสมบัติการค้นหาในตัว
ฟังก์ชั่นการค้นหาช่วยให้ผู้ใช้สามารถทำการวิจัยเกี่ยวกับ ชื่อ และ เนื้อหา ของโพสต์
คุณสามารถตรวจสอบการค้นหาเว็บไซต์ของคุณภายใต้เส้นทาง /search
คุณสามารถปิดใช้งานการค้นหาในแอป Node.js รวมถึงไซต์คงที่ที่สร้างขึ้นโดยให้ searchFeature
false
ในหน้าการตั้งค่าเว็บไซต์
⬆กลับไปที่คุณสมบัติ
Blog-Doc ใช้ไฮไลต์ JS เพื่อเน้น บล็อกของรหัส
ในการเขียน รหัสอินไลน์ ล้อมรอบรหัสของคุณด้วย backticks ``
ในการเน้นให้ใช้ภาษาสำหรับ รหัสอินไลน์ โดยวางเครื่องมือจัดฟันที่หยิกด้วยนามแฝงของภาษาของรหัส
ตัวอย่างต่อไปนี้จะทำให้คุณมีความคิดที่ดีขึ้น
สมมติว่าเส้น css
นี้ p : color { red }
เพื่อไฮไลต์คุณจะเขียน `p { color: red }`{language=css}
รหัสถูกล้อมรอบด้วย backticks ``
และตามด้วย {language=alias of code language}
ในการเขียน บล็อกของรหัส ล้อมรอบบล็อกของคุณด้วย backticks 3 คู่ ```
ในการเน้นให้ให้นามแฝงของภาษาสำหรับบล็อกหลังจาก 3 backticks 3 ครั้งแรก
เราจะนำตัวอย่างก่อนหน้าและเน้นเป็นบล็อก:
```css
p { color: red }
```
เราจะได้รับผลลัพธ์ต่อไปนี้:
p {
color : red;
}
เยี่ยมชมภาษาที่รองรับของไฮไลต์ js เพื่อรับนามแฝงที่ถูกต้องหากคุณไม่แน่ใจ
หรือคุณสามารถเขียนบล็อกของรหัสโดยไม่ต้องให้นามแฝง, ไฮไลต์. js จะตรวจจับภาษาโดยอัตโนมัติ
หากปากกาเน้นข้อความไม่สามารถตรวจจับภาษาที่ถูกต้องสำหรับบล็อกของรหัสโดยไม่มีนามแฝงเพียงเพิ่มภาษาที่ต้องการลงในบล็อกตามที่ระบุไว้ข้างต้น
⬆กลับไปที่คุณสมบัติ
การเพิ่มแอตทริบิวต์ id
ลงในแท็กหัวเรื่อง H2 จนถึง H4 เท่านั้นเป็นคุณสมบัติที่เปิดใช้งานโดยค่าเริ่มต้น
คุณสมบัตินี้ถูกสร้างขึ้นด้วยเคสขอบและการพิมพ์ผิดในใจ:
ในการเพิ่ม id
ให้เพิ่มเครื่องมือจัดฟันแบบหยิกด้วยแฮชแท็กตามด้วยข้อความของ ID
ตัวอย่างต่อไปนี้จะทำให้คุณมีความคิดที่ดีขึ้น:
<!-- Heading tags with an id property -->
## My awesome H2 title {# my-awesome-h2-title}
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >
### My awesome H3 title {# my awesome h3 title}
The HTML output will be : < h3 id = " my-awesome-h3-title " >My awesome H3 title</ h3 >
#### My awesome H4 title {# My awesome H4 title}
The HTML output will be : < h4 id = " my-awesome-h4-title " >My awesome H4 title</ h4 >
ช่องว่างทุกแห่งจะถูกแทนที่ด้วยเครื่องหมายยัติภังค์โดยอัตโนมัติและยัติภังค์ต่อเนื่องจำนวนมากจะถูกแทนที่ด้วยยัติภังค์เดียวเท่านั้น
จำนวนของยัติภังค์ใด ๆ ที่จุดเริ่มต้นหรือส่วนท้ายของข้อความของ ID จะถูกลบออกดังนั้นสิ่งต่อไปนี้ก็ใช้ได้:
## My awesome H2 title { # ----- My ----- aWEsOMe ----- h2 ----- tITlE ----- }
Whatever the number of whitespace characters / hyphens is at the beginning,
between the words or at the end, the HTML output will still be :
< h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >
อะไรก่อนที่แฮชแท็ก ล่าสุด จะถูกละเว้นและอักขระพิเศษในข้อความของ ID ก็ถูกละเว้นเช่นกัน:
## My awesome H2 title { /!@# a comment ?%^& # -my= awesome+ h2 ( title ) | }
The HTML output will be : < h2 id = " my-awesome-h2-title " >My awesome H2 title</ h2 >
& will be parsed to amp (ampersand)
" will be parsed to quot (quotation)
> will be parsed to gt (greater then)
< will be parsed to lt (less then)
เป็นตัวอย่าง:
## Honey & Bees {#Honey & Bees}
The HTML output will be : < h2 id = " honey-amp-bees " >Honey & Bees</ h2 >
หากคุณต้องการปิดการใช้งานคุณสมบัตินี้ให้ตั้งค่า addIdsToHeadings
เป็น false
ในหน้าการตั้งค่าไซต์
⬆กลับไปที่คุณสมบัติ
เนื่องจาก Blog-Doc กลายเป็น CMS ฉันจึงวางแผนที่จะเพิ่มแกลเลอรี่และวิธีการดึงภาพสำหรับหน้าและโพสต์โดยตรง
ตอนนี้เกือบจะเสร็จแล้ว เกือบจะเป็นเพราะมีพื้นที่ว่างที่จะนำไปสู่การปรับปรุงเสมอ
สำหรับตอนนี้คุณสามารถเยี่ยมชมแกลเลอรี่ได้โดยกดเส้นทาง /admin/gallery/images
หรือไปที่หน้าการดูแลระบบและคลิกที่ลิงค์ แกลเลอรี่ ในเมนูหรือการ์ด
ด้วยจิตวิญญาณระดับโลกของ Blog-Doc, The Galley นั้นค่อนข้างใช้งานง่าย
คุณจะพบโซนดร็อปที่คุณสามารถวางภาพของคุณหรือคลิกที่มันและเลือกภาพที่คุณต้องการอัปโหลด
นอกจากนี้คุณยังสามารถลบภาพออกจากแกลเลอรี่ได้โดยคลิกที่ปุ่ม ลบ
ในที่สุดในการกำหนดภาพให้กับหน้าหรือโพสต์คุณสามารถในขณะที่สร้างหรืออัปเดตเลือกรูปภาพจากแกลเลอรี่โดยเลือกโดยตรงจากหน้าหรือโพสต์
⬆กลับไปที่คุณสมบัติ
(เร็ว ๆ นี้ถึงอวกาศ)
คุณสามารถสลับระหว่างธีมและเลือกการออกแบบที่กำหนดความต้องการของคุณ
Blog-Doc มาพร้อมกับ:
หากภาพมีค่าหนึ่งพันคำวิดีโอมีมูลค่าล้าน!
วิดีโอ 30 วินาทีที่แสดงความสามารถในการเปลี่ยนรูปลักษณ์และความรู้สึกของเว็บไซต์ของคุณด้วย Blog-Doc ทันที
ฉันจะเพิ่มธีมเพิ่มเติมในบล็อก DOC เมื่อเวลาผ่านไป
หากคุณได้เขียนธีมสำหรับ Blog-Doc และต้องการแสดงรายการในชุดรูปแบบที่มีอยู่คุณสามารถแจ้งให้เราทราบในการอภิปรายของที่เก็บของบล็อก Doc ภายใต้หมวดหมู่ความคิด
โปรดทราบว่าชุดรูปแบบบล็อก DOC จะต้อง ใช้ JavaScript ธรรมดาเท่านั้นและไม่สามารถมีรหัสหรือรูปภาพใด ๆ ที่มีการเผยแพร่และ/หรือข้อ จำกัด การกระจาย!
⬆กลับไปที่คุณสมบัติ
ด้วยความเคารพต่อเวลาและการทำงานอย่างหนักของนักพัฒนาทุกคนที่สร้างเครื่องกำเนิดไซต์แบบคงที่ด้วย node.js รวมถึง Blog-Doc เวอร์ชันก่อนหน้า นั่นคือ GasWorks!
ฉันเสนอคำขอโทษอย่างจริงใจให้กับนักพัฒนาเหล่านี้แต่ละคน แต่แอพไม่ควรเป็น Gasworks ...
ในขณะที่โพสต์ต่อไปนี้ไม่เกี่ยวข้องกับเวอร์ชันจริงของบล็อก DOC ที่พวกเขาอธิบายได้ค่อนข้างดีแรงจูงใจของฉันและอาจทำให้คุณตกใจ
กรุณาอ่าน จาก 145 ถึง 7?
ยังอ่าน บล็อก Doc ใหม่
อ่าน node_modules ไม่หนักนักพัฒนาขี้เกียจ!
Blog-Doc for Space ตอนนี้ใช้เพียง 14 โมดูล (1916.1 KB หรือ 1.9161 MB) แทน 131 (10082 KB หรือ 10.082 MB)!
ไปที่หน้าปัญหาของ Space Blog-Doc บน GitHub และสร้างปัญหาใหม่โดยอธิบายปัญหาที่คุณเผชิญมากที่สุด
ไปที่แนวคิดของ Blog-Doc Space บน GitHub และบอกฉันเกี่ยวกับเรื่องนี้
การรวม SSG ใน Blog-Doc on Space ต้องมีการปรับเปลี่ยนสถาปัตยกรรมบางอย่าง
ฉันจะพิจารณาในภายหลังเพื่อรวม SSG หรือไม่ขึ้นอยู่กับการใช้งานและข้อกำหนดของ Blog-Doc บนอวกาศ
โปรดอ่านส่วนการติดตั้ง
ฉันตั้งใจจะทำการปรับปรุงแอพนี้ในเวลาว่างสั้น ๆ
คุณสามารถใช้ Blog-Doc เป็นต้นแบบและแก้ไขโดยสิ้นเชิงเพื่อใช้กับการออกแบบอื่นและ/หรือภาษาเทมเพลตอื่น
ฉันหวังว่าแอพนี้จะมีประโยชน์ในทางใดทางหนึ่งสำหรับผู้คนจำนวนมากที่นั่นฉันกำลังพิจารณาว่ามันเป็นส่วนบุคคลที่มีส่วนร่วมใน Node.js และชุมชน Markdown
ความคิดความคิดเห็นและข้อเสนอแนะยินดีต้อนรับมากที่สุด
Sya, lebcit
สร้างด้วย❤โดย lebcit