Halaman ini mendokumentasikan daftar pekerjaan yang dapat dilakukan untuk situs golang-id.org. Ada tiga komponen utama yang diharapkan oleh situs ini sebagai komunitas Go Indonesia:
1. Menerjemahkan artikel dari bahasa Inggris ke Bahasa Indonesia. Penerjemahan ini bertujuan untuk memudahkan pengguna baru dalam beradaptasi dan menggunakan Go.
2. Mengumpulkan blog tentang Go yang ditulis oleh komunitas Go Indonesia. Setiap blog nantinya dapat diakses lewat https://golang-id.org/~[penulis]/[judul].
3. Mengumpulkan repositori Go yang ditulis oleh komunitas Go Indonesia. Kumpulan repositori ini seperti halaman wiki Projects atau awesome-go namun khusus untuk komunitas Go Indonesia.
Daftar terjemahan
Daftar artikel yang rekomendasi untuk diterjemahkan, diurut berdasarkan bagian:
-
Wiki
-
https://github.com/golang/go/wiki/Modules ⇒ /wiki/Modules/index.adoc
-
https://github.com/golang/go/wiki/IDEsAndTextEditorPlugins ⇒ /wiki/IDEsAndTextEditorPlugins/index.adoc
-
Cara berkontribusi
Alur kerja untuk berkontribusi dalam repositori ini, baik dalam bentuk kode, terjemahan, atau blog; sama dengan alur kerja pada proyek-proyek sumber terbuka lainnya, yaitu dengan cara membuat salinan repositori lewat Github, commit, dan buat pull request.
Untuk menghindari duplikat dan konflik, misalnya dua orang menerjemahkan artikel yang sama, lihat halaman isu terlebih dahulu, apabila tidak ada yang mengklaim untuk menerjemahkan artikel tersebut, buat isu baru dan nyatakan dalam isu tersebut artikel yang akan anda terjemahkan.
Struktur direktori dan berkas
Repositori ini menggunakan konvensi direktori dan berkas yang sama dengan kerangkanya:
-
cmd/www-golangid: direktori ini adalah program utama yang berisi konten statis. Program inilah yang nantinya melayani situs golang-id.org. -
_content: direktori ini berisi konten/halaman dari situs. Setiap halaman dibuat dengan menggunakan format asciidoc dan harus menggunakan ekstensi ".adoc". Berkas dengan ekstensi selain ".adoc" akan diindahkan. -
_content/assets: direktori yang menyimpan berkas statis, seperti stylesheet. -
_content/html.tmpl: berisi template yang membungkus hasil HTML dari berkas asciidoc. Sebaiknya berkas ini tidak diubah dahulu, kecuali anda tahu yang anda lakukan.
Memulai pengembangan
Berikut langkah-langkah untuk memulai pengembangan di komputer anda,
Salin repositori ini ke dalam ruang-kerja Go anda
$ mkdir -p $GOPATH/src/github.com/golang-id/web $ cd $GOPATH/src/github.com/golang-id/web $ git clone https://github.com/golang-id/web .
Jalankan program www-golangid di komputer anda lewat Makefile,
$ make serve
Jika ada eror seperti berikut,
Start: listen tcp :5080: bind: address already in use
itu berarti ada program lain yang telah menggunakan port 5080. Anda bisa mengganti port ke yang lain, misalnya 5081,
$ DEBUG=1 go run ./cmd/www-golangid -port=5081
Jika berhasil maka Anda akan melihat keluaran seperti berikut,
.... ciigo: starting HTTP server at ":5080" for "./_content" ....
Buka peramban pada alamat http://127.0.0.1:5080 (atau sesuai dengan port yang Anda berikan). Situs lokal dari golang-id.org akan muncul di halaman tersebut.
Untuk membuat halaman baru, lihat contoh yang sudah ada dalam direktori "_content".
Jika anda ingin menggabungkan pekerjaan anda, silakan commit dan push ke repositori anda sendiri dan buat pull request ke repositori ini.
Happy hacking!