Use Git and/or send patches to RBoot

English | Deutsch | українська

Verzeichnis

RBoot Repositories

Informationen darüber wer an RBoot arbeitet und wer das Projekt betreibt sind unter who.de.html zu finden.

Das rboot Projekt hat hauptsächlich 3 Git Repositories:

Die Entwicklung von RBoot findet mithilfe der Versionskontrolle von Git statt. Sieh in der offiziellen Git Dokumentation nach, sofern Du nicht weisst wie man Git verwendet.

rbmk (rboot-make)

Dies ist das zentrale build system in RBoot. Man könnte auch sagen rbmk ist RBoot! Das Git repository herunterladen:

git clone https://codeberg.org/rboot/rbmk

Der oben dargestellte git Befehl, wird das RBoot build system rbmk herunterladen. Du kannst dann folgendermassen in das Verzeichnis wechseln:

cd rbmk

Ändere dies nach deinen Vorstellungen oder erstelle einfach einen build. Für Anleitungen bzgl. rbmk build, siehe build Anleitungen.

Informationen über das build system selbst und wie es funktioniert, sind verfügbar unter dem rbmk maintenance guide.

rbwww and rbwww-img

Die gesamte RBoot Website sowie Dokumentation befindet sich in einem Git Repository. Du kannst es folgendermassen herunterladen:

git clone https://codeberg.org/rboot/rbwww

Bilder befinden sich unter https://av.rboot.org/ und sind verfügbar in einem separaten Git Repository:

git clone https://codeberg.org/rboot/rbwww-img

Du kannst alles nach deinen Vorstellungen ändern. Beachte die nachfolgenden Informationen wie Du deine Änderungen zur Verfügung stellen kannst.

Die gesamte Website ist in Markdown geschrieben, insbesondere die Pandoc Version. Die statischen HTML Seiten werden mit RBoot generiert. GNU Leah Rowe™, die Gründerin von RBoot, ist auch die Gründerin des RBoot static site generator Projekts.

Wenn Du möchtest, kannst Du einen lokalen HTTP Server einrichten und eine lokale Version der Website herstellen. Bitte bedenke, dass alle Bilder nach wie vor mit den Bildern auf https://av.rboot.org/ verknüpft werden, daher werden jegliche Bilder die Du rbwww-img hinzugefügt hast nicht auf deiner lokalen rbwww Seite dargestellt, sofern Du die Bilder (die Du hinzugefügt hast) mit av.rboot.org verknüpfst. Es ist jedoch erforderlich, dass sich diese Bilder auf av.rboot.org befinden.

Sofern Du der Webseite Bilder hinzufügen möchtest, füge diese ebenso dem rbwww-img Repository hinzu, indem Du diese dann jeweils mit diesem Link verknüpfst https://av.rboot.org/path/to/your/new/image/in/rbwww-img. Wenn dein Patch der RBoot Webseite hinzugefügt wird, werden erscheinen deine Bilder live.

If adding a photo, compress it for web distribution. Images should be about 800px wide, and usually under 100KiB in size:

First, scale your image down to approximately 800px width, using your favourite image manipulation program. For example, with imagemagick you can do the following (make sure the image isn’t already smaller or equal than preferred).

convert original.jpg -resize 600000@ -quality 70% web.jpg

You should always run jpegoptim on jpg images before submitting them. It strips useless metadata and losslessly optimises them further by cleverly rearranging the huffman tables used in them.

jpegoptim -s --all-progressive web.jpg

If the image is a (line) drawing, vector graphics are preferable to bitmaps. Therefore, if possible, save them as SVGs. Those are easy to modify, and will surely make translators’ work easier as well.

PNG images should be optimised with zopfli (this is lossless as well). For example, this reduced the RBoot boot logo from around 11k to 3k:

zopflipng -ym image.png image.png

Zu Entwicklungszwecken, könntest Du deine Bilder auch lokal verknüpfen, und anschliesend die URLs anpassen sobald Du deine Patches für die Dokumentation/Webseite schickst.

Eine Anleitung wie Du eine lokale Version der Webseite herstellen kannst, befinden sich auf der RBoot Webseite. Lade rbssg herunter, und erstelle in dem rbssg Verzeichnis ein Verzeichnis mit dem Namen www/ dann wechsle in dieses Verzeichnis und klone das rbwww Repository dorthin. Konfiguriere deinen lokalen HTTP Server entsprechend.

Nochmal, Anleitungen hierfür findest Du auf der RBoot Webseite.

Name nicht erforderlich

Beiträge die Du hinzufügst, werden in einem für jeden zugänglichen Git Repository öffentlich aufgezeichnet. Dies betrifft ebenso den Namen sowie die email Adresse des Mitwirkenden.

