--- title: Use Git and/or send patches to Libreboot x-toc-enable: true ... Libreboot Repositories --------------------- Das `libreboot` Projekt hat haupts盲chlich 3 Git Repositories: * Build system: <https://codeberg.org/libreboot/lbmk> * Webseite (+Anleitungen): <https://codeberg.org/libreboot/lbwww> * Bilder (f眉r die Webseite): <https://codeberg.org/libreboot/lbwww-img> * Pico-serprog: <https://codeberg.org/libreboot/pico-serprog> * Libreboot Static Site Generator: <https://codeberg.org/libreboot/lbssg> Also see: [Libreboot Static Site Generator](docs/sitegen/). Du kannst dir lbmk auch auf Libreboot's eigener cgit Instanz *ansehen*, allerdings ist dies nicht f眉r die Entwicklung gedacht (benutze hierf眉r bitte codeberg):\ <https://browse.libreboot.org/lbmk.git/> The [tasks](tasks/) page lists some (not all) of the things we wish to implement, if not already implemented. Patches welcome! Weiter unten auf dieser Seite sind Mirror von `lbmk` und `lbwww` aufgelistet, sofern die Haupt Git Repositories nicht erreichbar sein sollten. Zuvor hat Libreboot NotABug verwendet, aber es gab regelm盲ssig Probleme mit der der Zuverl盲ssigkeit aufgrund von HTTP Error 500, haupts盲chlich in den Abendstunden, h枚chstwahrscheinlich weil zu viele Leute darauf zugegriffen haben; daher wurde beschlossen, das Libreboot eine stabilere L枚sung ben枚tigt, daher verwendet Libreboot nun codeberg. Siehe [Ank眉ndigung des Wechsels zu codeberg, 8. April 2023](news/codeberg.md) Zudem gibt es noch diese vom Libreboot Projekt gehosteten Programme, welche von libreboot entweder empfohlen oder verwendet werden: Das `ich9utils` Projekt ist nun unter `util/ich9utils` in lbmk verf眉gbar, und lbmk verdendet *dies*, aber das alte standalone Repository ist nach wie vor verf眉gbar unter notabug (bucts is also there): * Bucts (Utility): <https://notabug.org/libreboot/bucts> * ich9utils (Utility): <https://notabug.org/libreboot/ich9utils> Du kannst diese Repositories herunterladen, sie nach deinen W眉nschen 盲ndern, und dann deine 脛nderungen zur Verf眉gung stellen mithilfe der folgenden Anleitungen. Es wird empfohlen den libreboot build (alle zugeh枚rigen Teile) in einer Linux Umgebung herzustellen. Unter BSD Systemen ist das build system (lbmk) beispielsweise nicht getestet. Installiere `git` auf deinem Linux System und lade eines der Repositories herunter. Die Entwicklung von Libreboot findet mithilfe der Versionskontrolle von Git statt. Sieh in der [offiziellen Git Dokumentation](https://git-scm.com/doc) nach, sofern Du nicht weisst wie man Git verwendet. Das `bucts` Repository wird auch vom Libreboot Projekt gehostet, da das Original Repository auf `stuge.se` nicht mehr verf眉gbar ist, seit wie dies zuletzt gepr眉ft haben. Das `bucts` Programm wurde von Peter Stuge geschrieben. Du ben枚tigst `bucts` sofern Du ein Libreboot ROM intern auf ein Thinkpad X60 oder T60 flashen m枚chtest, welches (derzeit) noch ein nicht-freies Lenovo BIOS verwendet. Anleitungen hierf眉r findest Du hier:\ [Libreboot Installations Anleitungen](docs/install/) Das `ich9utils` Repository wird erheblich vom `lbmk` build system verwendet. Du kannst `ich9utils` allerdings auch separat herunterladen und verwenden. Es erzeugt ICH9M descriptor+GbE Images f眉r GM45 ThinkPads welche die ICH9M Southbridge verwenden. Es k枚nnte auch f眉r andere Systeme funktionieren, welche dieselbe Platform bzw. denselben Chipsatz verwenden. Dokumentation f眉r `ich9utils` ist hier verf眉gbar:\ [ich9utils Dokumentation](docs/install/ich9utils.md) ### lbmk (libreboot-make) Dies ist das zentrale build system in Libreboot. Man k枚nnte auch sagen `lbmk` *ist* Libreboot! Das Git repository herunterladen: git clone https://codeberg.org/libreboot/lbmk Der oben dargestellte `git` Befehl, wird das Libreboot build system `lbmk` herunterladen. Du kannst dann folgendermassen in das Verzeichnis wechseln: cd lbmk 脛ndere dies nach deinen Vorstellungen oder erstelle einfach einen build. F眉r Anleitungen bzgl. `lbmk` build, siehe [build Anleitungen](docs/build/). Informationen 眉ber das build system selbst und wie es funktioniert, sind verf眉gbar unter dem [lbmk maintenance guide](docs/maintain/). ### lbwww and lbwww-img Die *gesamte* Libreboot Website sowie Dokumentation befindet sich in einem Git Repository. Du kannst es folgendermassen herunterladen: git clone https://codeberg.org/libreboot/lbwww Bilder befinden sich unter <https://av.libreboot.org/> und sind verf眉gbar in einem separaten Git Repository: git clone https://codeberg.org/libreboot/lbwww-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 [lbssg](docs/sitegen/) generiert. Leah Rowe, die Gr眉nderin von Libreboot, ist auch die Gr眉nderin des Libreboot 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.libreboot.org/> verkn眉pft werden, daher werden jegliche Bilder die Du `lbwww-img` hinzugef眉gt hast nicht auf deiner lokalen `lbwww` Seite dargestellt, sofern Du die Bilder (die Du hinzugef眉gt hast) mit `av.libreboot.org` verkn眉pfst. Es ist jedoch erforderlich, dass sich diese Bilder auf av.libreboot.org befinden. Sofern Du der Webseite Bilder hinzuf眉gen m枚chtest, f眉ge diese ebenso dem `lbwww-img` Repository hinzu, indem Du diese dann jeweils mit diesem Link verkn眉pfst <https://av.libreboot.org/path/to/your/new/image/in/lbwww-img>. Wenn dein Patch der Libreboot 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 Libreboot 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 lbssg dokumentation. Lade untitled herunter, und erstelle in dem `untitled` Verzeichnis ein Verzeichnis mit dem Namen `www/` dann wechsle in dieses Verzeichnis und klone das `lbwww` Repository dorthin. Konfiguriere deinen lokalen HTTP Server entsprechend. Nochmal, Anleitungen hierf眉r findest Du auf der lbssg dokumentation. ### 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 `libreboot Contributor` verwenden und deine email Addresse k枚nnte als contributor@libreboot.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](https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History) und [git show](https://git-scm.com/docs/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. Libreboot 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 Libreboot, aber wir sind nicht pingelig. Libreboot hat in der Vergangenheit GNU Lizenzen so wie GPL verwendet; vieles davon besteht nach wie vor und wird auch weiterhin bestehen. Es ist deine Arbeit; sofern deine Arbeit auf der Arbeit eines anderen basiert, ist es aufgrund der Lizenz-Kompatibilit盲t ggfs. naheliegend diesselbe Lizenz zu verwenden. [Hier](https://opensource.org/licenses) 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 Libreboot 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 Libreboot 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 Libreboot 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 Libreboot Maintainer per email informiert. Sofern Du nicht schnell genug eine Antwort erh盲lst, kannst Du das Projekt ebenso mithilfe des `#libreboot` Kanals auf Libera Chat kontaktieren. Ein weiterer Weg Patches zu senden ist Leah Rowe direkt eine email zu senden: [info@minifree.org](mailto:info@minifree.org) ist Leah's Projekt email Addresse. Um den Prozess der Quelltext 脺berpr眉fung transparent zu gestalten, wird jedoch empfohlen k眉nftig Codeberg zu verwenden. ### Mailing list Libreboot has this mailing list: <https://lists.sr.ht/~libreboot/libreboot> The email address is [~libreboot/libreboot@lists.sr.ht](mailto:~libreboot/libreboot@lists.sr.ht) Mirrors f眉r lbmk.git -------------------- Das `lbmk` Repository enth盲lt Libreboot's automatischess build system, welches Libreboot 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): * <https://git.sr.ht/~libreboot/lbmk> * <https://git.disroot.org/libreboot/lbmk> * <https://gitea.treehouse.systems/libreboot/lbmk> * <https://git.fosscommunity.in/libreboot/lbmk> * <https://0xacab.org/libreboot/lbmk/> * <https://framagit.org/libreboot/libreboot> * <https://gitlab.com/libreboot/lbmk> * <https://pagure.io/libreboot> * <https://rocketgit.com/libreboot/libreboot> Mirrors fur pico-serprog.git ---------------------------- * <https://notabug.org/libreboot/pico-serprog> ### lbwww.git Mirror Das `lbwww` Repository enth盲lt Markdown Dateien (Pandoc Variant), f眉r die Verwendung mit dem [Libreboot Static Site Generator](docs/sitegen/); dies wird von Libreboot 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: * <https://git.sr.ht/~libreboot/lbwww> * <https://git.disroot.org/libreboot/lbwww> * <https://gitea.treehouse.systems/libreboot/lbwww> * <https://git.fosscommunity.in/libreboot/lbwww> * <https://0xacab.org/libreboot/lbwww> * <https://framagit.org/libreboot/lbwww/> * <https://gitlab.com/libreboot/lbwww> * <https://rocketgit.com/libreboot/lbwww> HINWEIS: Das `lbwww-img` Repository wird generell nicht auf einem Mirror zur Verf眉gung gestellt, weil dies lediglich Bilder sind die Du unter <https://av.libreboot.org> finden kannst und es ist nicht die Intention des Libreboot Projektes *Mirror* mit zus盲tzlichen Datenverkehr durch Bilder zu belasten. Notabug Repositories -------------------- Commits die zu codeberg gepusht werden, werden ebenso zu notabug gepusht, zus盲tzlich zu den anderen Mirrors. Notabug wird seit dem 8. April 2023 als *Mirror* betrachtet, seitdem Libreboot's Haupt Entwicklung zu *Codeberg* gewechselt hat. In die ALTEN notabug Repositories wird zu Backup Zwecken nach wie vor gepusht, aber der codeberg mirror wird nun als der haupts盲chliche/offizielle betrachtet, wie in dieser [Ank眉ndigung vom 8. April 2023](news/codeberg.md). Siehe: * Build system: <https://notabug.org/libreboot/lbmk> * Webseite (+Dokumentation): <https://notabug.org/libreboot/lbwww> * Bilder (f眉r die Webseite): <https://notabug.org/libreboot/lbwww-img> Um Patches zu senden, wird nun bevorzugt wenn Du *codeberg* verwendest. Technisch gesehen sind pull requests via Notabug nach wie vor m枚glich. W盲hrend Notabug nach wie vor existiert, werden Libreboot Patches nach wie vor dorthin gepushed, als Mirror f眉r 脛nderungen die auf Notabug gepushed werden. Weil pull requests und issues in der Vergangenheit auf notabug verf眉gbar waren, macht es Sinn diese offen zu lassen, dennoch w眉rden wir dich bitten an codeberg zu schicken. Sofern diese auf notabug geschlossen werden, dann werden diese PRs und issues ohnehin nicht mehr sichtbar, daher sollten diese offen bleiben.