expressjs.com

Expressjs.com

นี่คือที่เก็บของเว็บไซต์ ExpressJS.com มันโฮสต์โดยตรงจากที่เก็บเป็นเว็บไซต์ GitHub Pages

การตั้งค่าท้องถิ่น

เพื่อดูตัวอย่างเว็บไซต์ในพื้นที่:

1. ติดตั้ง Ruby และ Bundler หากคุณยังไม่มี

2. ติดตั้งอัญมณี jekyll-redirect-from:

   $ gem install jekyll-redirect-from

3. โคลนที่เก็บนี้โดยเรียกใช้คำสั่งต่อไปนี้:

   $ git clone https://github.com/expressjs/expressjs.com.git

4. นำทางไปยังไดเรกทอรีที่เก็บโคลนและเรียกใช้คำสั่งต่อไปนี้:

   $ bundle install

   Bundler จะดูใน Gemfile ที่จะติดตั้งอัญมณี อัญมณี github-pages รวมถึง Jekyll รุ่นเดียวกันและการพึ่งพาอื่น ๆ ที่ใช้โดยหน้า GitHub เพื่อให้การตั้งค่าในพื้นที่ของคุณสะท้อนหน้า GitHub ให้ใกล้เคียงที่สุด

5. เรียกใช้ Jekyll โดยใช้คำสั่งต่อไปนี้:

   $ bundle exec jekyll serve

   จากนั้นโหลด http: // localhost: 4000 ในเบราว์เซอร์ของคุณ

การตั้งค่าในพื้นที่โดยใช้ Docker

เคล็ดลับ

คุณสามารถเรียกใช้ make help เพื่อรับข้อมูลโดยละเอียดเกี่ยวกับวิธีการใช้คำสั่ง Make ของเรา

0. ตรวจสอบให้แน่ใจว่าคุณมีนักเทียบท่าและติดตั้ง
1. เรียก make build เพื่อสร้างโครงการ
2. เรียก make serve เพื่อรับใช้โครงการซึ่งรวมถึงการโหลดสดใหม่เพื่อให้การเปลี่ยนแปลงใด ๆ จะสะท้อนให้เห็น (อาจใช้เวลาสักครู่ตรวจสอบบันทึก)
3. เรียก make clean เพื่อลบภาพนักเทียบท่าและทรัพยากรที่สร้างขึ้น

การจัดรูปแบบ

Jekyll ใช้ตัวแปรของ markdown ที่รู้จักกันในชื่อ Kramdown

Jekyll ใช้เครื่องยนต์เทมเพลตของเหลวในการเทมเพลต

คุณสามารถใช้บล็อกรหัส GFM ไม่พอใจสำหรับ JavaScript; ตัวอย่างเช่น:

 `` `js
var express = ต้องการ ('ด่วน')
var app = express ()
app.listen (3000)
-

ผลที่ได้จะเป็นเช่นนี้:

 const express = require ( 'express' )
const app = express ( )
app . listen ( 3000 )

การไฮไลต์ไวยากรณ์ของหน้า GitHub เริ่มต้นถูกปิดใช้งานใน _config.yml เพื่อให้ไฮไลต์ด้วย prism.js

การบริจาค

อย่าลังเลที่จะทำการเปลี่ยนแปลงไฟล์เทมเพลตหรือไฟล์เอกสาร เอกสารที่สนับสนุนอยู่ในไดเรกทอรีที่เกี่ยวข้องและเอกสาร API อยู่ภายใต้ไดเรกทอรี _includes

โปรดดูคู่มือผู้สนับสนุนสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการมีส่วนร่วมในเอกสารรวมถึงข้อมูลเกี่ยวกับการแปลที่มีส่วนร่วม

ทำไมต้องใช้ jekyll แทนวิธีแก้ปัญหาแบบด่วน?

Jekyll มาพร้อมกับหน้า GitHub เนื่องจากเราใช้หน้า GitHub เพื่อโฮสต์เว็บไซต์จึงเหมาะสมที่จะใช้ประโยชน์จากความสามารถที่มีให้ ทุกอย่างเกี่ยวกับการใช้เครื่องมือที่เหมาะสมสำหรับงานที่เหมาะสมภายใต้สถานการณ์ที่เหมาะสม