kosmonaut

---

Kosmonaut adalah mesin browser web yang dibuat untuk berfungsi sebagai kendaraan untuk perjalanan Anda melintasi World Wide Web.

Jalan menuju bintang -bintang curam dan berbahaya. Tapi kami tidak takut ... penerbangan luar angkasa tidak bisa dihentikan.

- Yuri Gagarin

Apa yang bisa dilakukan Kosmonaut?

Sejauh ini, tidak banyak. Hanya subset CSS yang sangat terbatas yang saat ini didukung, sehingga sebagian besar halaman web tidak akan berfungsi. Namun, mengingat HTML dan CSS yang sangat mendasar, Kosmonaut memang membuat hal -hal yang benar - lihat rendering Kosmonaut Kode ini, dibandingkan dengan yang dari Firefox:

Berikut adalah ringkasan dari hal -hal yang dapat dilakukan Kosmonaut, hal -hal yang sedang saya kerjakan, dan hal -hal yang menuju bagian depan daftar Todo.

• Parse HTML dan subset kecil CSS ke dalam DOM dan aturan, Cascade CSS dan berlaku untuk DOM
• Tata letak dan cat dari aliran normal, kotak tingkat blok yang tidak diganti.
  • Dukungan ¹ untuk tata letak kotak abstrak dengan writing-mode dan direction
• Pengujian berbasis snapshot tata letak dan tes refloving otomatis
• Dukungan untuk faktor skala sewenang-wenang (misalnya monitor DPI tinggi)
• Rendering teks (tanpa integrasi aktual ke tata letak - lihat item berikutnya)
• Tata letak konten level inline dasar yang tidak diganti (seperti teks)

1: Aliran ortogonal (lihat Spec) tidak didukung. Dukungan writing-mode campuran secara umum (termasuk aliran paralel) saat ini rapuh-Saya sarankan cukup menggunakan * { writing-mode: <val> } . ↩

Tujuan proyek

Kosmonaut diciptakan dengan maksud mempelajari pengembangan mesin browser. Namun, proyek ini telah datang sedikit cara sekarang, dan saya sudah memikirkan ceruk yang bisa saya kerjakan untuk menyesuaikan Kosmonaut. Saya telah berbagi beberapa pemikiran tentang ceruk potensial dalam masalah ini, dan akan senang mendengar ide -ide Anda juga.

Membangun dan menguji

Kosmonaut dibangun dengan karat menggunakan binding OpenGL melalui GL-RS, glutin untuk manajemen jendela dan pembuatan konteks OpenGL, HTML5ever Servo dan CSSparser untuk parsing HTML dan CSS, dan berbagai perpustakaan tambahan lainnya.

Untuk membangun dari sumber:

1. Instal Rust: https://www.rust-lang.org/tools/install
2. Instal dependensi asli, yang sebagian besar diperlukan untuk freetype yang digunakan Kosmonaut untuk rendering teks.
   • Windows 10, MacOS
     • Lewati langkah ini (Kosmonaut menggunakan Font-Kit, yang menggunakan API Font asli untuk Windows dan MacOS).
   • Ubuntu
     • Instal dependensi yang ditemukan di DockerFile ini pada mesin Anda (bit apt-get install ).
   • Arch Linux
     • Pasang dependensi yang ditemukan di Dockerfile ini pada mesin Anda (bit pacman -Syu ).
   • Bagi mereka yang berjalan di sistem operasi lain, Anda harus menginstal paket yang setara. Saya ingin mendapatkan lebih banyak dokumentasi tentang instalasi untuk sistem lain, jadi buka masalah jika Anda mengalami masalah atau jika Anda ingin berbagi proses pengaturan Anda.
3. cargo build

Untuk membuat HTML dan CSS dengan Kosmonaut, baik file lulus (HTML dan Opsional CSS):

cargo run -- tests/websrc/rainbow-divs.html

atau URL:

cargo run -- https://twilco.github.io/assets/html/rainbow-divs.html

Untuk menjalankan tes, baik unit dan tata letak, jalankan:

cargo test --all

Untuk tes tata letak, Kosmonaut mengubah HTML dan CSS yang diberikan menjadi pohon kotak, meletakkannya, dan membuangnya sebagai teks. Snapshot teks tersebut diverifikasi dengan Insta.

Jika Anda perlu meninjau / memperbarui snapshot tata letak, akan sangat membantu untuk menginstal alat Insta CLI CARGO So So:

cargo install cargo-insta

Kosmonaut juga dapat menjalankan tes referensi. Tes referensi membuat dua file HTML dan membandingkan hasil piksel-demi-pixel, memastikan mereka sama. Ini berguna dalam banyak skenario, seperti pengujian yang membuat steno membuat sama dengan ekuivalen panjang mereka.

Lisensi dan kredit

Implementasi Kosmonaut saat ini sangat terinspirasi oleh Servo, kadang -kadang mengambil kode langsung darinya. Dengan demikian, Kosmonaut dilisensikan dengan Lisensi Publik Mozilla 2.0.

Kosmonaut juga mengambil inspirasi dari Robinson. Terima kasih kepada Mbrubeck untuk serangkaian artikel mereka yang hebat di mesin browser.

Akhirnya, implementasi DOM Kosomonaut diambil dari Kuchiki dan telah sedikit dimodifikasi agar sesuai dengan kebutuhan kami.