kosmonaut

---

KoSmonaut ist eine Webbrowser -Engine, die als Fahrzeug für Ihre Reise über das World Wide Web dient.

Der Weg zu den Sternen ist steil und gefährlich. Aber wir haben keine Angst ... Raumflüge können nicht gestoppt werden.

- Yuri Gagarin

Was kann Kosmonaut tun?

Bisher nicht viel. Derzeit wird nur eine sehr begrenzte Untergruppe von CSS unterstützt, sodass die meisten Webseiten nicht funktionieren. Angesichts sehr grundlegender HTML und CSS macht KoSmonaut jedoch die richtigen Dinge - siehe Kosmonauts Rendering dieses Codes im Vergleich zu der von Firefox:

Hier ist eine Zusammenfassung der Dinge, die Kosmonaut tun kann, Dinge, an denen ich gerade arbeite, und Dinge, die vor der Todo -Liste stehen.

• Analysieren Sie HTML und eine kleine Teilmenge von CSS in DOM und Regeln, kaskaden CSS und bewerben Sie sich auf DOM
• Layout und Lackierung des normalen Flusses, nicht wiederholten Block-Level-Boxen.
  • Unterstützen Sie ¹ für abstrakte Box-Layout mit writing-mode und direction
• Snapshot-basierte Tests von Layout-Tree-Dump-Testen und automatische Entdeckung von Ref-Tests
• Unterstützung für willkürliche Skalenfaktoren (z. B. Hoch-DPI-Monitore)
• Textrendern (ohne tatsächliche Integration in das Layout - siehe nächstes Element)
• Layout grundlegender Inhalte auf Inline-Ebene (z. B. Text)

1: Orthogonale Strömungen (siehe Spezifikation) Nicht unterstützt. Der gemischte writing-mode im Allgemeinen (einschließlich paralleler Flows) ist derzeit idfy-ich empfehle einfach, * { writing-mode: <val> } zu verwenden. ↩

Projektziele

Kosmonaut wurde mit der Absicht geschaffen, die Entwicklung der Browser -Engine zu lernen. Das Projekt ist jetzt jedoch ein wenig gekommen, und ich habe über Nischen nachgedacht, auf die ich darauf hinarbeiten kann, Koosmonaut zu passen. Ich habe einige Gedanken zu potenziellen Nischen in diesem Thema geteilt und würde gerne auch Ihre Ideen hören.

Bauen und testen

Kosmonaut wird mit Rost unter Verwendung von OpenGL-Bindungen über GL-RS, Glutin für das Fenstermanagement und die Erstellung von OpenGL-Kontext, die HTML5ever und CSSPARSER für HTML- und CSS-Parsen von Servos und verschiedene andere Hilfsbibliotheken gebaut.

Aus Quelle bauen:

1. Installieren Sie Rost: https://www.rust-lang.org/tools/install
2. Installieren Sie native Abhängigkeiten, von denen die meisten für Freetype benötigt werden, das KoSmonaut für die Textrevision verwendet.
   • Windows 10, MacOS
     • Überspringen Sie diesen Schritt (Kosmonaut verwendet Font-Kit, das die nativen Schriftart-APIs für Windows und MacOS verwendet).
   • Ubuntu
     • Installieren Sie die Abhängigkeiten in dieser Dockerfile auf Ihrem Computer (das apt-get install ).
   • Arch Linux
     • Installieren Sie die Abhängigkeiten in dieser Dockerfile auf Ihrer Maschine (das pacman -Syu -Bit).
   • Für diejenigen, die auf anderen Betriebssystemen laufen, müssen Sie die äquivalenten Pakete installieren. Ich würde gerne mehr Dokumentation über die Installation für andere Systeme erhalten. Öffnen Sie also ein Problem, wenn Sie Probleme haben oder Ihren Setup -Prozess teilen möchten.
3. cargo build

Um HTML und CSS mit KoSmonaut zu rendern, passieren entweder Dateien (HTML und optional CSS):

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

oder eine URL:

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

Um die Tests, sowohl Einheiten als auch Layout, auszuführen, führen Sie aus:

cargo test --all

Bei Layouttests verwandelt KoSmonaut das gegebene HTML und CSS in einen Kastenbaum, legt ihn aus und legt ihn als Text ab. Diese Text -Schnappschüsse werden mit Insta verifiziert.

Wenn Sie Layout -Schnappschüsse überprüfen / aktualisieren müssen, ist es hilfreich, das Cargo Insta CLI -Tool wie SO zu installieren:

cargo install cargo-insta

Kosmonaut kann auch Ref-Tests durchführen. Ref-Tests rendern zwei HTML-Dateien und vergleicht das Ergebnis Pixel-by-Pixel, um sicherzustellen, dass sie gleich sind. Dies ist nützlich in vielen Szenarien, z. B. bei der Prüfung, dass die Kurzstufen genauso wie ihre Langhandäquivalente.

Lizenz und Credits

Die aktuelle Implementierung von KoSmonaut ist stark von Servo inspiriert und nimmt manchmal den Code direkt davon ab. Somit ist Kosmonaut mit der Mozilla Public Lizenz 2.0 lizenziert.

Kosmonaut inspirieren sich auch von Robinson. Vielen Dank an Mbubeck für ihre großartige Reihe von Artikeln über Browser -Motoren.

Schließlich wurde die Implementierung von Kosomonauts DOM von Kuchiki entnommen und leicht geändert, um unseren Bedürfnissen zu entsprechen.