docs: update README sesuai struktur terbaru

- Tambah daftar 10 grup beserta topik masing-masing
- Dokumentasi assets baru (output.css, localization.js)
- Perjelas aturan pengerjaan dan catatan teknis Tailwind & ID/EN toggle

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Power BI Dev
2026-05-22 07:57:58 +07:00
parent d80baff1e1
commit d0f8e9d859

View File

@@ -1,6 +1,7 @@
# Student-Safe Package (NPM Ready)
# Student Web IF — Development Kit
Paket ini dibuat agar mahasiswa **tidak menerima source code penuh web utama**.
Paket tugas halaman statis untuk mahasiswa Informatika UNTAN.
Navbar dan footer identik dengan web resmi prodi (`informatika.untan.ac.id`).
## Jalankan project
@@ -13,37 +14,64 @@ Buka URL dari Vite (default: `http://localhost:5173`) lalu akses launcher di `/`
## Script NPM
- `npm run dev` → jalankan local dev server
- `npm run build` → build static output ke folder `dist`
- `npm run preview` → preview hasil build
| Perintah | Fungsi |
|---|---|
| `npm run dev` | Jalankan local dev server |
| `npm run build` | Build static output ke folder `dist` |
| `npm run preview` | Preview hasil build |
## Struktur
## Struktur Folder
- `index.html` → launcher link group
- `assets/global/`
- `hero.webp`
- `footer.png`
- `logo.png`
- `groups/group-01/{index.html, style.css}`
- `groups/group-02/{index.html, style.css}`
- `groups/group-03/{index.html, style.css}`
- `groups/group-04/{index.html, style.css}`
- `groups/group-05/{index.html, style.css}`
## Aturan
1. Tiap kelompok hanya mengedit foldernya sendiri.
2. Area konten yang boleh diubah hanya:
```html
<div id="assignment-body"> ... </div>
```
student-web-if-development-kit/
├── index.html ← Launcher (daftar link semua grup)
├── assets/
└── global/
│ ├── output.css ← Tailwind CSS (compiled dari web prod)
│ ├── localization.js ← Toggle bahasa ID/EN
│ ├── hero.webp
│ ├── footer.png
│ └── logo.png
└── groups/
├── Jellyfish.Corp/ ← Group 01
├── HabisIniSeminar/ ← Group 02
├── HarusSelesaiKP/ ← Group 03
├── C4A/ ← Group 04
├── M4N1FEST/ ← Group 05
├── ACAAB/ ← Group 06 — Sorotan dan Prestasi Karya Mahasiswa
├── LimaEm/ ← Group 07 — Kehidupan Mahasiswa & Himpunan (HMIF)
├── RODA/ ← Group 08 — Riset & Kelompok Bidang Keahlian (KBK)
├── Tapops/ ← Group 09 — Berkas Penting
└── ApeNameTeamE/ ← Group 10 — Beasiswa
```
3. Jangan ubah path global asset (`../../assets/global/...`).
4. Tidak ada JS global project.
Setiap folder grup berisi:
- `index.html` → halaman tugas (navbar + footer sudah tersedia)
- `style.css` → CSS tambahan milik kelompok (opsional)
## Aturan Pengerjaan
1. **Tiap kelompok hanya mengedit foldernya sendiri.**
2. Area konten yang boleh diubah hanya bagian ini di dalam `index.html`:
```html
<!-- ================= START: BAGIAN YANG DIEDIT KELOMPOK ================= -->
...konten kalian di sini...
<!-- ================= END: BAGIAN YANG DIEDIT KELOMPOK ================= -->
```
3. Jangan ubah navbar, footer, dan path asset global (`../../assets/global/...`).
4. Boleh menambah `<style>` atau mengedit `style.css` untuk styling konten.
5. `node_modules` tidak perlu di-commit — jalankan `npm install` untuk generate ulang.
## Catatan Teknis
- Navbar dan footer menggunakan **Tailwind CSS** dari `assets/global/output.css` (tidak perlu install Tailwind per grup).
- Toggle **ID/EN** di navbar berfungsi penuh via `assets/global/localization.js`.
- Mega menu dan mobile menu sudah aktif via inline script di tiap halaman.
## Output Pengumpulan
Setiap kelompok submit perubahan di:
- `groups/group-xx/index.html`
- `groups/group-xx/style.css` (jika perlu styling tambahan)
Setiap kelompok submit perubahan pada:
- `groups/<nama-folder>/index.html`
- `groups/<nama-folder>/style.css` (jika ada)