หน้าแรก>แหล่งข้อมูลการสร้างเว็บไซต์>ข้อมูลเว็บไซต์
ดาวน์โหลด

การกระทำของ Asciidoctor GitHub

การกระทำของ GitHub ที่สร้างหน้า Asciidoc GitHub ในเวิร์กโฟลว์ CI ของคุณ มันแปลงไฟล์ adoc ทุกไฟล์เป็น html ซ้ำการเปลี่ยนชื่อ README.html เป็น index.html จากนั้นผลัก HTML ที่สร้างขึ้นทั้งหมดและไฟล์ที่มีอยู่ไปยังสาขา gh-pages หากคุณไม่ต้องการสิ่งใดแฟนซีเช่น Antora การกระทำนี้อาจเป็นวิธีที่จะเผยแพร่เว็บไซต์ Asciidoc ง่ายๆ แต่ถ้าคุณต้องการเว็บไซต์ที่มีโครงสร้างมากขึ้นบางที Jekyll Asciidoc Quickstart เหมาะสำหรับคุณ

หลังจากกำหนดค่าการกระทำหน้า gitHub ของคุณจะมีอยู่ที่ http://your-username.github.io/your-repository

โปรดทราบว่าทุกครั้งที่ดำเนินการดำเนินการสาขา gh-pages จะถูกลบออก หากคุณเพิ่มสิ่งใดด้วยตนเองนอกเวิร์กโฟลว์ CI เนื้อหาจะหายไป

1. การสาธิตสด

เราได้ลิ้มรสยาของเราเองโดยการเผยแพร่ที่เก็บนี้ไปยังหน้า GitHub

2. การกำหนดค่า

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

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

2.1. การแก้ไขปัญหา

หากคุณได้รับข้อผิดพลาด "ระยะไกล: การอนุญาตให้ GIT ปฏิเสธการกระทำของ GitHub-Actions [BOT]" Settings > Actions > General และเลือก Read and write permissions

2.2. การสร้าง e-book

การดำเนินการอนุญาตให้เปิดใช้งานการสร้างไฟล์ ebook.pdf อัตโนมัติจากไฟล์ asciidoc PDF ถูกผลักไปที่สาขา gh-pages ด้วย เพื่อเปิดใช้งานเพียงเพิ่มการกำหนดค่าต่อไปนี้: 

 pdf_build : true

ตัวอย่าง eBook PDF มีอยู่ที่นี่

2.3. asciidoctor เปิดเผย js สไลด์

นอกจากนี้คุณยังสามารถสร้าง asciidoctor เปิดเผย js สไลด์ด้วยการกระทำนี้ ที่จะสร้างไฟล์ slides.html ลงในสาขา gh-pages คุณสามารถใช้การกำหนดค่าต่อไปนี้สำหรับสิ่งนั้น:

  • slides_build: boolean - เปิดใช้งานการสร้างไฟล์ slides.html (ค่าเริ่มต้นที่ผิดพลาด)

  • slides_main_adoc_file: string - กำหนดชื่อของไฟล์ต้นฉบับ asciidoc เพื่อสร้างสไลด์ (ค่าเริ่มต้น 'readme') อย่ารวมนามสกุลไฟล์

  • slides_skip_asciidoctor_build: boolean - เพื่อเปิดใช้งาน skippig การสร้างไฟล์ HTML ปกติโดยใช้คำสั่ง asciidoctor หากคุณต้องการสร้างสไลด์

3. ตัวอย่างอื่น ๆ

หากคุณต้องการตรวจสอบวิธีการสร้างเว็บไซต์จากเอกสาร Asciidoc หลายรายการให้ตรวจสอบที่เก็บตัวอย่างนี้ เป็นเพียงภาษาโปรตุเกส แต่คุณสามารถรับโครงสร้างได้

4. การกระทำทำงานอย่างไร

การกระทำนั้นง่าย แต่เพื่อแสดงวิธีที่คุณสามารถสร้างเว็บไซต์ที่มีหลายหน้าจากไฟล์ ASCIIDOC ที่แตกต่างกันรายละเอียดมีให้ที่นี่ในหน้าแยกต่างหาก และตระหนักถึงลิงก์ด้านบนจุดไปยัง: (i) ไฟล์ adoc เมื่อเปิดหน้านี้จากที่เก็บ GitHub และ (ii) ไฟล์ html เมื่อเปิดหน้านี้จากหน้า GitHub

5. คำถามที่พบบ่อย

5.1. ฉันจะกำหนดค่าโดเมนที่กำหนดเองได้อย่างไร

หน้า GitHub ต้องการไฟล์ CNAME ในสาขา gh-pages แต่ในการดำเนินการทุกครั้งสาขา gh-pages จะถูกกำจัดออกไป ในการทำงานโดเมนที่กำหนดเองเพียงเพิ่มไฟล์ CNAME ในไดเรกทอรีรูทของสาขา main หรือสาขา master ของคุณแทนและจะถูกคัดลอกไปยังสาขา gh-pages โดยอัตโนมัติ หากคุณมีการกำหนด source_dir ไฟล์ CNAME จะต้องอยู่ใน source_dir ที่กำหนดค่าของคุณ

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด