summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorShulhan <m.shulhan@gmail.com>2020-03-15 17:04:05 +0700
committerShulhan <m.shulhan@gmail.com>2020-03-15 17:04:05 +0700
commit1fce7c7982bbb9e1957de26c2aead2fbbeae4539 (patch)
tree7796e4bf982a76c5ba84e619318d96b76e0dd422
parent7ec18958cc2f60692f4e34e109c1a29dcc0e3880 (diff)
downloadgolang-id-web-1fce7c7982bbb9e1957de26c2aead2fbbeae4539.tar.xz
README: perbaikan langkah dan perintah untuk berkontribusi
Fix #2
-rw-r--r--README.adoc56
-rw-r--r--content/berkontribusi.adoc55
2 files changed, 73 insertions, 38 deletions
diff --git a/README.adoc b/README.adoc
index 25f95bb..f4f742d 100644
--- a/README.adoc
+++ b/README.adoc
@@ -30,7 +30,7 @@ terjemahkan.
Repositori ini menggunakan konvensi direktori dan berkas yang sama dengan
https://github.com/shuLhan/ciigo[kerangkanya]:
-* `cmd/golangid`: direktori ini adalah program utama yang berisi konten
+* `cmd/www-golangid`: direktori ini adalah program utama yang berisi konten
statis.
Program inilah yang nantinya melayani situs golang-id.org.
@@ -52,35 +52,53 @@ https://github.com/shuLhan/ciigo[kerangkanya]:
Berikut langkah-langkah untuk memulai pengembangan di komputer anda,
-. Salin repositori ini ke dalam
- https://golang-id.org/doc/code.html#Workspaces[ruang-kerja] Go anda
-+
+Salin repositori ini ke dalam
+https://golang-id.org/doc/code.html#Workspaces[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 perintah `go generate` untuk membangkitkan berkas HTML dari
- berkas-berkas asciidoc.
-+
+Jalankan program `www-golangid` di komputer anda dengan men set variabel
+lingkungan `DEBUG` dengan nilai `2`,
+
----
-$ go generate
+$ DEBUG=2 go run ./cmd/www-golangid
----
-. Jalankan program `golangid` di komputer anda dengan men set variabel
- lingkungan `DEBUG` dengan nilai `2`,
-+
+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,
+
----
-$ export DEBUG=2
-$ ./golangid
+$ DEBUG=2 go run ./cmd/www-golangid -port=5080
----
-. Buka peramban dengan alamat http://127.0.0.1:5000.
- Situs lokal dari golang-id.org akan muncul di halaman tersebut.
-. Untuk membuat halaman baru, lihat contoh yang sudah ada dalam direktori
- "content".
+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.
-. Jika anda ingin menggabungkan pekerjaan anda, silakan _commit_ dan _push_
- ke repositori anda sendiri dan buat _pull request_ ke repositori ini.
+_Happy hacking!_
diff --git a/content/berkontribusi.adoc b/content/berkontribusi.adoc
index 3a41c9e..d9b925b 100644
--- a/content/berkontribusi.adoc
+++ b/content/berkontribusi.adoc
@@ -75,7 +75,7 @@ terjemahkan.
Repositori ini menggunakan konvensi direktori dan berkas yang sama dengan
https://github.com/shuLhan/ciigo[kerangkanya]:
-* `cmd/golangid`: direktori ini adalah program utama yang berisi konten
+* `cmd/www-golangid`: direktori ini adalah program utama yang berisi konten
statis.
Program inilah yang nantinya melayani situs golang-id.org.
@@ -96,35 +96,52 @@ https://github.com/shuLhan/ciigo[kerangkanya]:
Berikut langkah-langkah untuk memulai pengembangan di komputer anda,
-. Salin repositori ini ke dalam
- https://golang-id.org/doc/code.html#Workspaces[ruang-kerja] Go anda
-+
+Salin repositori ini ke dalam
+https://golang-id.org/doc/code.html#Workspaces[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 perintah `go generate` untuk membangkitkan berkas HTML dari
- berkas-berkas asciidoc.
-+
+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,
+
----
-$ go generate
+$ DEBUG=2 go run ./cmd/www-golangid -port=5080
----
-. Jalankan program `golangid` di komputer anda dengan men set variabel
- lingkungan `DEBUG` dengan nilai `2`,
-+
+Jika berhasil maka Anda akan melihat keluaran seperti berikut,
+
----
-$ export DEBUG=2
-$ ./golangid
+....
+ciigo: starting HTTP server at ":5000" for "./content"
+....
----
-. Buka peramban dengan alamat http://127.0.0.1:5000.
- Situs lokal dari golang-id.org akan muncul di halaman tersebut.
+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".
-. 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.
-. Jika anda ingin menggabungkan pekerjaan anda, silakan _commit_ dan _push_
- ke repositori anda sendiri dan buat _pull request_ ke repositori ini.
+_Happy hacking!_