urlzap
v1.0.0
เครื่องมือย่อ URL แบบคงที่ของคุณเอง ⚡️
เครื่องมือสร้างไซต์แบบคงที่ซึ่งเผยแพร่บนหน้า Github ค่อนข้างได้รับความนิยมในปัจจุบัน แต่สิ่งที่เกี่ยวกับตัวย่อ URL แบบคงที่ (ไม่ใช่ตัวสร้าง) ซึ่งช่วยให้คุณเปลี่ยนเส้นทาง URL ตามไฟล์คงที่ได้
โดยปกติแล้ว นักพัฒนาจะสิ้นสุดการตั้งค่าเซิร์ฟเวอร์โดยมีการเปลี่ยนเส้นทางสำหรับสิ่งนี้ (ไม่ใช่แบบคงที่) นั่นคือที่มาของ URLZap โดยจะสร้าง URL โดยใช้ไฟล์และตัวช่วยสร้าง HTML ทำให้ผู้ใช้สามารถโฮสต์การเปลี่ยนเส้นทาง URL ของตนเองลงในหน้า Github ได้
คล้ายกับเครื่องมือสร้างเว็บไซต์แบบคงที่ แต่สำหรับ URL
เก็บ URL ของคุณ (ย่อหรือไม่ก็ได้) ไว้กับคุณ
สามารถใช้ได้กับเพจ Github
ไม่จำเป็นต้องเรียกใช้เซิร์ฟเวอร์หรือตั้งค่าการเปลี่ยนเส้นทาง HTTP 301
ตัวอย่างโครงการ: brunoluiz/_
คุณอาจจะถามตัวเองว่า: จะทำอย่างไรถ้าไม่มีเซิร์ฟเวอร์? คำตอบอยู่ที่ <meta http-equiv="refresh" /> มันทำงานเป็นรหัสสถานะ HTTP 301 (เปลี่ยนเส้นทาง) แต่จะทำในฝั่งไคลเอ็นต์ มีคำอธิบายเพิ่มเติมเล็กน้อยบนเว็บไซต์ w3c
ตาม config.yml ที่มีเส้นทางและ URL ที่ต้องการ urlzap จะสร้างไฟล์ index.html ซึ่งใช้แท็กการรีเฟรชเมตา มันไม่สมบูรณ์แบบเหมือน HTTP 301 แต่ค่อนข้างใกล้เคียงกัน เครื่องมือสร้างเว็บไซต์คงที่อื่นๆ เช่น Hugo ใช้กลยุทธ์ที่คล้ายกัน
ตัวอย่างจะเป็น:
เส้นทาง: './links' # ค่าเริ่มต้นคือ './'urls: google: https://google.com เครื่องมือ:github: https://github.com
แต่ละคีย์ในแผนที่จะแมปกับเส้นทาง {.path param}/{key} โดยเปลี่ยนเส้นทางไปยัง {value} สิ่งนี้จะสร้างสิ่งต่อไปนี้:
- links/ - google/ - index.html (contains redirect) - tools/ - github/ - index.html (contains redirect)
ไฟล์เหล่านี้สามารถอัปโหลดไปยังเพจ Github ได้โดยไม่ต้องใช้เซิร์ฟเวอร์ใดๆ บน brunoluiz/_ คุณสามารถดูตัวอย่าง config.yml และชำระเงินเอาต์พุตในสาขา gh-pages
ตรวจสอบส่วนการเผยแพร่สำหรับรายละเอียดข้อมูลเพิ่มเติม
ใช้ brew เพื่อติดตั้ง
brew tap brunoluiz/tap brew install urlzap
ใช้ตัวอย่าง YAML ก่อนหน้า:
เส้นทาง: './links' # ค่าเริ่มต้นคือ './'urls: google: https://google.com เครื่องมือ:github: https://github.com
urls : แมป URL ที่ต้องการ ตามรูปแบบ {key}:{redirect URL}
path : เส้นทางเอาท์พุท
หากต้องการสร้างไฟล์สแตติก ให้รัน urlzap generate
เป็นไปได้มากว่าคุณจะต้องใช้ Github Pages ร่วมกับเครื่องมือนี้ หากเป็นเช่นนั้น บางทีวิธีที่ดีที่สุดในการใช้งานและเก็บเกี่ยวผลประโยชน์ก็คือผ่าน Github Actions ไปที่ brunoluiz/urlzap-github-action เพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการติดตั้ง ซึ่งครอบคลุมถึงการสร้างและการปรับใช้
คุณอาจต้องเปิดใช้งาน Github Pages ในพื้นที่เก็บข้อมูลของคุณด้วยตนเอง! รายละเอียดเพิ่มเติมที่คู่มือ Github Pages
หาก Github Actions ไม่เหมาะกับคุณ ให้ลองใช้กระบวนการด้วยตนเองต่อไปนี้แทน
เปิดใช้งานเพจ Github และตั้งค่าสาขาที่จะเก็บไฟล์ HTML แบบคงที่ของคุณ รายละเอียดเพิ่มเติมที่คู่มือ Github Pages
ตั้งค่า config.yml ของคุณ
มุ่งมั่นและผลักดันไปที่ main
ชำระเงินที่สาขา Github Pages ของคุณ (โดยปกติคือ gh-pages ) และเรียกใช้ git reset --hard origin/main (ซึ่งจะรีเซ็ต HEAD เป็น master )
เรียกใช้ urlzap generate
มุ่งมั่นและผลักดัน
สคริปต์ต่อไปนี้เป็นไปตามที่อธิบายไว้ในขั้นตอนข้างต้น:
#!/bin/bash# เพิ่ม คอมมิต และพุชการเปลี่ยนแปลงของคุณ เพิ่ม config.yml git commit -m 'chore: update config.yml'git push -u origin main# ทำให้สาขา gh-pages เหมือนกับ maingit checkout gh-pages git reset --hard origin/main# สร้าง filesurlzap สร้าง # เพิ่ม คอมมิต และพุช ไฟล์ที่สร้างขึ้น git add --all git commit -m 'chore: อัปเดตไฟล์ HTML'git push -u origin gh-pages --force
