Saya Ubah Tracker Aktivitas GitHub Style Menjadi Modul yang Dapat Digunakan Kembali
Saya pertama kali membangun tracker aktivitas GitHub style untuk website saya sendiri. Bagian itu sudah cukup menyenangkan. Saya suka melihat streak penerbitan saya dalam grid yang sama seperti yang digunakan GitHub. Tapi setelah itu bekerja, saya mulai bertanya-tanya apakah ini hanya sesuatu yang masuk akal di situs saya, atau apakah itu bisa menjadi sesuatu yang dapat digunakan oleh pengguna Hugo lainnya.
Saya mencoba membuatnya menjadi generik. Modulnya ada di sini: https://github.com/kalsdjf23/hugo-activity-heatmap
Bagian yang Sulit Bukan Membangunnya
Versi pertama dikaitkan dengan situs saya sendiri dan struktur konten saya sendiri. Itu tidak masalah ketika Anda hanya membangun untuk diri sendiri. Itu menjadi masalah ketika Anda ingin membagikannya.
Saya harus menghilangkan semua asumsi yang spesifik untuk setup saya. Hal-hal seperti nama bagian, kata-kata, label, dan bagaimana data diinterpretasikan semua perlu menjadi dapat disesuaikan.
Fitur Utama
- Bekerja dengan bagian Hugo apa pun, atau dengan semua halaman biasa
- Menggunakan Date, PublishDate, atau Lastmod
- Menghasilkan heatmap biner atau densitas
- Mengubah kata-kata yang digunakan dalam label dan hitungan
- Opsi untuk menampilkan tanggal mulai
- Bekerja tanpa JavaScript
Open Source Memiliki Batang Kualitas
Apa yang paling mengejutkan saya bukanlah kode. Itu adalah proses di sekitarnya.
Untuk mengirimkan sesuatu seperti ini dengan benar, repo juga memerlukan semua hal yang matang:
- README.md yang tepat
- theme.toml
- hugo.toml root
- Lisensi
- Gambar pratinjau
- Situs contoh
Ketika saya membangun untuk diri sendiri, saya biasanya ingin melewati semua itu dan melanjutkan. Tapi jika orang lain seharusnya menginstal pekerjaan Anda, struktur itu lebih penting saya rasa.
Mengapa Saya Ingin Menerbitkannya
Saya telah menggunakan open source selama bertahun-tahun tanpa benar-benar berkontribusi kembali.
Saya memiliki sesuatu yang terasa layak dibagikan.
Saya juga mengirimkannya ke direktori tema Hugo, jadi sekarang itu ada di tangan orang-orang dengan batang kualitas yang lebih tinggi dari milik saya.
Jika Anda ingin membaca cerita lengkap di balik pembangunannya, screenshot, dan pengiriman direktori tema, saya menuliskannya di sini: https://hugomelis.nl/experiments/experiment-20-open-source-contribution-github-style-activity-component/
