web

Repositori ini adalah sumber kode dari situs komunitas Go Indonesia, https://golang-id.org.

Siapa pun dapat berkontribusi dalam repositori ini.

Repositori ini menggunakan bahasa markup asciidoc untuk format pada konten.

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 duplikasi dan konflik, misalnya dua orang menerjemahkan artikel yang sama, pastikan untuk melihat 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.

• templates/html.tmpl: berisi template yang membungkus hasil HTML dari berkas asciidoc. Sebaik mungkin 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 dengan men set variabel lingkungan DEBUG dengan nilai 2,

$ DEBUG=2 go run ./cmd/www-golangid

Jika ada eror seperti berikut,

Start: listen tcp :5000: bind: address already in use

itu berarti ada program lain yang telah menggunakan port 5000. Anda bisa mengganti port ke yang lain, misalnya 5080,

$ DEBUG=2 go run ./cmd/www-golangid -port=5080

Jika berhasil maka Anda akan melihat keluaran seperti berikut,

....
ciigo: starting HTTP server at ":5000" for "./content"
....

Buka peramban pada alamat http://127.0.0.1:5000 (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!