สารบัญ

คู่มือการใช้งาน (Documentation)

อัปเดตล่าสุด: 5 มีนาคม 2025

เริ่มต้นใช้งาน

GenWebBlog เป็นซอฟต์แวร์ที่ช่วยสร้างเว็บไซต์แบบ Static โดยอัตโนมัติ รองรับการสร้างเนื้อหาสไตล์ Blog, Profile และ Landing Page เน้น SEO และสามารถ Deploy ได้ง่ายบน Cloudflare Pages

การติดตั้ง

1. ติดตั้ง Rust

บน Mac:

  • ดาวน์โหลด: 
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • จากนั้นใช้คำสั่ง: 
    source $HOME/.cargo/env

  • ตรวจสอบการติดตั้ง:

    rustc --version

บน Windows:

  • ไปที่ rustup.rs และดาวน์โหลดไฟล์ rustup-init.exe
  • เปิด Command Prompt และรันคำสั่ง: 
    rustc --version

2. ติดตั้ง Visual Studio Code

  • ใช้สำหรับแก้ไขโค้ดและเขียนบทความ ติดตั้งดปรแกรมไปที่ Visual Studio Code

3. ดาวน์โหลดไฟล์โปรแกรม GenWebBlog

  • ไฟล์จะถูกส่งให้ทางอีเมล
  • แตกไฟล์แล้วเปิดใน Visual Studio Code

4. ทดสอบการทำงาน

cargo run --bin test

โครงสร้างโปรเจกต์

project/
├── build/   # ไฟล์ที่ถูก build และพร้อมใช้งาน
├── contents/# โฟลเดอร์เก็บโพสต์หรือบทความ
│   ├── .md  # ไฟล์บทความในรูปแบบ Markdown
│   ├── index.yml         # ข้อมูลเพิ่มเติมที่เกี่ยวข้องกับโพสต์
│   ├── about.yml
│   ├── contact.yml
│   ├── faq.yml
│   ├── policy.yml
│   └── terms.yml
│
├── public/  # ไฟล์ที่สามารถเข้าถึงได้จากภายนอก
│   ├── _system_/        # ระบบไฟล์ภายใน
│   │   ├── fonts/       # ไฟล์ฟอนต์
│   │   ├── scripts/     # สคริปต์สำหรับการทำงานของเว็บไซต์
│   │   └── styles/      # สไตล์ของเว็บไซต์
│   ├── images/          # ไฟล์รูปภาพ
│   ├── javascripts/     # ไฟล์สคริปต์ JavaScript
│   ├── robots.txt       # ไฟล์สำหรับกำหนดการเข้าถึงของบอท
│   └── site.webmanifest # ไฟล์ Web App Manifest
│
├── source/  # โฟลเดอร์สำหรับไฟล์ต้นฉบับของเว็บไซต์
│   ├── templates/       # ไฟล์เลย์เอาต์สำหรับการจัดหน้า
│   ├── styles/          # ไฟล์สไตล์ของเว็บไซต์
│   └── tailwind.config.toml # คอนฟิก TailwindCSS
│
├── README.md# ไฟล์อธิบายโปรเจกต์
└── app.toml # ข้อมูลคอนฟิกของโปรเจกต์

การจัดการบทความ

  • ไปที่โฟลเดอร์ contents/ และสร้างไฟล์ .md เช่น 2025-02-11-ชื่อโพสต์.md
  • ใช้ Markdown ในการเขียนบทความ เรียนรู้ Markdown 
cargo run --bin test

📌 หมายเหตุ: มีหน้า /about, /contact, /docs, /faq, /policy, /service, /terms ให้พร้อมใช้งาน หากไม่ต้องการให้แสดง ให้เพิ่ม release: false ในไฟล์ .yml

การปรับแต่งการออกแบบ

ปรับแต่งสไตล์โดยแก้ไขไฟล์ใน source/styles/* และไฟล์คอนฟิก tailwind.config.toml

  • app.scss : ปรับแต่งหน้าเว็บทั้งหมด
  • fonts.scss : ปรับแต่งฟอนต์
  • noscript.scss : ใช้เมื่อ Browser ไม่รองรับ JavaScript

การเผยแพร่เว็บไซต์ (Deploy)

1. เชื่อมต่อกับ GitHub

สมัคร GitHub และสร้าง Token แล้วเพิ่มลงใน app.toml

[deploy_github]
token = "..."
user = "..."
repo_name = "gen-web-blog"
branch = "main"

2. เชื่อมต่อกับ Cloudflare

สมัคร Cloudflare และสร้าง API Token และเพิ่มลงใน app.toml

[deploy_cloudflare]
api_token = "..."
account_id = "..."
project_name = "gen-web-blog"

3. เชื่อมต่อ Domain (ถ้ามี)

[deploy_domains]
list = "..."

4. Deploy เว็บไซต์

cargo run --bin deploy

ข้อมูลเพิ่มเติม

ข้อมูลเพิ่มเติมเกี่ยวกับวิธีการปรับปรุงประสิทธิภาพ (Performance), การเข้าถึง (Accessibility), และการปฏิบัติตาม Best Practices รวมถึงการปรับแต่ง SEO เพื่อให้เว็บไซต์ของคุณได้คะแนนเต็ม 100 ในการประเมินคุณภาพเว็บไซต์โดย Google และเครื่องมือวิเคราะห์อื่นๆ.

การทำตามแนวทางเหล่านี้จะช่วยให้เว็บไซต์ของคุณเป็นที่นิยมและมีประสิทธิภาพสูงสุดในการใช้งาน. เยี่ยมชม Web.dev สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการพัฒนาเว็บไซต์.

  • สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการจัดการเนื้อหา Markdown คุณสามารถอ่านได้ที่ Markdown Content Management