Gemeinschaftliche Verwaltung

„KISS“ und Standards respektieren

„Keep it small and simple (KISS)“: befolgen Sie die besten Standards, entwerfen und schreiben Sie sorgfältig Dokumentation von hoher Qualität, erzeugen Sie ein stabiles und robustes System und halten Sie das Wurzeldateisystem rootfs in dem Direktstatrt-ISO-Abbild so klein, dass es auf Rechnern mit mindestens 128 MiB Arbeitsspeicher geladen werden kann. Dennoch ist es möglich GTK+2, Dialog, Kommandoprozeduren oder PHP-Werkzeuge in die Distribution zu übernehmen. Die Idee ist, keine Doppelarbeit zu leisten und nicht schmalspurig zu denken...

Marmite - Build-Rechner & Spiegel

Jeder Mitwirkende kann ein Konto auf dem Projekt-Server mit sicherem SSH-Zugang erhalten (nur öffentlicher Schlüssel, kein Kennwort). Marmite ist der Build-Rechner von SliTaz und beherbergt den offiziellen Paket-Spiegel: mirror.slitaz.org - Statusseite unter marmite.slitaz.org. Er ersetzt seit 2026 den historischen Server Tank.

SSH-Schlüssel & Entwicklerkonto

Konten werden von einem Administrator aus Ihrem öffentlichen SSH-Schlüssel angelegt. Erzeugen Sie auf Ihrem Rechner ein modernes ed25519-Schlüsselpaar:

 $ ssh-keygen -t ed25519 -C "sie@ihr-rechner"
 $ cat ~/.ssh/id_ed25519.pub

Unter SliTaz (dropbear):

 $ dropbearkey -t ed25519 -f ~/.ssh/id_dropbear
 $ dropbearkey -y -f ~/.ssh/id_dropbear | grep ^ssh-ed25519

Schicken Sie die einzelne Zeile ssh-ed25519 AAAA… an einen Administrator oder an die Entwicklergruppe (Mailingliste oder Forum). Der öffentliche Schlüssel darf weitergegeben werden, der private Schlüssel verlässt niemals Ihren Rechner.

Mit OpenSSH tragen Sie, sobald Ihr Konto existiert, Folgendes in Ihre ~/.ssh/config ein: Die Server sperren Clients, deren SSH-Agent zu viele Schlüssel hintereinander anbietet.

Host hg.slitaz.org marmite.slitaz.org
    User ihrlogin
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

