hugo python distributions
v0.140.2
| Klassifikatoren | Beschreibung |
|---|---|
| Baut | |
| Paket | |
| Meta |
Binärdateien für die extended + withdeploy Edition des Hugo-Static-Site-Generators, installierbar über pip
Dieses Projekt stellt Hugo-Räder zur Verfügung, damit es mit pip unter macOS, Linux und Windows verwendet werden kann; für Python 3.9 und höher.
Notiz
Nur die neuesten, stabilen und künftigen EOL-Python-Versionen werden regelmäßig getestet. Wenn Sie Probleme mit dem Paket in einer bestimmten Python-Version haben, können Sie gerne ein Problem eröffnen.
Hugo ist ein in Go geschriebener statischer Site-Generator. Es ist schnell und flexibel konzipiert und wird von vielen Menschen und Organisationen für ihre Websites, Dokumentationen und persönlichen Blogs verwendet.
Notiz
Diese Distribution von Hugo ist derzeit nicht mit dem offiziellen Hugo -Projekt verbunden. Weitere Informationen zu Hugo finden Sie in der Hugo-Dokumentation.
hugo -Version installiere ich? Dieses Projekt, hugo wird zusammen mit den Hugo-Releases versioniert und ist an der Versionierung von Hugo selbst ausgerichtet, das SemVer verwendet – wird aber wahrscheinlich gemäß 0ver-Softwarestandards basierend auf ihrem Versionierungsverlauf versioniert.
Binärdateien für hugo über diese Räder sind für Hugo-Versionen 0.121.2 und höher, über PyPI oder über Veröffentlichungen auf GitHub verfügbar. Wenn Sie eine ältere Version von hugo benötigen, die nicht über dieses Paket verfügbar ist, ziehen Sie bitte die Verwendung der offiziellen Hugo-Binärdateien in Betracht.
Eine Liste der für unterstützte Plattformen und Architekturen verfügbaren Räder finden Sie im Abschnitt „Unterstützte Plattformen“. Wenn dies der Fall ist, springen Sie zum Abschnitt „Schnellstart“, um zu beginnen.
Warnung
Aufgrund der Einschränkungen der auf PyPI verfügbaren Gesamtgröße für hugo stehen nur die neuesten Versionen von Hugo zum Download über pip zur Verfügung. Ältere Versionen dieser Räder werden gelöscht, um Platz für neuere Versionen zu schaffen. Wenn Sie eine ältere Version von Hugo benötigen, erwägen Sie bitte die Verwendung der Räder, die auf der GitHub-Release-Seite hochgeladen wurden, oder der offiziellen Hugo-Binärdateien. Ersteres kann über pip durch Herunterladen der .whl Datei oder über pipx unter direkter Verwendung der URL erfolgen (empfohlen). Wenn Sie beispielsweise Hugo 0.122.0 benötigen, können Sie pipx install "https://github.com/agriyakhetarpal/hugo-python-distributions/releases/download/v0.122.0/hugo-0.122.0-cp311-cp311-win_amd64.whl" ausführen pipx install "https://github.com/agriyakhetarpal/hugo-python-distributions/releases/download/v0.122.0/hugo-0.122.0-cp311-cp311-win_amd64.whl" um das Rad für Hugo 0.122.0 unter Windows für Python herunterzuladen und zu installieren 3.11.
Erstellen Sie eine virtuelle Umgebung und installieren Sie das Paket (oder installieren Sie es global auf Ihrem System):
python -m virtualenv venv # (or your preferred method of creating virtual environments)
pip install hugo Dadurch wird eine hugo -Installation mit einer ausführbaren Datei in Ihrer virtuellen Umgebung platziert und ihr ein Einstiegspunkt im bin -Verzeichnis Ihrer virtuellen Umgebung hinzugefügt. Sie können den hugo -Befehl wie gewohnt verwenden:
hugo version
hugo env --logLevel infoAlternativ können Sie das Paket auch global auf Ihrem System installieren:
python3.X -m pip install hugo # Unix
py -m pip install hugo # Windows Tipp
Es ist eine gute Idee, Hugo pipx an einem isolierten Ort zu installieren oder zu verwenden, ohne eine virtuelle Umgebung erstellen zu müssen. Dadurch können Sie Hugo als Befehlszeilentool ausführen, ohne es global auf Ihrem System installieren zu müssen. dh,
pipx install hugo # install and run Hugo through pipxoder
pipx run hugo==0.121.2 # run a specific version of Hugo through pipx, even if a different version is installed in whatever environment you are in Weitere Informationen finden Sie in der pipx -Dokumentation.
Anschließend können Sie die hugo -Befehle wie gewohnt verwenden:
hugo version
hugo env --logLevel infoUnd
hugo new site mysite
hugo --printI18nWarnings server
# and so on
... In virtuellen Standardumgebungen können mehrere Versionen von Hugo nebeneinander installiert und verwendet werden. Um eine bestimmte Hugo-Version zu verwenden, können Sie die Version bei der Installation des Pakets angeben (weitere Informationen finden Sie im Abschnitt Welche hugo -Version installiere ich? ):
pip install " hugo==0.X.Y "Weitere Informationen zur Verwendung von Hugo und seiner Befehlszeilenschnittstelle finden Sie in der Hugo-Dokumentation und der Hugo-CLI-Dokumentation.
Ein Teil der von Hugo selbst unterstützten Plattformen wird von diesen Rädern für hugo über hugo-python-distributions unterstützt. Der Plan besteht darin, möglichst viele Plattformen mit Python-Rädern und Plattform-Tags zu unterstützen. Eine Liste der unterstützten Plattformen und Architekturen finden Sie in der folgenden Tabelle:
| Plattform | Architektur | Unterstützung |
|---|---|---|
| macOS | x86_64 (Intel) | ✅ macOS 10.13 (High Sierra) und höher |
| macOS | arm64 (Silizium) | ✅ macOS 11.0 (Big Sur) und höher |
| Linux | amd64 | ✅ glibc 2.24 und höher |
| Linux | arm64 | ✅ glibc 2.24 und höher |
| Linux | s390x | ✅ glibc 2.17 und höher |
| Linux | ppc64le | ✅ glibc 2.17 und höher |
| Windows | x86_64 | ✅ |
| Windows | arm64 | ✅ Experimentelle Unterstützung 1 |
| Windows | x86 | ✅ Experimentelle Unterstützung 1 |
| DragonFlyBSD | amd64 | Erhalte keinen Support 2 |
| FreeBSD | amd64 | Erhalte keinen Support 2 |
| OpenBSD | amd64 | Erhalte keinen Support 2 |
| NetBSD | amd64 | Erhalte keinen Support 2 |
| Solaris | amd64 | Erhalte keinen Support 2 |
Für die Erstellung der erweiterten + withdeploy-Edition von Hugo aus dem Quellcode sind die folgenden Abhängigkeiten erforderlich:
Windows-Benutzer können den Chocolatey-Paketmanager verwenden, um den MinGW-Compiler zu verwenden. Führen Sie nach der Installation von Chocolatey den folgenden Befehl in einer Terminal-Eingabeaufforderung mit erhöhten Rechten aus:
choco install mingwKlonen Sie dann das Repository und führen Sie das Build-Skript aus:
git clone https://github.com/agriyakhetarpal/hugo-python-distributions@main
python -m venv venv
source venv/bin/activate # on Unix-based systems
venv S cripts a ctivate.bat # on Windows
pip install -e . # editable installation
pip install . # regular installation Notiz
Die Kreuzkompilierung ist experimentell und möglicherweise nicht für alle Anwendungsfälle stabil oder zuverlässig. Wenn bei der Cross-Kompilierung Probleme auftreten, können Sie gerne ein Problem eröffnen.
Dieses Projekt ist in der Lage, Hugo-Binärdateien für verschiedene Plattformen und Architekturen zu kompilieren und kann wie folgt verwendet werden. Cross-Compilation wird für die folgenden Plattformen bereitgestellt:
arm64 und amd64 Architekturen über die Xcode-Toolchain,arm64 , amd64 , s390x und ppc64le Architekturen über die Zig-Toolchain undamd64 , arm64 und x86 über die Zig-Toolchain.Weitere Informationen zum Cross-Kompilieren von Hugo für verschiedene Architekturen finden Sie in den folgenden Beispielen:
Sagen wir auf einem Intel-basierten (x86_64) macOS-Rechner:
export GOARCH= " arm64 "
pip install . # or pip install -e . Dadurch wird eine macOS arm64 Binärdistribution von Hugo erstellt, die auf Apple Silicon-basierten ( arm64 ) macOS-Maschinen verwendet werden kann. Um eine Binärverteilung für die Intel-basierte ( x86_64 ) macOS- Zielplattform auf dem Apple Silicon-basierten ( arm64 ) macOS- Hostcomputer zu erstellen, können Sie den folgenden Befehl verwenden:
export GOARCH= " amd64 "
pip install . # or pip install -e . Installieren Sie zunächst Zig auf Ihrem Linux-Computer und legen Sie die Umgebungsvariablen USE_ZIG , GOOS und GOARCH fest, bevor Sie das Paket installieren:
Sagen wir auf einem amd64 -Linux-Rechner:
export USE_ZIG= " 1 "
export GOOS= " linux "
export GOARCH= " arm64 "
pip install . # or pip install -e . wird eine Linux-Arm64-Binärdistribution von Hugo kreuzkompilieren, die auf den Ziel-Arm64-Linux-Maschinen verwendet werden kann. Um eine Binärverteilung für die Ziel amd64 -Linux-Plattform auf dem Host- arm64 -Linux-Computer zu erstellen, legen Sie die Ziele anders fest:
export USE_ZIG= " 1 "
export GOOS= " linux "
export GOARCH= " amd64 "
pip install . # or pip install -e . Dadurch wird eine dynamische Verknüpfung für die erstellte Hugo-Binärdatei mit einem vom System bereitgestellten GLIBC erstellt. Wenn Sie die Binärdatei statisch mit MUSL verknüpfen möchten, ändern Sie die Umgebungsvariablen CC und CXX wie folgt:
export CC= " zig cc -target x86_64-linux-musl "
export CXX= " zig c++ -target x86_64-linux-musl "Die Verknüpfung gegen MUSL wird derzeit nicht in CI getestet, sollte aber theoretisch funktionieren. Die offiziellen Hugo-Binärdateien sind aus verschiedenen Gründen nicht mit MUSL verknüpft, unter anderem aufgrund der Größe der Binärdatei und der Beliebtheit der GLIBC-C-Standardbibliothek und ihrer Konventionen.
Installieren Sie zunächst Zig auf Ihrem Windows-Computer und legen Sie diese Umgebungsvariablen fest, bevor Sie das Paket installieren:
Sagen wir auf einem amd64 Windows-Rechner:
set USE_ZIG= " 1 "
set GOOS= " windows "
set GOARCH= " arm64 "
pip install . # or pip install -e . kompiliert eine Windows arm64 Binärdistribution von Hugo, die auf den Ziel arm64 -Windows-Rechnern verwendet werden kann (beachten Sie die Verwendung von set anstelle von export unter Windows) und so weiter für die x86 -Architektur:
set USE_ZIG= " 1 "
set GOOS= " windows "
set GOARCH= " 386 "
pip install . # or pip install -e . Um eine Liste der unterstützten Distributionen für Go zu erhalten, führen Sie bitte den Befehl go tool dist list auf Ihrem System aus. Eine Liste der unterstützten Ziele für Zig finden Sie in der Zig-Dokumentation für weitere Informationen oder führen Sie den Befehl zig targets auf Ihrem System aus.
Tipp
Eine übergreifende Kompilierung für eine Zielplattform und -architektur von einer anderen Hostplattform und -architektur ist ebenfalls möglich, ist jedoch derzeit noch weitgehend ungetestet. Derzeit ist bekannt, dass die Zig-Compiler-Toolchain für die plattform- und architekturübergreifende Kompilierung geeignet ist.
Binärdateien für den Hugo-Static-Site-Generator stehen auf der Hugo-Release-Seite zum Download bereit. Diese Binärdateien müssen heruntergeladen und manuell an einem geeigneten Speicherort im System abgelegt werden. Außerdem muss die Umgebungsvariable PATH aktualisiert werden, um diesen Speicherort einzuschließen.
Dieses Projekt stellt Räder für Hugo bereit, die mit pip unter macOS, Linux und Windows verwendet werden können. Dadurch kann Hugo in einer virtuellen Umgebung installiert und verwendet werden, wodurch mehrere Versionen von Hugo nebeneinander in verschiedenen virtuellen Umgebungen installiert und verwendet werden können, wobei Hugo als Befehlszeilentool (eine Python-API) verwendet werden kann derzeit nicht bereitgestellt, da keine entsprechende Nachfrage besteht).
Dieses Projekt ist für den Einsatz in den folgenden Szenarien konzipiert:
pip install --upgrade hugo . Außerdem sind automatische Updates möglich, wenn Sie einen Paketmanager wie Poetry oder PDM zum Verwalten Ihrer Python-Abhängigkeiten oder ein Tool wie pipx zum Verwalten verwenden Ihre BefehlszeilentoolsDieses Projekt ist unter den Bedingungen der Apache 2.0-Lizenz lizenziert. Hugo ist auch unter Apache 2.0 verfügbar (siehe Hugo-Lizenz).
Weitere Informationen finden Sie in der Sicherheitsrichtlinie für dieses Projekt.
Ziel dieses Repositoriums ist es, dem Hugo-Projekt bei seinem Bestreben zu folgen, allen Mitwirkenden unabhängig von ihrem Hintergrund und ihrer Identität ein einladendes und integratives Umfeld zu bieten. Weitere Informationen, die für alle Interaktionen in diesem Repository und den damit verbundenen Bereichen gelten, finden Sie im Verhaltenskodex. Die Richtlinien basieren auf dem Contributor Covenant und entsprechen der Version 2.1.
Wenn Sie Hilfe anfordern, Fehler melden oder Funktionen anfordern möchten, die sich speziell auf die Funktionen von Hugo beziehen, besuchen Sie bitte das Hugo Discourse-Forum. Wenn Sie Hilfe für hugo-python-distributions anfordern möchten, können Sie gerne ein Problem in diesem Repository eröffnen.
Hugo -Pakets auf PyPI (@nariman) einen Dank für die freundliche Geste aussprechen, mit der er den Zugriff auf den Paketnamen mit den zugrunde liegenden Bestimmungen von PEP 541 gewährt hat Auf diese Weise können Benutzer das Paket unter demselben Namen wie das offizielle Hugo-Projekt installieren, was den Benutzern dieses Pakets zweifellos eine bessere Benutzererfahrung und Bequemlichkeit im Vergleich zum vorherigen Paketnamen bietet. python-hugo . Die Unterstützung für 32-Bit- (i686) und ARM64-Architekturen unter Windows wird durch die Verwendung der Zig-Compiler-Toolchain ermöglicht, die das LLVM-Ökosystem nutzt. Diese Räder sind aufgrund der Verwendung von Cross-Compilation experimentell und möglicherweise nicht für alle Anwendungsfälle stabil oder zuverlässig und werden derzeit vom Hugo-Projekt nicht offiziell unterstützt. Obwohl diese zur allgemeinen Verfügbarkeit auf PyPI veröffentlicht werden, gelten sie daher als experimentell. Weitere Informationen zum lokalen Erstellen von Hugo für diese Plattformen und Architekturen finden Sie im Abschnitt „Erstellen aus dem Quellcode“. Wenn Sie offiziellen Support für diese Plattformen benötigen oder auf Fehler stoßen, wenden Sie sich bitte über [https://github.com/gohugoio/hugo/issues/new] (Eröffnung eines Problems) an die Hugo-Autoren. ↩ ↩ 2
Die Unterstützung dieser Plattformen ist aus folgenden Gründen nicht möglich: der Mangel an Ressourcen zum Testen und Erstellen für sie und ii. die mangelnde Unterstützung dieser Plattformspezifikationen in Python-Paketstandards und -Tools. Wenn Sie Unterstützung für diese Plattformen benötigen, denken Sie bitte darüber nach, die offiziellen Hugo-Binärdateien für ihre nicht erweiterten Editionen herunterzuladen. ↩ ↩ 2 ↩ 3 ↩ 4 ↩ 5
