Pustaka pihak ketiga
Semuanya boleh disertakan dalam produk komersial sesuai lisensinya masing-masing.
| Pustaka | Versi | Lisensi | Dipakai di |
|---|---|---|---|
| Bootstrap | 5.3.3 | MIT | Semua halaman |
| Tabler Icons | 3.19.0 | MIT | Semua halaman |
| Plus Jakarta Sans | Font | SIL OFL 1.1 | Semua halaman |
| ApexCharts | 3.54.1 | MIT | Semua halaman ber-sidebar; grafik di empat dasbor dan Grafik |
| FullCalendar | 6.1.21 | MIT | Kalender |
| SortableJS | 1.15.7 | MIT | Kanban, Seret & lepas |
| DataTables | 2.3.8 | MIT | Tabel data |
| jQuery | 3.7.1 | MIT | Tabel data saja, untuk DataTables |
| Flatpickr | 4.6.13 | MIT | Pemilih tanggal & warna |
| Tom Select | 2.6.2 | Apache-2.0 | Pemilih tanggal & warna |
| FilePond | 4.32.12 | MIT | Unggah berkas |
| Plugin FilePond | 4.6.12 · 1.2.9 · 2.2.8 | MIT | Pratinjau gambar, pemeriksaan jenis dan ukuran berkas di Unggah berkas |
| SweetAlert2 | 11.26.25 | MIT | SweetAlert |
| Quill | 2.0.3 | BSD-3-Clause | Editor teks |
| marked | 12.0.2 | MIT | Editor teks (pratinjau Markdown) |
| DOMPurify | 3.1.6 | MPL-2.0 atau Apache-2.0 | Editor teks (membersihkan HTML pratinjau) |
| jsvectormap | 1.6.0 | MIT | Peta |
| Font Awesome Free | 7.3.1 | Ikon CC BY 4.0, font SIL OFL 1.1, kode MIT | Ikon |
| Bootstrap Icons | 1.13.1 | MIT | Ikon |
| Phosphor Icons | 2.1.2 | MIT | Ikon |
Plugin FilePond terdiri atas pratinjau gambar (4.6.12), validasi jenis berkas (1.2.9), dan validasi ukuran berkas (2.2.8). DataTables dimuat bersama paket gaya Bootstrap 5-nya, datatables.net-bs5, dengan versi yang sama.
Pemilih tanggal (sl-datepicker.js) dan pengunggah berkas (sl-upload.js) adalah bagian dari Selaras sendiri, bukan pustaka pihak ketiga.
Font Awesome wajib diberi kredit
Ikon Font Awesome Free berlisensi CC BY 4.0, yang mewajibkan kredit. Bila produk Anda menyertakan ikon Font Awesome, sebutkan di halaman kredit, halaman tentang, atau dokumentasi Anda, dan pertahankan komentar lisensi di bagian atas berkas CSS-nya.
Kalimat kredit yang bisa Anda pakai:
Icons by Font Awesome Free (fontawesome.com), licensed under CC BY 4.0. Di Selaras, Font Awesome hanya dimuat di UI Kit › Ikon, sebagai salah satu dari tiga set ikon opsional. Ikon bawaan di tempat lain adalah Tabler Icons, berlisensi MIT.
Letak berkas
Semua pustaka sudah termasuk dalam unduhan, di assets/vendor/ — satu folder per pustaka, dengan berkas lisensinya di sampingnya. Font-nya juga ada di sana, di assets/vendor/plus-jakarta-sans/. Tidak ada yang dimuat dari CDN, jadi halaman tetap berfungsi tanpa internet dan di intranet.
Halaman menautkan berkas-berkas itu di tiga tempat:
src/partials/head.html— font, CSS Bootstrap, dan Tabler Icons, untuk setiap halaman.src/layout.html,src/layout-auth.html,src/layout-error.htmldansrc/layout-store.html— JavaScript Bootstrap;src/layout.htmljuga memuat ApexCharts.- Daftar
"styles"dan"scripts"di baris meta setiap halaman disrc/pages/— semua pustaka lainnya, hanya di halaman itu.
Memperbarui pustaka
Versinya tercatat di vendor.json. Skrip tools/vendor.mjs menyalinnya ke assets/vendor/: berkas yang terdaftar, font dan gambar yang dirujuk stylesheet-nya, serta lisensinya.
- Baca dulu catatan rilis versi barunya (lihat Sebelum menaikkan versi pustaka), lalu ubah versinya di
vendor.json. - Jalankan skripnya. Skrip ini butuh Node.js 18 atau lebih baru dan koneksi internet — hanya untuk langkah ini.
node tools/vendor.mjs - Rakit ulang dengan
node build.mjs. Tautan pustaka juga mendapat cap versi, jadi browser memuat berkas baru, bukan salinan lama dari cache. - Periksa halaman yang memakai pustaka itu — daftarnya ada di tabel di atas — dalam mode terang dan gelap.
Skrip ini mengganti seluruh folder assets/vendor/, jadi simpan berkas Anda sendiri di tempat lain, misalnya di assets/js/. Path yang diawali assets/ disesuaikan otomatis untuk halaman Indonesia di id/.
Lebih suka CDN? Ganti path lokal dengan alamat CDN versi yang sama, misalnya https://cdn.jsdelivr.net/npm/apexcharts@3.54.1/dist/apexcharts.min.js, lalu rakit ulang.
Membuang pustaka yang tidak dipakai
Sebagian besar pustaka hanya dimuat di halaman yang memakainya, lewat meta "styles" dan "scripts" halaman itu. Menghapus satu pustaka tidak pernah memengaruhi halaman lain. Untuk membuang satu halaman UI Kit beserta pustakanya:
- Hapus sumber halamannya, misalnya
src/pages/ui-pickers.html, beserta skripnyaassets/js/ui-pickers.js. - Hapus entrinya dari daftar
NAVdibuild.mjs. Pencarian di halaman 404 dibuat dari daftar yang sama, jadi ikut diperbarui. - Rakit ulang dengan
node build.mjs, lalu hapus berkas hasil rakitan yang lama (ui-pickers.htmldanid/ui-pickers.html) — perakit tidak menghapus halaman yang tidak lagi dibuatnya. - Opsional: hapus kulit pustaka itu dari
assets/css/selaras.css. Setiap kulit berada di bawah komentar judulnya sendiri, sepertiFlatpickr 4.6atauTom Select 2.6.
Untuk mempertahankan halaman tetapi membuang salah satu pustakanya, hapus URL-nya dari meta halaman dan kode yang memanggil pustaka itu di skrip halaman.
Pustaka bersama
- Bootstrap dan Tabler Icons dipakai di setiap halaman — dropdown, modal, tooltip, grid, dan semua ikon bergantung padanya. Jangan dihapus.
- ApexCharts dimuat di setiap halaman yang punya sidebar. Kalau Anda tidak butuh grafik, hapus barisnya dari
src/layout.html; halaman tetap berjalan, hanya grafiknya yang tidak digambar. Hapus juga kartu grafik di dasbor. - jQuery hanya dibutuhkan DataTables. SortableJS dipakai Kanban dan Seret & lepas, dan FullCalendar dipakai aplikasi Kalender.
Sebelum menaikkan versi pustaka
Selaras dibangun dan diuji dengan versi di atas. Sebelum pindah ke versi yang lebih baru, baca changelog dan lisensinya — ketentuannya bisa berubah antarversi.
- ApexCharts — versi 3.54.1 berlisensi MIT. Periksa lisensi versi yang lebih baru sebelum menaikkan versi, karena bisa saja berbeda.
- FullCalendar — Selaras memakai paket standar yang berlisensi MIT. FullCalendar juga menjual plugin premium (seperti tampilan timeline dan resource) dengan lisensi komersial. Plugin itu tidak disertakan; tambahkan hanya bila Anda membeli lisensinya.
- SweetAlert2 — versi yang disertakan sudah diperiksa. Baca catatan rilis versi yang lebih baru sebelum menaikkan versi.
Selaras menata ulang tampilan pustaka-pustaka ini secara mendalam. Setelah menaikkan versi, periksa dasbor, grafik, dan halaman UI Kit di mode terang maupun gelap.
Kredit
Selaras dibangun di atas karya proyek open-source yang tercantum di atas. Terima kasih kepada para pembuat dan kontributornya: Bootstrap, Tabler Icons, ApexCharts, FullCalendar, SortableJS, jQuery, DataTables, Flatpickr, Tom Select, FilePond, SweetAlert2, Quill, marked, DOMPurify, jsvectormap, Font Awesome, Bootstrap Icons, Phosphor Icons, dan huruf Plus Jakarta Sans.
Setiap pustaka tetap memakai lisensinya sendiri. Teks lisensinya disertakan di samping berkasnya di assets/vendor/.