Mit dropbear, dem Standard-ssh unter SliTaz, ist nichts zu konfigurieren: Es liest ~/.ssh/config nicht, verwendet ~/.ssh/id_dropbear von selbst, und Ihr Login steht in der URL (ssh://ihrlogin@hg.slitaz.org/...).

Mercurial-Depots

SliTaz-Mercurial- (oder Hg-) Depots können von jedem unter https://hg.slitaz.org/ angesehen und dupliziert werden. Mercurial wird installiert mit: tazpkg get-install mercurial

Seit 2026 ist der Schreibzugriff nur über SSH möglich: Das frühere Transferieren über HTTPS mit Kennwort funktioniert nicht mehr. Zum Transferieren brauchen Sie ein Entwicklerkonto und Ihren SSH-Schlüssel (siehe SSH-Schlüssel & Entwicklerkonto). Die SSH-URL eines Depots lautet:

ssh://ihrlogin@hg.slitaz.org//home/slitaz/repos/<depot>

Ersetzen Sie ihrlogin durch Ihren Kontonamen und <depot> durch den Namen des Depots (wok, website, cookutils...). Beachten Sie den doppelten Schrägstrich nach dem Rechnernamen: Der Pfad auf dem Server ist absolut.

~/.hgrc

Tragen Sie vor Ihrer ersten Änderung Ihren Namen und Ihre E-Mail-Adresse in Ihre persönliche ~/.hgrc ein, und arbeiten Sie niemals als root:

[ui]
username = Vorname Nachname <name@example.de>

Neues Duplikat: holen über HTTPS, transferieren über SSH

So arbeiten die Hauptentwickler: Das Holen bleibt schnell und anonym über HTTPS, das Transferieren geht mit Ihrem Schlüssel über SSH. Duplizieren, Beispiel für den Wok:

 $ hg clone https://hg.slitaz.org/wok

Öffnen Sie dann wok/.hg/hgrc in einem Texteditor und fügen Sie unter [paths] die Zeile default-push hinzu:

[paths]
default = https://hg.slitaz.org/wok
default-push = ssh://ihrlogin@hg.slitaz.org//home/slitaz/repos/wok

Oder duplizieren Sie direkt über SSH: Holen und Transferieren laufen dann beide über SSH, und es ist nichts hinzuzufügen:

 $ hg clone ssh://ihrlogin@hg.slitaz.org//home/slitaz/repos/wok

Vorhandenes Duplikat: Transferieren auf SSH umstellen

Ein Duplikat, das vor der Umstellung auf SSH angelegt wurde, muss nicht neu dupliziert werden. Öffnen Sie seine .hg/hgrc in einem Texteditor:

Entfernen Sie außerdem aus Ihrer ~/.hgrc jeden Abschnitt [auth] und jedes Kennwort für hg.slitaz.org: Sie werden nicht mehr verwendet.

Prüfen vor dem ersten Transfer

 $ hg paths
 $ hg outgoing

hg paths zeigt die URL zum Holen (default) und zum Transferieren (default-push). hg outgoing verbindet sich über SSH und listet die Änderungen auf, die transferiert würden, ohne etwas zu transferieren. Bei der ersten Verbindung bittet SSH Sie, den Schlüssel des Servers zu bestätigen: Antworten Sie mit yes. Lehnt der Server Ihren Schlüssel ab, sind Ihr Konto oder Ihr Schlüssel noch nicht eingerichtet: siehe SSH-Schlüssel & Entwicklerkonto.

Optional: die Abkürzung schemes

Die Erweiterung schemes gehört zu Mercurial und verkürzt die SSH-URL. Fügen Sie Ihrer ~/.hgrc hinzu:

[extensions]
schemes =

[schemes]
slitaz = ssh://ihrlogin@hg.slitaz.org//home/slitaz/repos/

slitaz://wok steht dann für die vollständige SSH-URL des Woks. Geben Sie beim Duplizieren immer das Zielverzeichnis an: Ohne dieses bricht Mercurial mit "empty destination path is not valid" ab.

 $ hg clone slitaz://wok wok

Ein solches Duplikat speichert slitaz://wok/ als URL und braucht die Erweiterung, um weiter zu funktionieren. In einem HTTPS-Duplikat funktioniert auch default-push = slitaz://wok.

Ändern, lokal übernehmen und transferieren

Wechseln Sie in das Verzeichnis wok, sonst funktionieren die hg-Kommandos nicht. Zum Anzeigen aller oder nur der letzten Änderungen:

 $ hg log
 $ hg log -l 1

Nach dem Hinzufügen oder Ändern von einer oder mehreren Dateien den Änderungsstatus anzeigen und die Änderungen lokal übernehmen:

 $ hg add
 $ hg status
 $ hg commit -m "Log message..."
 $ hg log

Mit hg rollback können Sie die letzte lokale Übernahme rückgängig machen, solange sie nicht transferiert ist. Holen Sie vor dem Transferieren immer die Änderungen der anderen:

 $ hg pull
 $ hg push

Hat inzwischen jemand anderes transferiert, meldet das Holen "run 'hg merge' to merge", und ein Transfer ohne Zusammenführen bricht mit "push creates new remote head" ab. Führen Sie zusammen, übernehmen Sie das Ergebnis und transferieren Sie dann:

 $ hg merge
 $ hg commit -m "Merge"
 $ hg push

Das ist schon alles; Ihre Änderungen, Quellprogramme oder Korrekturen sind jetzt im Depot.

Ein lokal dupliziertes Depot aktualisieren

Ein lokal dupliziertes Depot kann aus dem SliTaz-Depot aktualisiert werden mit:

 $ hg pull -u

Weitere nützliche Kommandos

Grafische Oberflächen - reines C/GTK, Yad, Vala/Genie und CGI

Es gibt viele Möglichkeiten, mit „open source“-Produkten eine Benutzeroberfläche zu erzeugen. Bis zur Version 3.0 von SliTaz haben wir hauptsächlich Gtkdialog verwendet, um gefällige und komplexe Oberflächen in GTK zu erstellen, wobei die Anweisungen ausgeführt wurden ohne übersetzt werden zu müssen. Aber gtkdialog wird nicht mehr gewartet und es fehlen viele neuere GTK-Funktionalitäten. Daher sind wir bei einfachen Grafikfenstern auf Yad umgestiegen. Bei der Verwaltung des Systems und der Pakete sowie bei den Konfigurationswerkzeugen sind wir auf TazPanel umgestiegen, eine Web-Oberfläche mit CGI-Nutzung, die mit xHTML 5 und CSS 3 programmiert wird.

Yad ist sehr einfach, kann aber keine komplexen Oberflächen erzeugen: schon zwei oder drei Einträge mit Marken und einige Schaltflächen sind nicht möglich. Daher mussten wir eine andere Möglichkeit suchen. Der Vorteil eines Interpreters ist, dass die Anweisungen nicht übersetzt werden müssen sondern zur Laufzeit verarbeitet werden, was die Anwendung allerdings verlangsamt. Programme in C zu schreiben ist komplex und daran werden sich weniger Mitwirkende beteiligen, da Kommandoprozeduren leichter zu verstehen sind. Daher lautet die Richtlinie jetzt: unsere Kommandoprozeduren beibehalten und verbessern und Benutzeroberflächen dafür in GTK oder CGI zur Verfügung stellen.

Es gibt viele neue Programmiersprachen, die GTK verwenden, z.B. Genie, Vala oder GTKaml. Beachten Sie aber, dass sie nicht so verbreitet sind wie C und GTK und nicht wirklich leichter zu erlernen und zu nutzen sind. Für einfache Grafikfenster können Sie Kommandoprozeduren benutzen. Sie können auch Vala benutzen, aber reines GTK braucht für ein einzelnes Fenster auch nur 14 Anweisungszeilen:

#include <gtk/gtk.h>

int main(int argc, char *argv[])
{
	GtkWidget *window;

	gtk_init(&argc, &argv);
	window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
	g_signal_connect (G_OBJECT (window), "destroy",
			G_CALLBACK (gtk_main_quit), NULL);

	gtk_widget_show(window);
	gtk_main();
	return 0;
}

Wenn Sie sich nicht sicher sind, welche Programmiersprache Sie verwenden sollen, können Sie Ihre Wahl bei der „Mailing“-Liste zur Diskussion stellen. Wenn Sie nur eine einfache grafische Oberfläche brauchen, können Sie sich tazbox im Depot slitaz-tools ansehen; das Paket enthält kleine Programme für die grafische Oberfläche wie z.B. ein Abmeldefenster. TazWeb ist das erste Teilprojekt von SliTaz, das in reinem GTK geschrieben wurde. Sie können es ansehen um zu lernen, wie man die Funktion system() in einer grafischen Oberfläche verwenden kann. So verwendet TazWeb beispielsweise wget zum Dateitransfer und sed um Lesezeichen hinzuzufügen.

Yad-Anweisungsprozeduren sollten die TazYad-Richtlinien befolgen: README und Programmierbeispiele

Implementierung von iconv()

SliTaz verwendet iconv() aus der GNU glibc - alle Pakete, die libiconv anbieten, müssen die Bibliothek aus glibc-locale verwenden. Daher gibt es kein Paket libiconv (1.2 MB) mehr in SliTaz.

SliTaz-Pakete erzeugen

Für die offizielle Paketerzeugung werden die Kochwerkzeuge verwendet. Diese sind in dem Paket cookutils enthalten, das in jedem SliTaz-System installiert ist, wie auch das Kochwerkzeuge-Handbuch für die Verwendung der Kochwerkzeuge. Damit werden Pakete erzeugt, die von Tazpkg verwaltet werden können.

Die Pakete werden bei SliTaz automatisch von „Cooker“ aus einem Quellpaket und einem Rezep im Wok erzeugt. Im Kochbuch ist das Format der Rezepte beschrieben. Die Beschreibung der Kochwerkzeuge und der Rezepte sollten Sie gelesen haben, bevor Sie mit der Paketerzeugung beginnen.

Bei der Auswahl eines Paketes für SliTaz sollten nur solche in Betracht kommen, die nützlich sind und funktionieren. Davon sollten Sie das kleinste verfügbare auswählen. Es sollten nicht mehrere Pakete mit gleicher Funktionalität erstellt werden. Die aktuelle Auswahl der Pakete ist aber nicht festgeschrieben. Wenn es eine Alternative zu einem Paket gibt, die noch kleiner ist, mehr Funktionen enthält oder mit ein paar KB mehr attraktiver ist, kann die Übernahme bei der „Mailing“-Liste diskutiert werden. Besondere Anforderungen werden an Pakete gestellt, die in Direktstart-ISO-Abbilder übernommen werden sollen. Bei diesen sollten Symbolinformationen aus den Objektprogrammen sowie unnötige Abhängigkeiten und Übersetzeroptionen entfernt werden. Im Allgemeinen werden solche Pakete vor der Freigabe ebenfalls bei der „Mailing“-Liste zur Diskussion gestellt.

Bevor Sie beginnen, Pakete für SliTaz zu übersetzen und erzeugen, stellen Sie zur Vermeidung von Doppelarbeit sicher, dass es etwas entsprechendes nicht schon im inoffiziellen Wok gibt. Die Mitglieder der „Mailing“-Liste geben gerne Hinweise und das Kochwerkzeuge-Handbuch sollte für Anfänger hilfreich sein.

Benennung von Paketen

In den meisten Fällen stimmt der Name des Paketes mit dem Namen des Quellpaketes überein. Ausnahmen sind Python, Perl, PHP, Ruby und Lua-Module. Beispielsweise heisst das Paket, das ein „Kid template system“, in Python und XML geschrieben, enthält: python-kid.

Verwaltung der Internetpräsenz

Die Internetpräsenz wird über das Mercurial-Depot website administriert. Dieses kann dupliziert werden mit:

 $ hg clone https://hg.slitaz.org/website

Zum Transferieren fügen Sie default-push = ssh://ihrlogin@hg.slitaz.org//home/slitaz/repos/website unter [paths] in website/.hg/hgrc hinzu, wie beim Wok (siehe Mercurial-Depots).

xHTML-Programmierstil

Die Seiten und verschiedene Handbücher sind in xHTML 1.0 transitional programmiert. Die Überschrift der Stufe 1 wird nur einmal (ganz oben) verwendet, Stufe 2 ist der Titel des Dokuments und die Stufen 3 und 4 werden für weitere Abstufungen der Überschriften benutzt. Wenn eine Liste statt „smart anchors“ verwendet wird, beginnt sie oben, direkt unterhalb einer Überschrift der Stufe 2. Absätze werden in die Markierungen <p></p> eingeschlossen. Für Einrückungen werden Tabulatoren verwendet. Dies ist in der Semantik begründet und sie benötigen weniger Speicherplatz. Zur Darstellung von Kommandonamen oder ähnlichem innerhalb eines Absatzes wird vorzugsweise <code> verwendet. Beispiele für die Anwendung von Kommandos in einem Terminal werden als formatierter Text mit <pre> ausgegeben, z.B.:

 $ command

Zur Anzeige von Text, der kopiert und eingefügt werden kann, wie etwa Kommandoprozeduren, Quellprogrammausschnitte, Konfigurationsdateien usw. wird ebenfalls <pre> verwendet, aber mit einer CSS-Klasse namens “script”. Beispiel:

<pre class="script">

code...

</pre>

Hervorgehobene Wörter erhalten das Merkmal <em> und interne Verknüpfungen sind stets relativ. Denken Sie auch daran, Ihr Programm mit dem „validator“ des W3C auf Konformität zu prüfen.

Diff und patch

Die Programme diff und patch dienen der Erstellung einer Datei, die Unterschiede zwischen zwei Dateien enthält und mit deren Hilfe die Änderungen angewendet werden können. Diese Technik wird oft angewendet, wenn mehrere Personen an einem Projekt arbeiten, damit Änderungen an einer Originaldatei klar extrahiert werden können. Um eine diff-Datei zu erstellen, die mit einem Texteditor für Menschen gut lesbar ist, muss die Option -u angegeben werden:

 $ diff -u file.orig file.new > file.diff

Zum Anbringen der Änderungen an der Originaldatei:

 $ patch file.orig file.diff