Gemeinschaftliche Verwaltung
- „KISS“ und Standards respektieren.
- Build-Rechner & Spiegel.
- SSH-Schlüssel & Entwicklerkonto.
- Mercurial-Depots.
- Grafische Oberflächen in GTK und CGI
- Implementierung von iconv().
- SliTaz-Pakete erzeugen.
- Verwaltung der Internetpräsenz.
„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:
- behalten Sie die Zeile
default: Das Holen überhttp://oderhttps://funktioniert weiterhin; - enthält sie Login und Kennwort
(
https://login:kennwort@hg.slitaz.org/wok), entfernen Sie diese; - fügen Sie die oben gezeigte Zeile
default-pushmit dem Namen des Depots hinzu.
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
hg help: Zeigt alle möglichen Kommandos.hg rollback: Die letzte lokale Übernahme oder das letzte Holen rückgängig machen (niemals einen Transfer).hg log <package>: Das Änderungsprotokoll eines Paketes zeigen.hg log -l 1: Die letzte Änderung anzeigen.hg paths: Die URLs zum Holen und Transferieren anzeigen.
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