SVN Proyek Dokumentasi Debian

Proyek Dokumentasi Debian tersimpan pada halaman web dan banyak teks manual di server Subversion Debian pada svn.debian.org. svn.debian.org adalah bagian dari instalasi pada alioth.debian.org. Silahkan baca Dokumentasi Alioth untuk informasi selengkapnya tentang bagaimana layanan ini bekerja.

Setiap orang dapat mendownload sumber dari server SVN. Hanya anggota Proyek Dokumentasi Debian yang dapat memperbarui file.

Mengakses sumber di SVN

Anda dapat menggunakan antarmuka web untuk mengakses berkas secara individual dan melihat perubahannya pada http://anonscm.debian.org/viewvc/ddp/manuals/trunk/

Untuk mendownload seluruh manual, akses langsung ke server SVN seringkali menjadi pilihan terbaik. Anda membutuhkan paket subversion di mesin Anda sendiri.

Menghubungkan secara anonim (baca-saja) ke server SVN

Gunakan perintah berikut untuk mendownload semua berkas:

svn co svn://svn.debian.org/svn/ddp/manuals/trunk manuals

Ini akan secara rekursif membuat folder dan mengumpulkannya.

Untuk memperbarui salinan lokal dengan perubahan yang telah dibuat orang lain, masuk ke folder manuals dan jalankan perintah berikut:

svn export --force svn://svn.debian.org/svn/ddp/manuals

Menghubungkan ke server SVN, dengan hak mengupdate (svn)

Sebelum mengakses server SVN menggunakan cara ini Anda harus mendapat hak akses menulisnya terlebih dahulu. Silahkan baca bagaimana cara meminta izin update terlebih dahulu.

Gunakan perintah berikut untuk mendownload semua berkas:

svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals

Perintah ini akan secara rekursif membuat folder dan mengumpulkannya.

Untuk memperbarui salinan lokal Anda dengan perubahan yang telah dilakukan oleh orang lain, masuk ke folder manuals dan jalankan perintah berikut:

svn update

Menghubungkan ke server SVN, dengan hak mengupdate (git-svn)

Sebelum mengakses server SVN menggunakan cara ini Anda harus mendapat hak akses menulisnya terlebih dahulu. Silahkan baca bagaimana cara meminta izin update terlebih dahulu.

Gunakan perintah berikut untuk mendownload semua berkas:

git svn clone -s -rHEAD svn+ssh://svn.debian.org/svn/ddp/manuals manuals

Perintah ini akan secara rekursif membuat folder dan mengumpulkannya dan juga membuat repositori lokal git tanpa sejarah yang lama dapat melacak server SVN Alioth.

Untuk mengupdate salinan lokal dengan perubahan yang telah dibuat oleh orang lain, masuk ke folder manuals dan jalankan perintah berikut:

git svn rebase

Mendapatkan hak istimewa pembaruan

Hak istimewa update tersedia kepada siapa saja yang ingin berpartisipasi dalam penulisan manual. Kami umumnya meminta Anda telah mengirimkan beberapa patch yang berguna terlebih dahulu.

Untuk mendapatkan hak istimewa, Anda perlu mengirimkan permintaan ke Milis Dokumentasi Debian . Harap jelaskan mengapa Anda memerlukan akses. Harap indikasikan nama login Alioth Anda. Setelah permintaan Anda disetujui, Anda akan menjadi bagian dari proyek ddp (dan grup Unix) di Alioth.


Mekanisme pembaruan otomatis

Halaman web yang diterbitkan dari teks manual dihasilkan pada www-master.debian.org sebagai bagian dari proses pembangunan kembali situs web biasa, yang terjadi setiap empat jam sekali.

Script menjalankan perintah svn export --force svn://svn.debian.org/svn/ddp/manuals, kemudian make -C trunk publish.

Makefile ini dibentuk untuk membangun kembali setiap subdirektori (yang berisi dokumentasi yang dimaintain), dan menginstall file dari setiap sub direktori pada doc/manuals/ subdirektori situs web. Subdirektori makefile berasal dari manuals/standard.makefile.

File dokumentasi yang dihasilkan oleh script update dapat ditemukan di http://www.debian.org/doc/manuals/.

File log yang dihasilkan oleh script update dapat ditemukan di http://www-master.debian.org/build-logs/ddp/

Perhatikan bahwa proses ini meregenerasi folder /doc/manuals/. Isi dari folder /doc/ dihasilkan baik dari webwml atau dari script lain, seperti manual tertentu yang diekstrak dari paket mereka.