quiltmc.org
1.0.0
Situs web untuk proyek selimut.
Situs ini dibangun dengan Astro, MDX, dan I18Next. Ini di -host di halaman cloudflare. Jika Anda ingin lebih terbiasa dengan Astro, Anda dapat membaca dokumentasinya.
Jika Anda macet atau memiliki pertanyaan, silakan bergabung dengan kami di utas #Website di server Discord kami.
Editor paling sederhana untuk digunakan adalah Visual Studio Code (VScode), karena memiliki ekstensi bahasa resmi untuk Astro dan MDX. Saat Anda membuka repositori di vScode, Anda akan melihat sembulan di sudut kanan bawah menawarkan untuk menginstal beberapa ekstensi yang disarankan. Anda juga dapat mengetikkan @recommended di bilah pencarian ekstensi untuk menelusuri ekstensi yang disarankan dan secara manual menginstal yang Anda inginkan.
Jika Anda lebih suka tidak menggunakan vScode, Anda dapat menggunakan editor apa pun yang mendukung subset dari alat berikut, berdasarkan apa yang Anda lakukan:
Seperti disebutkan sebelumnya, situs web ini dibangun menggunakan Astro, yang ditulis dalam TypeScript, jadi Anda akan memerlukan runtime JavaScript yang kompatibel dengan Node.js untuk membangun dan menjalankannya untuk pengembangan. Jika Anda hanya memberikan kontribusi sederhana, seperti mod yang tidak kompatibel atau posting blog, menyiapkan lingkungan pengembangan tidak penting: versi pratinjau situs akan dibangun ketika Anda mengirimkan permintaan tarik untuk memastikan bahwa semuanya berfungsi seperti yang diharapkan.
Node.js adalah runtime javascript lintas platform. Ini dapat diinstal secara langsung, atau kemungkinan tersedia untuk manajer paket favorit Anda.
Kami menggunakan PNPM sebagai manajer paket Node.js kami. Itu dapat diinstal dengan cara berikut:
npm install -g pnpmUntuk opsi lebih lanjut, lihat dokumen PNPM.
Di dalam proyek, instal semua paket yang diperlukan menggunakan PNPM:
pnpm i Astro menyertakan server pengembangan yang secara otomatis memuat ulang dirinya sendiri saat Anda mengubah file di dalam proyek. Untuk memulainya, jalankan pnpm dev :
> pnpm dev
15:05:32 [types] Generated 1ms
astro v4.15.2 ready in 702 ms
┃ Local http://localhost:4321/
┃ Network use --host to expose
15:05:32 watching for file changes...
Server Dev membangun halaman saat Anda mengunjungi mereka untuk mengurangi waktu mulai, sehingga kinerjanya lebih buruk daripada situs yang dibangun sepenuhnya.
Untuk membangun salinan lengkap dari situs akhir:
pnpm build
Situs ini akan dibangun ke dalam folder dist/ . Membangun situs adalah cara yang berguna untuk memeriksa apakah Anda belum merusak apa pun tanpa memperhatikan.
Anda dapat melihat pratinjau situs yang dibangun menggunakan pnpm astro preview , tetapi dalam kebanyakan kasus satu -satunya keuntungan yang dimiliki oleh server DEV adalah kinerja.
Jika Anda perlu menguji fungsionalitas khusus halaman cloudflare (seperti apa pun dalam functions/ direktori), Anda dapat melihat pratinjau situs menggunakan cloudflare's wrangler clito meniru penyebaran halaman cloudflare.
Pertama, instal Wrangler
pnpm install -g wranglerBangun situs:
pnpm build Jalankan folder dist yang dikeluarkan menggunakan Wrangler:
wrangler pages dev dist
Tidak seperti Astro's Dev Server, Wrangler hanya dapat melihat pratinjau situs yang sepenuhnya dibangun.
Untuk penjelasan terperinci tentang bagaimana repositori diletakkan, lihat ARCHITECTURE.md
Instruksi untuk membuat berbagai jenis kontribusi umum.
Buka file incompatible-mods.json di public/api/v1/incompatible-mods.json dan tambahkan entri baru di bagian bawah daftar.
Entri Anda harus memiliki bidang berikut:
"ids": - Daftar ID mod yang terpengaruh."Name": - Nama lengkap mod yang terkena dampak."type": - Jenis ketidakcocokan. Bisa menjadi salah satu dari yang berikut:"GAME" - crash atau merusak permainan vanilla."OTHERS" - merusak satu atau lebih mod lainnya."SELF" - Breaks sendiri."WORKAROUND" - memiliki solusi yang memungkinkannya berfungsi dengan baik."Status": - Seberapa dekat ketidakcocokan untuk diperbaiki. Bisa menjadi salah satu dari yang berikut:"BLOCKED" - Penulis MOD menyadari masalah ini, tetapi perbaikan diblokir oleh faktor eksternal."IN_PROGRESS" - Penulis mod sedang menerapkan perbaikan."NO_ANSWER" - masalah ini telah dilaporkan, tetapi penulis MOD belum merespons."ON_HOLD" - Penulis mod sedang menunggu untuk mengimplementasikan atau melepaskan perbaikan."UNKNOWN" - Masalah ini belum dilaporkan kepada penulis mod, atau Anda tidak dapat menemukan laporan."WONT_FIX" - Masalahnya telah dilaporkan, tetapi penulis mod menolak untuk memperbaikinya."tracking": - Tautan ke laporan yang melacak ketidakcocokan, misalnya, masalah GitHub. Diatur ke "UNKNOWN" jika Anda tidak tahu."notes": (Opsional) - Catatan lain, misalnya, solusi yang diketahui. Buat file markdown baru di src/pages/en/blog , dinamai dengan tanggal saat ini dan versi singkat dari judul. Tanggal harus dalam format yyyy-mm-dd , dan judulnya harus dalam huruf kecil dan dipisahkan oleh tanda hubung ( - ), misalnya, 2024-03-09-example-post.md .
Di bagian atas file, Anda perlu menambahkan materi depan , yang merupakan metadata yang ditulis dalam YAML. Materi depan untuk posting blog terlihat seperti ini:
---
title : " An Example Title " # The full title of the post
date : 2024-09-03 20:00:00 -00:00 # The date, time, and timezone that the post was written, relative to UTC. It is best practice to give the time in UTC and use an offset of -00:00, as shown.
authors : # A list of one or more authors
- Pineapple
layout : /src/layouts/Post.astro # This tells Astro what layout to use for the page, and should always be the same.
--- Tulis paragraf pertama yang singkat, lalu masukkan dua baris, letakkan <!-- MORE --> , lalu dua baris lagi. Misalnya:
A succinct first paragraph.
<!-- MORE -->
More text here.
Ini memberi tahu situs web apa yang akan dimasukkan dalam pratinjau singkat yang berlangsung di beranda dan dalam daftar posting blog. Dari sini, Anda dapat terus menulis Markdown dengan konten hati Anda. Sorot sintaks dalam blok kode juga didukung.
Jika Anda adalah bagian dari salah satu pengembang atau tim komunitas Quilt, Anda mungkin memiliki kartu di halaman daftar tim situs web. Data di dalam kartu pada halaman ini dibangun dari file TeamData.mjs di src/data/ .
Setiap anggota tim memiliki objek dalam file ini dengan data tentang mereka. Bagian halaman tempat Anda terdaftar didasarkan pada tim mana Anda berada di GitHub.
Anda dapat mengubah data berikut untuk menyesuaikan kartu Anda:
name: - Nama di bagian atas kartu Anda. Itu bisa jadi apa pun yang Anda inginkan.discord: - Nama pengguna Perselisihan Anda.github: - Nama pengguna GitHub Anda. Ini digunakan untuk mengidentifikasi tim mana Anda berada di GitHub.avatar: - Ini adalah URL untuk gambar apa pun yang Anda sukai. Untuk hasil terbaik, itu harus persegi dan tidak terlalu besar. Anda dapat meletakkan file di public/assets/team/images untuk di -host di situs web, atau menggunakan URL gambar lain yang Anda sukai.description: (Opsional) - Kalimat atau paragraf kecil tentang siapa Anda.links: (Opsional) - Daftar tautan ke berbagai halaman web Anda atau profil media sosial. Setiap tautan diwakili oleh objek berikut:icon : Ikon yang mewakili tautan. Anda dapat memilih dari ikon set merek Coreui ( cib: , ikon desain material ( mdi: :), atau simbol material ( material-symbols: :); Atau gunakan ikon khusus kami untuk CurseForge ( curseforge ) dan Modrinth ( modrinth-small ). Saat menggunakan ikon dari set ikon (sebagai lawan yang kustom), Anda harus mengawali nama ikon dengan nama set ikon, misalnya, cib:youtube untuk menggunakan ikon youtube dari merek Coreui.url : Tautan ke halaman web.systemMembers: (Opsional) - Bidang ini dimaksudkan untuk sistem jamak untuk menampilkan masing -masing anggotanya. Ini memiliki beberapa nilai yang mungkin:"---" akan menunjukkan kepada Anda sebagai sistem jamak dengan anggota Anda tersembunyi.name: Nama anggota sistem.icon: - Avatar untuk anggota. Anda dapat menggunakan URL apa pun yang Anda inginkan, atau meng-host gambar di situs ini di public/assets/team/images/<your-system-name>/ .
