🤝 Cara Berkontribusi

Wiki ini tetap berguna hanya karena anggota aliansi terus memperbaruinya. Pembaruan, panduan baru, dan tangkapan layarmu membantu semua orang.

Bagaimana situs ini dibuat

Wiki ini ditulis dalam file Markdown sederhana (format yang sama seperti halaman-halaman ini).

Sebuah alat bernama MkDocs (dengan tema Material) mengubah file Markdown ini menjadi situs web bagus yang kamu lihat.

Semua file sumber berada di repositori Git ini.

Ketika perubahan diterima di branch main, sistem otomatis (Forgejo Actions) membangun situs dan menerbitkannya ke ffz.codeberg.page dalam satu atau dua menit. Kamu tidak pernah perlu mengunggah file HTML secara manual.

Apa itu Git?

Git adalah sistem yang mencatat riwayat lengkap setiap perubahan yang dilakukan pada file proyek. Anggap saja sebagai "riwayat versi" untuk seluruh wiki (siapa yang mengubah apa, kapan, dan mengapa).

Kamu tidak perlu memahami Git secara mendalam untuk berkontribusi.

Untuk pekerjaan yang lebih besar (terutama menambah atau memodifikasi foto, membuat halaman baru, atau restrukturisasi besar), mengkloning repositori dan bekerja secara lokal memberimu kontrol penuh dan pengalaman yang jauh lebih baik.

Sisa panduan ini menjelaskan jalur "Git lengkap". Untuk edit teks sederhana, kamu bisa menggunakan editor web langsung di Codeberg (tidak perlu mengkloning apa pun).

Cara mendapatkan material (foto, logo, dll.) dari repositori

Semua gambar disimpan di folder docs/assets/images/:

Potret pahlawan → docs/assets/images/hero/
Logo dan grafis lain → docs/assets/images/logo/
Diagram (seperti counter faksi) → docs/assets/images/

Untuk melihat atau mengunduh gambar yang ada:

Pergi ke repositori di Codeberg
Navigasi ke docs → assets → images
Klik gambar yang kamu inginkan
Klik tombol Raw — ini memberimu gambar langsung. Klik kanan → "Save image as..."

Kamu juga bisa mengkloning seluruh repositori ke komputer (lihat bagian "Bekerja dengan repositori lengkap") jika ingin semua file secara lokal.

Menggunakan antarmuka web

Jika kamu memiliki (atau membuat) akun Codeberg gratis, kamu bisa berkontribusi perubahan — termasuk menambahkan foto atau tangkapan layar baru — langsung melalui situs Codeberg tanpa perlu mengkloning repositori atau menggunakan perintah Git di komputer. Ini sering menjadi jalur termudah untuk kontributor sesekali.

Login ke akun Codeberg kamu di https://codeberg.org.
Pergi ke repositori: https://codeberg.org/FFz/pages
Navigasi ke file Markdown yang ingin kamu edit (atau folder tempat kamu ingin membuat file baru).
Klik tombol Edit (atau "Edit file") untuk file tersebut. Ini membuka editor online Codeberg dengan pratinjau langsung.
Lakukan perubahan teks di editor.
Untuk menambahkan foto atau tangkapan layar baru:
Di area commit di bagian bawah editor (atau saat membuat PR), cari opsi untuk upload files atau lampirkan file baru.
Unggah gambar kamu (akan ditempatkan di lokasi yang benar relatif terhadap perubahan).
Tulis pesan commit yang jelas yang menjelaskan perubahanmu.
Klik Commit changes.
Jika kamu memiliki akses tulis (misalnya kamu bagian dari tim pengembangan), perubahan akan di-commit langsung.
Jika tidak, Codeberg akan secara otomatis membuat Pull Request dari fork di akunmu untuk direview.

Alur web ini mendukung pengunggahan gambar langsung dan cukup untuk sebagian besar kontribusi (pembaruan teks + visual baru).

Bergabung dengan tim pengembangan (untuk kontributor reguler)

Jika kamu berencana berkontribusi secara sering (menambahkan banyak panduan, gambar, atau membantu memelihara wiki), jauh lebih nyaman menjadi anggota tim pengembangan:

Buat akun gratis di https://codeberg.org (jika belum punya).
Hubungi R5 (atau R4) di aliansi — via mail in-game, chat aliansi, atau Discord — dan minta untuk ditambahkan ke tim pengembangan FFz di Codeberg.
Setelah disetujui dan ditambahkan ke organisasi:

Izin yang akan kamu dapatkan: - Akses tulis langsung ke repositori (perubahan bisa di-commit tanpa melalui Pull Request). - Kamu bisa mengedit file via antarmuka web dan diterapkan langsung (atau push dari clone lokal tanpa fork). - Alur kerja lebih cepat untuk pekerjaan rutin. - Jika diberi hak maintainer, kamu juga bisa mereview dan merge Pull Request orang lain.

Tingkat akses ini diperuntukkan bagi anggota aliansi yang dipercaya dan aktif yang secara rutin membantu wiki. Tidak diperlukan untuk kontribusi sesekali — kamu selalu bisa menggunakan antarmuka web atau rute Pull Request yang dijelaskan di atas.

Bekerja dengan repositori lengkap (cara Git)

Untuk perubahan yang lebih kompleks atau saat kamu lebih suka bekerja secara lokal dengan tools sendiri dan pratinjau:

Buat akun gratis di https://codeberg.org (jika belum punya) dan minta R5 menambahkamu ke tim pengembangan (lihat bagian "Bergabung dengan tim pengembangan" untuk detail izin).

Clone repo:

git clone https://codeberg.org/FFz/pages.git
cd pages

Buat branch baru untuk perubahanmu:
```
git checkout -b my-new-guide
```
Edit file Markdown. Jika menambahkan gambar baru, letakkan file di subfolder yang sesuai di bawah docs/assets/images/ (lihat bagian "Cara mendapatkan material" di atas untuk struktur folder, mis. hero/ untuk potret). Referensikan di Markdown menggunakan path relatif (lihat file yang ada seperti Galeri Pahlawan untuk contoh sintaks relatif yang benar).
Pratinjau lokal (sangat disarankan):
```
pip install -r requirements.txt
mkdocs serve
```
Lalu buka http://127.0.0.1:8000 di browser kamu. Perubahan muncul secara langsung.

Ketika puas, commit dan push:

git add .
git commit -m "Tambah panduan baru tentang X dan foto pahlawan"
git push origin my-new-guide

Di Codeberg, buka Pull Request dari branch kamu ke main.

Seorang maintainer akan mereviewnya, mungkin menyarankan perubahan kecil, dan menggabungkannya. Situs akan diperbarui otomatis.

Panduan

Bahasa Inggris (en/) adalah bahasa utama. Perbarui itu dulu, lalu kita bisa terjemahkan ke bahasa lain.
Pertahankan nada ramah dan praktis dari halaman yang ada.
Tambahkan "Terakhir diperbarui" di bagian bawah panduan baru bila relevan.
Untuk perubahan struktural besar, diskusikan dulu dengan R4 atau R5.
Hormati emoji dan gaya format yang ada.

Masih tidak yakin?

Cukup kirim teks, foto, atau ide via mail in-game atau chat aliansi ke officer. Kami akan menangani bagian teknis jika diperlukan.

Terima kasih — setiap perbaikan kecil membantu seluruh aliansi bermain lebih baik bersama.

Bersatu di Bawah Pedang. ⚔️