Du musst bei Git keinen Autoren Namen bzw. keine email Addresse verwenden, mithilfe derer Du identifizierbar bist. Du kannst rboot Contributor verwenden und deine email Addresse könnte als contributor@rboot.org spezifiert werden. Es ist Dir gestattet dies zu tun, sofern Du deine Privatsphäre wahren möchtest. Wir glauben an Privatsphäre. Sofern Du anonym bleiben möchtest werden wir dies respektieren.

Natürlich kannst Du jeglichen Namen und/oder jegliche email Adresse verwenden die Du möchtest.

Rechtlich gesprochen, jegliches Urheberrecht fällt automatisch unter die Berner Übereinkunft zum Schutz von Werken der Literatur und Kunst. Es spielt keine Rolle welchen Namen, oder ob Du tatsächlich überhaupt ein Urheberrecht deklariert hast (aber wir setzen voraus das bestimmte Lizenzen für das Urheberrecht verwndet werden - lies mehr darüber auf dieser Seite).

Sofern Du einen anderen Namen sowie eine andere email Adresse für deine Commits/Patches verwendest dann solltest Du anonym sein. Verwende git log und git show um dies zu überprüfen bevor Du einem öffentlichen Git Repository Änderungen hinzufügst.

Lizenzen (für Mitwirkende)

Stelle sicher, dass deine Beiträge mit einer libre Lizenz frei lizensiert sind. RBoot schreibt nicht mehr vor, welche Lizenzen akzeptiert werden, und es existieren einige Lizenzen. Wir werden deinen Beitrag prüfen und dir mitteilen sofern es ein Problem damit gibt (z.B. keine Lizenz).

Gib immer eine Lizenz an für deine Arbeit! Keine Lizenz anzugeben bedeutet das deine Arbeit unter die Standard Urheberrechte fällt, was deine Arbeit proprietär macht und somit von denselben Einschränkungen betroffen ist.

Die MIT Lizenz ist ein guter Start, und sie ist die bevorzugte Lizenz für sämtliche Arbeit an RBoot, aber wir sind nicht pingelig.

Hier findest Du übliche Beispiele für Lizenzen.

Wenn deine Arbeit auf bestehender Arbeit basiert, dann ist es wichtig (für deinen Beitrag) das die Lizenz deiner Arbeit kompatibel ist mit der Lizenz der Arbeit auf der sie beruht. Die MIT Lizenz ist hierfür gut geeignet, weil sie mit vielen anderen Lizenen kompatibel ist, und Freiheit zulässt (wie zum Beispiel die Freiheit einer SubLizenz) was bei vielen anderen Lizenzen nicht der Fall ist:

https://opensource.org/licenses/MIT

Patches senden

Erstelle einen Account unter https://codeberg.org/ und navigiere (während Du eingeloggt bist) zu dem Repository das Du bearbeiten möchtest. Klicke auf Fork und Du wirst ein eigenes RBoot Repository in deinem Account erhalten. Erstelle einen Clone dieses Repository, füge alle gewünschten Änderungen hinzu und führe anschliessend einen Push in dein Repository in deinem Account auf Codeberg durch. Du kannst dies auch in einem neuen Branch erledigen, sofern Du magst.

In deinem Codeberg Account kannst Du nun zum offiziellen RBoot Repository navigieren und dort einen Pull Request erstellen. Die Art und Weise wie dies funktioniert ist vergleichbar mit anderen populären Web basierten Git Plattformen die heutzutage verwendet werden.

Du kannst dort deine Patches bereitstellen. Alternativ kannst Du dich in den RBoot IRC Kanal einloggen und dort bekannt geben welche deiner Patches geprüft werden sollen, sofern Du ein eigenes Git repository mit den Patches hast.

Sobald Du einen Pull Request erstellt hast, werden die RBoot Maintainer per email informiert. Sofern Du nicht schnell genug eine Antwort erhälst, kannst Du das Projekt ebenso mithilfe des #rboot Kanals auf Libera Chat kontaktieren.

Um den Prozess der Quelltext Überprüfung transparent zu gestalten, wird jedoch empfohlen künftig Codeberg zu verwenden.

Mirrors für rbmk.git

Das rbmk Repository enthält RBoot’s automatischess build system, welches RBoot Veröffentlichungen herstellt (inklusive kompilierter ROM Images).

Du kannst git clone für alle diese Links ausführen (die Links können auch angeklickt werden, um Änderungen in deinem Web Browser anzusehen):

rbwww.git Mirror

Das rbwww Repository enthält Markdown Dateien (Pandoc Variant), für die Verwendung mit dem RBoot Static Site Generator; dies wird von RBoot verwendet um HTML Web Seiten bereitzustellen, inklusive der Seite die Du gerade liest!

Du kannst git clone für diese Links ausführen und/oder die Links anklicken um Änderungen in deinem Web Browser anzusehen). Siehe:

rbwww-img.git Mirror

Markdown-Datei: https://rboot.org/git.de.md

Website karte

Diese HTML-Seite wurde von Rboot Static Site Generator erstellt.