Die μEdition publizieren

Wenn die μEdition in einem Zustand ist, in dem sie publizert werden kann, dann generiert folgender Befehl eine publizierbare Version:

$ hatch run build

Die μEdition generiert dann die Webinhalte in das konfigurierte Ausgabeverzeichnis (Standardmäßig das Verzeichnis site). Der Inhalt kann dann auf eine beliebige Hostinglösung kopiert werden und ist dann öffentlich Verfügbar.

Auf GitHub Pages publizieren

Die μEdition kommt standardmäßig mit Unterstützung um die μEdition über GitHub Pages zu publizieren. Damit das funktioniert müssen folgende Vorraussetzungen erfüllt werden:

• Die μEdition muss ein Git Repository nutzen.

• Ein Benutzerkonto auf GitHub muss verfügbar sein.

• Ein Repository muss auf GitHub konfiguriert sein und die μEdition muss in dieses Repository gepushed werden.

Danach in GitHub in dem Repository in den Bereich Settings navigieren und dann zu Pages. Auf der Pages Seite muss unter der Überschrift Build and deployment die Source Auswahl auf „GitHub Actions“ gesetzt sein.

Um die μEdition manuell zu publizieren, in GitHub im Respository auf Actions navigieren und dort links den Publish the site Workflow auswählen. Dieser Workflow kann manuell getriggered werden. Dazu auf den Run workflow Knopf klicken und dann auf den grünen Run workflow Knopf im Popup klicken. Dies startet den Publikationsvorgang und wenn der Workflow abgeschlossen ist, can die μEdition unter der URL, die unter Settings > Pages angezeigt wird, aufgerufen werden.

Der Workflow ist auch so konfiguriert, dass die μEdition automatisch publiziert wird, sobald eine Änderung im primären Branch erfolgt.