Das GitHub-Repository anlegen #

Diese Seite ist für Designer, die ein Theme auf ihrem Rechner unter Git haben und es auf GitHub bringen wollen. Andere Git-Hosts funktionieren ganz ähnlich; die Befehle unten verwenden die GitHub-Kommandozeile gh.

Bevor Sie beginnen #

• Das Theme ist ein Git-Repository, dessen Wurzel der Erweiterungsordner ist (Ein Theme unter Git stellen).
• gh auth status meldet, dass Sie bei github.com angemeldet sind.
• LICENSE und README.md sind committet.

Schritt für Schritt mit gh #

1. Legen Sie im Ordner des Themes das Repository an und pushen Sie in einem Zug:

   gh repo create yourvendor/mytheme --public --source . --remote origin --push \
       --description "A responsive theme for Exponential 6 sites"

   Erwartet: die URL des Repositorys, dann die Ausgabe des Pushs.

2. Setzen Sie Website und Topics (siehe Repository-Name, Beschreibung und Topics):

   gh repo edit yourvendor/mytheme --homepage https://packagist.org/packages/yourvendor/mytheme \
       --add-topic exponential --add-topic theme --add-topic responsive-design

3. Prüfen Sie, was GitHub erkannt hat:

   gh repo view yourvendor/mytheme --json licenseInfo,hasIssuesEnabled,homepageUrl

   Erwartet: Ihre Lizenz (für die GPL Version 2 meldet GitHub GPL-2.0), aktivierte Issues, die Homepage.

Im Browser #

1. Auf github.com New repository: Eigentümer, Name (der Name der Erweiterung), Beschreibung, Public. Lassen Sie GitHub kein README und keine Lizenz hinzufügen; Sie haben beides schon.

2. Kopieren Sie die URL des Repositorys und verbinden Sie Ihr lokales Repository:

   git remote add origin https://github.com/yourvendor/mytheme.git
   git push -u origin main

3. Prüfen Sie unter Settings, dass Issues eingeschaltet ist; fügen Sie über das Zahnrad in der Seitenleiste Website und Topics hinzu.

Bewährte Praxis #

• Verwenden Sie für ein Theme, das ein Team oder eine Firma betreut, ein Organisationskonto, damit es nicht von einer Person abhängt.
• Schalten Sie für jedes Konto mit Schreibzugriff die Zwei-Faktor-Authentifizierung ein.
• Fügen Sie vor dem ersten Release SECURITY.md hinzu (Eine Sicherheitsrichtlinie für ein Theme).

Verwandte Seiten #

• Der erste Push und der Standard-Branch
• Mit Git entwickeln
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.