This repository has been archived by the owner on Sep 23, 2019. It is now read-only.
forked from endymuhardin/buku-git
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
efcf764
commit e2650f6
Showing
1 changed file
with
40 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,11 +1,45 @@ | ||
Buku Git | ||
-------- | ||
|
||
Kebutuhan Aplikasi : | ||
Buku Git adalah usaha untuk memasyarakatkan penggunaan version control di Indonesia, khususnya Git. | ||
Penggunaan version control adalah langkah pertama menuju pembuatan software yang profesional. | ||
Sayangnya banyak programmer di Indonesia yang tidak menggunakan version control hanya karena tidak tersedianya tutorial dan dokumentasi dalam bahasa Indonesia. | ||
|
||
Mudah-mudahan dengan adanya buku ini, programmer Indonesia bisa menjadi lebih kompeten, profesional, dan mampu bersaing di dunia internasional. | ||
|
||
|
||
Cara menggunakan | ||
---------------- | ||
|
||
Buku ini dibuat dalam format docbook. | ||
Docbook adalah format penulisan buku dalam XML. Karena XML berbentuk text file biasa, maka kita bisa simpan di dalam version control dengan segala fiturnya, seperti misalnya : riwayat perubahan, membandingkan antar versi, dan lainnya. Lebih detail tentang Docbook dapat dilihat di [Wikipedia](http://en.wikipedia.org/wiki/DocBook "Docbook di Wikipedia") | ||
|
||
Membaca file XML tentunya tidak menyenangkan bagi manusia biasa. Dengan demikian, kita harus konversi menjadi format yang lebih manusiawi seperti HTML atau PDF. | ||
|
||
Berikut cara konversinya. | ||
|
||
Kebutuhan Aplikasi | ||
------------------ | ||
1. Java SDK versi terbaru | ||
2. Maven 2 versi terbaru | ||
|
||
Cara penggunaan : | ||
1. Clone dulu repositorynya | ||
2. Build dengan maven | ||
3. Buku hasil pemrosesan ada di folder target | ||
4. Untuk melakukan perubahan, edit sourcenya di folder src/main/docbkx | ||
Cara konversi | ||
------------- | ||
1. Clone dulu repositorynya untuk mengambil source code buku dalam format docbook | ||
2. Buka command prompt dan masuk ke folder buku-git | ||
3. Konversi dengan perintah mvn clean install | ||
4. Buku hasil pemrosesan ada di folder target | ||
|
||
Cara edit | ||
--------- | ||
Docbook adalah XML biasa. Gunakan editor XML untuk mengeditnya. Di editor canggih, kita bisa menggunakan fitur autocomplete untuk membuat tag docbook | ||
|
||
Cara kontribusi | ||
--------------- | ||
Anda ingin menyumbangkan tulisan? Baguslah kalau begitu. | ||
Caranya gampang, | ||
1. Fork repository ini menjadi repository Anda sendiri | ||
2. Clone ke local untuk diedit | ||
3. Editlah sesuka hati | ||
4. Commit dan push ke repository Anda sendiri | ||
5. Kirim pull request ke saya supaya bisa saya merge ke repository saya |