Code Cite - Ekstensi VS Code

Code Cite adalah ekstensi Visual Studio Code sederhana yang dirancang untuk membantu akademisi, mahasiswa, dan developer melacak dan menyitasi blok kode langsung di dalam editor mereka.

Ekstensi ini lahir dari kebutuhan untuk mengintegrasikan referensi kode (misalnya dari StackOverflow, dokumentasi, atau model AI) dengan source code secara mulus, dan kemudian mengekspornya ke dalam format yang kompatibel dengan aplikasi web Code Cite.

Fitur Utama

1. Tambah Blok Sitasi: Menambahkan template komentar sitasi secara otomatis di sekitar kode yang Anda pilih (blok) hanya dengan satu klik kanan.
2. Ekspor Sitasi Workspace: Memindai seluruh workspace Anda, mengekstrak semua sitasi, dan mengemas seluruh proyek (termasuk file metadata .codesite.json) ke dalam satu file .zip yang rapi.

Cara Penggunaan

1. Menambah Sitasi

1. Blok Kode: Pilih/blok baris kode di editor yang ingin Anda sitasi.
2. Klik Kanan: Klik kanan pada kode yang telah Anda pilih.
3. Pilih Perintah: Pilih Code Cite: Add Citation Block dari menu konteks.

Ekstensi akan secara otomatis menyisipkan template komentar di atas dan di bawah kode Anda.

Format Komentar

Isi template komentar yang telah dibuat. Ekstensi ini sangat pintar dan dapat membaca format terstruktur berikut:

# CITE-START:
#   Judul: [Isi Judul Referensi, misal: 'Dokumentasi Python input()']
#   Tipe: url | ai | other
#   Value: [Isi Link / Nama AI / Sumber lain]
#   Notes: [Catatan tambahan Anda]
# ---
... kode yang Anda sitasi ...
# CITE-END

• Tipe url: Gunakan untuk link ke dokumentasi, StackOverflow, dll.
• Tipe ai: Gunakan untuk kode yang di-generate oleh AI (misal: Gemini, ChatGPT).
• Tipe other: Gunakan untuk sumber lain (misal: "Buku A Bab 5", "Materi Kuliah").

2. Mengekspor Proyek

1. Buka Command Palette: Tekan Ctrl+Shift+P (atau Cmd+Shift+P di Mac).
2. Cari Perintah: Ketik Code Cite dan pilih Code Cite: Export Workspace Citations as .zip.
3. Selesai: Ekstensi akan memindai seluruh proyek Anda dan menyimpan file .zip (misal: nama-proyek-codecite-export.zip) di root folder workspace Anda.

File .zip ini berisi seluruh kode Anda DAN sebuah file .codesite.json yang dapat diimpor ke aplikasi web Code Cite untuk diproses lebih lanjut.

Rencana (Roadmap)

• [ ] Fitur untuk mengimpor .codesite.json ke dalam web app.
• [ ] Mendukung lebih banyak bahasa (C#, C++, JS/TS).

Kontribusi

Merasa ada yang kurang atau menemukan bug ? Silakan buka issue atau pull request di GitHub Repository.