microsounds.github.io

Validierung

Diese Site zielt auf Polyglot-HTML5- Konformität, eine robuste wohlgeformte Untergruppe von HTML5 und XHTML, wie von W3C definiert und für die strengere Syntax-Validierung definiert. Dies wird manchmal als XHTML5 bezeichnet.

Dokumente sollten in den letzten 2 relevanten Webbrowsern, Chrom und Firefox als text/html oder application/xhtml+xml identisch gerendert werden. In der Praxis werden die Browser auf Chrombasis das Stylesheet auf Webseiten, die als XHTML dienen, zuletzt auf jeder Seite, die das Caching des Browsers nicht zu beheben scheint, eine nicht styierte Seite unterblitzt. Ich habe das schon eine Weile nicht mehr bemerkt.

Sie können dies selbst über busybox httpd oder den XHTML -Proxy von Schneegan überprüfen. Die Verwendung moderner Merkmale wie audio verhindert die Validierung als "echte" xhtml 1.0 streng.

Beachten Sie, dass einige visuelle Effekte in mobilen Browsern aus Leistungsgründen deaktiviert sind . Firefox hängt vollständig, wenn Sie SVG feTurbulance über CSS verwenden.

Bereitstellung

Normalerweise leite ich kagami und verpflichte Build -Artefakte im master .

• Verwenden Sie etwas Einfaches wie busybox httpd im Dokument -Root, um Änderungen vor dem Drücken anzunehmen.
• Sie können auch unset DOC_ROOT in .kagami/macros ausgeben, wenn Sie nur für die lokale Anzeige erstellen möchten.
  • AJAX -Anrufe zu file:// URIS scheitert stillschweigend aufgrund von CORS -Beschränkungen in modernen Webbrowsern.

NOTIZ
Dieser Teil wird nicht auf dem neuesten Stand gehalten.

Skripte in .kagami/macros und .scripts/ haben harte Abhängigkeiten von meiner hier befindlichen Userland -Umgebung und arbeiten unter der Annahme, dass Sie ich und Sie (ich) eine Kopie aller meiner Dotfiles haben, die in Ihrem $HOME sitzen

• Einige Beispiele sind:
  • .kagami/macros erwartet meine ~/.local/lib/moonphase-date -Zeitstempelkonvertierungsroutinen, erfordert GNU- date , bc
  • .scripts/dotfiles-ls.sh erwartet, dass jede einzelne Datei in meiner Userland-Umgebung notes/dotfiles.md ordnungsgemäß erstellt.md
  • wget .scripts/unreachable.sh list-files
  • .scripts/fetch-figure-pics.sh erwartet, dass wget über myFigureCollection.net spinnen wird, um zerfuhrfeste Links zu reparieren.

Externe Build -Prozesse, die auf dieses Repo drängen

Ein Aktions -Workflow von My Userland Environment Repo wird bei jedem Push- und einem Cron -Job -Timer ausgelöst, der eine vereinfachte Version für das nachstehend beschriebene CI/CD -Verhalten ausführt, sowohl als Nebeneffekt beim Testen meiner Dotfile auf jeder Revision als auch als bequeme Weise dynamisch aktualisierte statische Webseiten zu haben.

Auf CI/CD -automatisierten Seitenbauten

Wenn Ihr Plan GitHub -Seiten mit Ihrem eigenen statischen Site -Generator verwenden soll, können Sie nur den Quellcode im master aufbewahren und automatisch push -f , ähnlich wie Github für Seiten mit Jekylll.

Wenn Sie vermeiden möchten, dass Ihre Commit-Geschichte mit CI-Commits aus Ihrem Konto übereinstimmt, verwenden Sie den git Benutzernamen des github-action Bot github-actions und eine E-Mail-Adresse [email protected] bei der Verpflichtung.

Sich zu einem anderen Repo verpflichten

Der Standard-pro-Run-GitHub-Aktionen Token ${{ secrets.GITHUB_TOKEN }} erlaubt Ihnen nicht, neue Commits zu einem anderen Repo zu drücken, den Sie kontrollieren.

Für GitHub -Seiten erfordert dies eine persönliche Zugangs -Token mit mindestens public_repo Berechtigungen und das Hinzufügen zu den Geheimnissen Ihres Repos.

• Generieren Sie eine Pat bei Settings > Developer settings > Personal access tokens

• Ein Beispiel -Workflow, der dieses automatisierte Build -Verhalten darstellt, finden Sie hier .