Tapak yang didorong oleh komuniti dengan Eleventy: Bersedia untuk Sumbangan

Sebelas (11ty) telah menjadi penjana tapak statik saya. Kelajuannya, fleksibiliti, dan sifat yang tidak diendahkan menjadikannya sesuai untuk pelbagai projek, termasuk laman web yang didorong oleh masyarakat seperti Style Stage, pameran CSS yang dikuasakan oleh sumbangan masyarakat. Kekuatan Eleventy untuk jenis projek ini termasuk: membina kilat cepat, fleksibiliti templat, penciptaan fail serba boleh dan rendering, sokongan untuk pelbagai bahasa templat (HTML, markdown, nunjucks), dan prestasi tinggi kerana output HTML statiknya.

Kunci kepada tapak yang didorong oleh komuniti yang berjaya dengan sebelas adalah keupayaannya untuk menghasilkan halaman secara dinamik dari sumber data. Artikel ini menggariskan langkah-langkah pra-pengekodan penting untuk membina tapak tersebut.

Gambaran Keseluruhan Siri:

1. Bersedia untuk Sumbangan (artikel semasa)
2. Membina laman web ini (artikel seterusnya)

Membina laman web komuniti yang berkembang maju: Pertimbangan utama

Mewujudkan tapak yang didorong oleh komuniti yang digunakan untuk menjadi kompleks. Walau bagaimanapun, dengan sebelas dan alat moden yang lain, prosesnya diselaraskan dengan ketara. Sebelum menjemput penyumbang, pertimbangkan langkah -langkah penting ini:

1. Tentukan akses penyumbang

Tentukan apa penyumbang kandungan boleh diubah suai. Untuk peringkat gaya, fail JSON membolehkan penyumbang untuk mengemukakan permintaan tarik dengan metadata yang digunakan untuk menjana halaman mereka. Anda juga mungkin membenarkan muat naik aset atau fail data berganda untuk pengkategorian. Pertimbangkan skop sumbangan dan keupayaan anda untuk semakan untuk memastikan komuniti yang boleh diurus. Tindakan GitHub boleh mengautomasikan cek untuk fail tidak sah.

2. Menetapkan garis panduan yang jelas

Garis panduan yang jelas adalah penting. Garis panduan ini harus didokumenkan dalam fail CONTRIBUTING.md dalam repositori GitHub anda. Fail ini secara automatik muncul apabila penyumbang membuat permintaan atau isu tarik. Menangani pelesenan kandungan, atribusi pengarang, dan dasar kandungan yang boleh diterima. Tahap gaya, sebagai contoh, menentukan kriteria penolakan untuk imejan atau pelanggaran garis panduan yang tidak sesuai.

3. Melaksanakan aliran kerja dan automasi

Sebelas lagi mengendalikan tapak membina, tetapi alat lain seperti Netlify dan GitHub meningkatkan proses sumbangan. Netlify mencipta pratonton yang digunakan untuk setiap permintaan tarik, yang membolehkan penyumbang untuk menguji penyerahan mereka dan menjimatkan masa penyelenggara. GitHub memudahkan perbincangan dan akauntabiliti awam. Untuk kemas kini data yang lebih kerap, pertimbangkan untuk menggunakan IFTTT atau Zapier untuk menjadualkan penyebaran biasa. Perhatikan bahawa aliran kerja ini memerlukan penyumbang untuk mempunyai akaun GitHub.

4. Pilih kaedah komunikasi

Tentukan kepentingan memberitahu penyumbang mengenai kemas kini. Tahap Gaya menggunakan surat berita mingguan (diuruskan menggunakan borang Netlify, Netlify Functions, dan ButdOndown, seperti yang terperinci dalam artikel Matthew Ström "Menggunakan Netlify Forms and Netlify Functions untuk Membina Widget Pendaftaran E-mel"). Alternatif termasuk pemberitahuan atau siaran repo GitHub.

5. Merekrut dan Melibatkan Penyumbang

Menggalakkan projek anda untuk mencari penyumbang. Peringkat Gaya menggunakan pemilihan Twitter dan kempen "panggilan untuk penyumbang", melibatkan diri dengan penyumbang yang berpotensi dan menjadikannya sebagai penyokong projek. Livestream pelancaran juga membantu menghasilkan minat. Ingatlah untuk terlibat secara aktif dengan komuniti anda dan menyediakan jalan untuk penyertaan. Sorot peluang sumbangan dalam kandungan laman web anda.

6. Konfigurasikan tetapan repositori

Pastikan repositori anda awam dan termasuk fail "Kesihatan Komuniti" yang penting:

• README.md : Penerangan Projek.
• CONTRIBUTING.md : Garis Panduan Penyerahan.
• Tarik Templat Permintaan: Templat berstruktur untuk penyerahan.

Melaksanakan Peraturan Perlindungan Cawangan (Tetapan → Cawangan) untuk memerlukan ulasan permintaan tarik sebelum bergabung ke cawangan utama.

Langkah seterusnya

Artikel ini menyediakan asas untuk membina tapak yang didorong oleh komuniti dengan sebelas. Artikel seterusnya akan menyelidiki kod tersebut, mewujudkan projek starter sebelas yang anda boleh menyesuaikan diri untuk komuniti anda sendiri atau laman web peribadi.

Gambaran Keseluruhan Siri:

1. Bersedia untuk Sumbangan (artikel semasa)
2. Membina laman web ini (artikel seterusnya)

Atas ialah kandungan terperinci Tapak yang didorong oleh komuniti dengan Eleventy: Bersedia untuk Sumbangan. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!