Panduan penggunaan Codeigniter menggunakan Sphinx untuk mengelola dokumentasi dan menghasilkan ke berbagai macam format. Setiap halaman ditulis dalam ReStructured Text human-readable format.
Sphinx membutuhkan Python, yang sudah terinstall jika Anda menggunakan OS X.
Anda dapat mengkonfirmasi di terminal window dengan menjalankan perintah python
tanpa parameter apapun. Jika Python telah terinstall, maka akan muncul versi Python
yang Anda gunakan di Terminal window. Jika versi Python Anda bukan 2.7+, maka kunjungi
http://python.org/download/releases/2.7.2/ dan install versi 2.7.2
- Install python pip
- Masuk ke direktori tempat anda meng-clone repositori ini
cd ci-user-guide-id
- Jalankan perintah
pip install --upgrade pip
untuk update ke versipip
terbaru (opsional) - Lalu, Jalankan perintah
pip install -r requirements.txt
untuk menginstall semua dependensi yang dibutuhkan - Install CI Lexer untuk PHP, HTML, CSS, and JavaScript syntax highlighting di contoh (lihat di
cilexer/README
) atau agar lebih mudah jalankan perintaheasy_install cilexer
- Terakhir, jalankan perintah
make html
Catatan: Anda tidak harus meng-install semua kebutuhan diatas jika anda hanya ingin berkontribusi alih bahasa saja, kecuali jika anda juga ingin melihat hasil html dari compile.
Semua sumber file berada di dalam folder source/
dan di folder itulah Anda akan menambahkan
dokumentasi baru atau memodifikasi dokumentasi yang ada. Sama seperti dengan mengubah kode,
kami sarankan Anda bekerja dari branch feature
dan membuat pull request
ke repository ini.
Generate file HTML sangat simple. Dari root directory repository ini, Anda cukup menjalankan perintah:
make html
Anda akan melihat proses compile yang nanti akan otomatis membuat folder
build/html
dan menyimpan file-file HTML ke folder tersebut. Jika file HTML telah dibuat
dan jika Anda ingin generate file HTML yang baru, setiap kali proses generate berhasil
hanya generate ulang file yang diubah untuk menghemat waktu.
Jika Anda ingin reset file HTML Anda, cukup hapus folder build
atau dapat anda lakukan dengan
menjalankan perintah make clean
dan generate ulang seperti proses sebelumnya.
Silahkan lihat source/documentation/index.rst
untuk panduan umum tentang
menggunakan Sphinx untuk dokumentasi Codeigniter.