expressjs.com

Expressjs.com

Ini adalah repositori dari situs web Expressjs.com. Ini di -host langsung dari repositori sebagai situs web halaman gitub.

Pengaturan lokal

Untuk melihat pratinjau situs web secara lokal:

1. Instal Ruby dan Bundler jika Anda belum memilikinya.

2. Pasang permata jekyll-redirect-from:

   $ gem install jekyll-redirect-from

3. Klon Repositori ini dengan menjalankan perintah berikut:

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

4. Arahkan ke direktori repositori yang dikloning dan jalankan perintah berikut:

   $ bundle install

   Bundler akan melihat di Gemfile yang akan dipasang permata. Permata github-pages mencakup versi Jekyll yang sama dan dependensi lainnya seperti yang digunakan oleh halaman GitHub, sehingga pengaturan lokal Anda mencerminkan halaman GitHub sedekat mungkin.

5. Jalankan Jekyll menggunakan perintah berikut:

   $ bundle exec jekyll serve

   Kemudian, muat http: // localhost: 4000 di browser Anda.

Pengaturan Lokal Menggunakan Docker

Tip

Anda dapat menjalankan make help untuk mendapatkan informasi terperinci tentang cara menggunakan perintah Make kami.

0. Pastikan Anda memiliki Docker dan membuat terpasang.
1. Jalankan make build Untuk Membangun Proyek.
2. Jalankan make serve untuk melayani proyek, ini termasuk pemuatan ulang langsung sehingga setiap perubahan akan tercermin (ini bisa memakan waktu, periksa log).
3. Jalankan make clean untuk menghapus gambar Docker dan sumber daya yang dihasilkan.

Format

Jekyll menggunakan varian Markdown yang dikenal sebagai Kramdown.

Jekyll menggunakan mesin templat cair untuk templating.

Anda dapat menggunakan blok kode berpagar GFM untuk JavaScript; Misalnya:

 `` `JS
var express = membutuhkan ('ekspres')
var app = express ()
app.listen (3000)
`` `

Hasilnya terlihat seperti ini:

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

Sorot sintaks halaman GitHub default telah dinonaktifkan di _config.yml untuk memungkinkan penyorotan dengan prism.js.

Berkontribusi

Jangan ragu untuk membuat perubahan pada file template atau file dokumen. Dokumen pendukung terletak di direktori masing -masing, dan dokumen API terletak di bawah direktori _includes .

Silakan lihat panduan kontributor untuk informasi lebih lanjut tentang berkontribusi pada dokumentasi, termasuk informasi tentang terjemahan yang berkontribusi.

Mengapa menggunakan Jekyll sebagai ganti solusi berbasis ekspres?

Jekyll hadir dengan halaman GitHub. Karena kami sudah menggunakan halaman GitHub untuk meng -host situs web, masuk akal untuk memanfaatkan kemampuan yang disediakannya. Ini semua tentang menggunakan alat yang tepat, untuk pekerjaan yang tepat, dalam keadaan yang tepat.