Kumpulan dokumen yang menggambarkan praktik terbaik untuk tim web kanonik.
Ini juga dapat dilihat di https://canonical-webteam.github.io/practices/.
Situs ini dibangun menggunakan Jekyll.
Untuk menjalankan situs ini secara lokal, Anda harus terlebih dahulu menginstal Ruby di mesin lokal Anda.
Setelah menginstal Ruby, Anda kemudian dapat menginstal Bundler dengan menjalankan;
gem install bundler -v 1.17.3
Langkah selanjutnya adalah memasang permata ruby yang diperlukan untuk menjalankan situs dengan bundler;
bundle install
Anda kemudian dapat melayani situs menggunakan Jekyll;
jekyll serve
... yang harus membuka situs secara lokal di browser Anda di http://127.0.0.1:4000/practices/
Untuk pedoman tentang berkontribusi pada dokumen -dokumen ini, lihat Kontribusi.MD.
Basis kode ini menggunakan lebih cantik untuk memastikan pemformatan yang konsisten.
Untuk menjalankan lebih cantik di atas basis kode (dengan asumsi Anda telah menginstal benang), jalankan:
yarn prettier-write **/*
Jika Anda mengalami masalah ketika mencoba menjalankan permata yang diinstal, yang menyatakan bahwa itu tidak dapat ditemukan, pastikan bahwa direktori di mana permata diinstal termasuk dalam jalur Anda. Anda dapat memverifikasi ini dengan mengetikkan echo $PATH di terminal dan memeriksa folder di output. Jika Anda tidak yakin folder apa yang dipasang permata Anda, jalankan gem env | grep EXECUTABLE DIRECTORY dan tambahkan jalur yang dicetak ke variabel lingkungan jalur Anda.
Konten proyek ini dilisensikan di bawah lisensi internasional Atribution-Sharealike 4.0 Creative Commons, dan kode dasar yang digunakan untuk memformat dan menampilkan konten yang dilisensikan di bawah LGPLV3 oleh Canonical Ltd.