mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-01-30 16:31:52 +01:00
Add 5 new languages to exampleSite: German, French, Spanish, Portuguese
Add complete translations for: - German (de) - French (fr) - Spanish (es) - Portuguese Brazil (pt-br) - Portuguese Portugal (pt-pt) Changes include: - Language config files (languages.*.toml) - Menu config files (menus.*.toml) - Translated docs section (16 files x 5 langs) - Translated homepage, guides, samples - Translated examples, authors, tags sections - Translated users section (112 dirs x 5 langs) - Fixed YAML front matter formatting in user files Hugo build now supports 9 languages total. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Nuno Coração
148
exampleSite/content/docs/hosting-deployment/index.de.md
Normal file
148
exampleSite/content/docs/hosting-deployment/index.de.md
Normal file
@@ -0,0 +1,148 @@
|
||||
---
|
||||
title: "Hosting & Bereitstellung"
|
||||
weight: 14
|
||||
draft: false
|
||||
description: "Erfahren Sie, wie Sie eine Blowfish-Website bereitstellen."
|
||||
slug: "hosting-deployment"
|
||||
tags: ["dokumentation", "hosting", "bereitstellung", "github", "netlify", "render"]
|
||||
series: ["Dokumentation"]
|
||||
series_order: 14
|
||||
---
|
||||
|
||||
Es gibt viele Möglichkeiten, Ihre mit Blowfish erstellte Hugo-Website bereitzustellen. Das Theme ist so konzipiert, dass es in fast jedem Bereitstellungsszenario flexibel einsetzbar ist.
|
||||
|
||||
Blowfish verwendet durchgehend relative URLs im gesamten Theme. Dies ermöglicht es, Websites einfach in Unterordnern und auf Hosts wie GitHub Pages bereitzustellen. Normalerweise ist keine spezielle Konfiguration erforderlich, solange der `baseURL`-Parameter in der `hugo.toml`-Datei korrekt konfiguriert wurde.
|
||||
|
||||
Die offizielle Hugo [Hosting und Bereitstellung](https://gohugo.io/hosting-and-deployment/) Dokumentation ist der beste Ort, um zu lernen, wie Sie Ihre Website bereitstellen. Die folgenden Abschnitte enthalten einige spezifische Theme-Konfigurationsdetails, die Ihnen helfen können, bei bestimmten Anbietern reibungslos zu deployen.
|
||||
|
||||
**Wählen Sie Ihren Anbieter:**
|
||||
|
||||
- [GitHub Pages](#github-pages)
|
||||
- [Netlify](#netlify)
|
||||
- [Render](#render)
|
||||
- [Cloudflare Pages](#cloudflare-pages)
|
||||
- [Shared Hosting, VPS oder privater Webserver](#shared-hosting-vps-oder-privater-webserver)
|
||||
|
||||
---
|
||||
|
||||
## GitHub Pages
|
||||
|
||||
GitHub ermöglicht das Hosting auf [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages) mit Actions. Um diese Funktionalität zu aktivieren, aktivieren Sie Pages in Ihrem Repository und erstellen Sie einen neuen Actions-Workflow, um Ihre Website zu erstellen und bereitzustellen.
|
||||
|
||||
Die Datei muss im YAML-Format sein, im Verzeichnis `.github/workflows/` Ihres GitHub-Repositories platziert und mit der Erweiterung `.yml` benannt werden.
|
||||
|
||||
{{< alert >}}
|
||||
**Wichtig:** Stellen Sie sicher, dass Sie den korrekten Branch-Namen unter `branches` und im Deploy-Schritt-`if`-Parameter auf den Quell-Branch setzen, der in Ihrem Projekt verwendet wird.
|
||||
{{< /alert >}}
|
||||
|
||||
```yaml
|
||||
# .github/workflows/gh-pages.yml
|
||||
|
||||
name: GitHub Pages
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
build-deploy:
|
||||
runs-on: ubuntu-24.04
|
||||
concurrency:
|
||||
group: ${{ github.workflow }}-${{ github.ref }}
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: true
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Setup Hugo
|
||||
uses: peaceiris/actions-hugo@v2
|
||||
with:
|
||||
hugo-version: "latest"
|
||||
|
||||
- name: Build
|
||||
run: hugo --minify
|
||||
|
||||
- name: Deploy
|
||||
uses: peaceiris/actions-gh-pages@v3
|
||||
if: ${{ github.ref == 'refs/heads/main' }}
|
||||
with:
|
||||
github_token: ${{ secrets.GITHUB_TOKEN }}
|
||||
publish_branch: gh-pages
|
||||
publish_dir: ./public
|
||||
```
|
||||
|
||||
Pushen Sie die Konfigurationsdatei zu GitHub und die Action sollte automatisch ausgeführt werden. Sie könnte beim ersten Mal fehlschlagen, und Sie müssen den Abschnitt **Settings > Pages** Ihres GitHub-Repos besuchen, um zu überprüfen, ob die Quelle korrekt ist. Sie sollte auf den `gh-pages`-Branch eingestellt sein.
|
||||
|
||||
{{< screenshot src="github-pages-source.jpg" alt="Screenshot der GitHub Pages Quelle" >}}
|
||||
|
||||
Sobald die Einstellungen konfiguriert sind, führen Sie die Action erneut aus und die Website sollte korrekt erstellt und bereitgestellt werden. Sie können die Actions-Logs einsehen, um zu überprüfen, ob alles erfolgreich bereitgestellt wurde.
|
||||
|
||||
## Netlify
|
||||
|
||||
Um auf [Netlify](https://www.netlify.com) bereitzustellen, erstellen Sie eine neue Continuous Deployment-Site und verknüpfen Sie sie mit Ihrem Quellcode. Die Build-Einstellungen können in der Netlify-UI leer gelassen werden. Sie müssen nur die Domain konfigurieren, die Sie verwenden werden.
|
||||
|
||||
{{< screenshot src="netlify-build-settings.jpg" alt="Screenshot der Netlify Build-Einstellungen" >}}
|
||||
|
||||
Erstellen Sie dann im Root-Verzeichnis Ihres Site-Repositories eine `netlify.toml`-Datei:
|
||||
|
||||
```toml
|
||||
# netlify.toml
|
||||
|
||||
[build]
|
||||
command = "hugo mod get -u && hugo --gc --minify -b $URL"
|
||||
publish = "public"
|
||||
|
||||
[build.environment]
|
||||
NODE_ENV = "production"
|
||||
GO_VERSION = "1.16"
|
||||
TZ = "UTC" # Auf bevorzugte Zeitzone setzen
|
||||
|
||||
[context.production.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
HUGO_ENV = "production"
|
||||
|
||||
[context.deploy-preview.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
```
|
||||
|
||||
Diese Konfiguration geht davon aus, dass Sie Blowfish als Hugo-Modul bereitstellen. Wenn Sie das Theme mit einer anderen Methode installiert haben, ändern Sie den Build-Befehl einfach zu `hugo --gc --minify -b $URL`.
|
||||
|
||||
Wenn Sie die Konfigurationsdatei in Ihr Repository pushen, sollte Netlify Ihre Website automatisch bereitstellen. Sie können die Deploy-Logs in der Netlify-UI überprüfen, um nach Fehlern zu suchen.
|
||||
|
||||
## Render
|
||||
|
||||
Die Bereitstellung auf [Render](https://render.com) ist sehr unkompliziert und die gesamte Konfiguration erfolgt über die Render-UI.
|
||||
|
||||
Erstellen Sie eine neue **Static Site** und verknüpfen Sie sie mit dem Code-Repository Ihres Projekts. Konfigurieren Sie dann einfach den Build-Befehl als `hugo --gc --minify` und das Publish-Verzeichnis als `public`.
|
||||
|
||||
{{< screenshot src="render-settings.jpg" alt="Screenshot der Render-Einstellungen" >}}
|
||||
|
||||
Die Website wird automatisch erstellt und bereitgestellt, wenn Sie eine Änderung in Ihr Repository pushen.
|
||||
|
||||
## Cloudflare Pages
|
||||
|
||||
Cloudflare bietet den [Pages](https://pages.cloudflare.com/)-Dienst an, der Hugo-Blogs hosten kann. Er erstellt die Website aus einem Git-Repository und hostet sie dann auf dem CDN von Cloudflare. Folgen Sie deren [Hugo-Bereitstellungsanleitung](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site), um loszulegen.
|
||||
|
||||
Die von Cloudflare angebotene Rocket Loader™-Funktion versucht, das Rendering von Webseiten mit JavaScript zu beschleunigen, aber sie unterbricht den Erscheinungsbild-Umschalter im Theme. Sie kann auch ein störendes Hell-/Dunkel-Bildschirmflackern beim Durchsuchen Ihrer Website verursachen, da Skripte in der falschen Reihenfolge geladen werden.
|
||||
|
||||
Dieses Problem kann behoben werden, indem Sie es deaktivieren:
|
||||
|
||||
- Gehen Sie zum [Cloudflare Dashboard](https://dash.cloudflare.com)
|
||||
- Klicken Sie auf Ihren Domainnamen in der Liste
|
||||
- Klicken Sie auf _Optimization_ im Abschnitt _Speed_
|
||||
- Scrollen Sie nach unten zu _Rocket Loader™_ und deaktivieren Sie es
|
||||
|
||||
Hugo-Websites, die mit Blowfish erstellt wurden, laden auch mit deaktivierter Funktion immer noch sehr schnell.
|
||||
|
||||
## Shared Hosting, VPS oder privater Webserver
|
||||
|
||||
Die Verwendung von traditionellem Webhosting oder die Bereitstellung auf Ihrem eigenen Webserver ist so einfach wie das Erstellen Ihrer Hugo-Website und das Übertragen der Dateien auf Ihren Host.
|
||||
|
||||
Stellen Sie sicher, dass der `baseURL`-Parameter in `hugo.toml` auf die vollständige URL zum Root Ihrer Website gesetzt ist (einschließlich aller Subdomains oder Unterordner).
|
||||
|
||||
Erstellen Sie dann Ihre Website mit `hugo` und kopieren Sie den Inhalt des Ausgabeverzeichnisses in das Root-Verzeichnis Ihres Webservers und Sie sind bereit. Standardmäßig heißt das Ausgabeverzeichnis `public`.
|
||||
|
||||
_Wenn Sie einen Hosting-Anbieter benötigen, schauen Sie sich [Vultr](https://www.vultr.com/?ref=8957394-8H) oder [DigitalOcean](https://m.do.co/c/36841235e565) an. Die Anmeldung über diese Affiliate-Links gibt Ihnen bis zu 100 $ kostenloses Guthaben, damit Sie den Service ausprobieren können._
|
||||
148
exampleSite/content/docs/hosting-deployment/index.es.md
Normal file
148
exampleSite/content/docs/hosting-deployment/index.es.md
Normal file
@@ -0,0 +1,148 @@
|
||||
---
|
||||
title: "Alojamiento y despliegue"
|
||||
weight: 14
|
||||
draft: false
|
||||
description: "Aprende cómo desplegar un sitio Blowfish."
|
||||
slug: "hosting-deployment"
|
||||
tags: ["documentación", "alojamiento", "despliegue", "github", "netlify", "render"]
|
||||
series: ["Documentación"]
|
||||
series_order: 14
|
||||
---
|
||||
|
||||
Hay muchas formas de desplegar tu sitio web Hugo construido con Blowfish. El tema está diseñado para ser flexible en casi cualquier escenario de despliegue.
|
||||
|
||||
Blowfish usa URLs relativas en todo el tema. Esto permite que los sitios se desplieguen fácilmente en subcarpetas y hosts como GitHub Pages. Normalmente no se requiere ninguna configuración especial siempre que el parámetro `baseURL` haya sido configurado en el archivo `hugo.toml`.
|
||||
|
||||
La documentación oficial de Hugo [Alojamiento y Despliegue](https://gohugo.io/hosting-and-deployment/) es el mejor lugar para aprender cómo desplegar tu sitio. Las secciones siguientes contienen algunos detalles de configuración específicos del tema que pueden ayudarte a desplegar sin problemas con ciertos proveedores.
|
||||
|
||||
**Elige tu proveedor:**
|
||||
|
||||
- [GitHub Pages](#github-pages)
|
||||
- [Netlify](#netlify)
|
||||
- [Render](#render)
|
||||
- [Cloudflare Pages](#cloudflare-pages)
|
||||
- [Hosting compartido, VPS o servidor web privado](#hosting-compartido-vps-o-servidor-web-privado)
|
||||
|
||||
---
|
||||
|
||||
## GitHub Pages
|
||||
|
||||
GitHub permite alojar en [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages) usando Actions. Para habilitar esta funcionalidad, activa Pages en tu repositorio y crea un nuevo workflow de Actions para construir y desplegar tu sitio.
|
||||
|
||||
El archivo necesita estar en formato YAML, colocado dentro del directorio `.github/workflows/` de tu repositorio de GitHub y nombrado con extensión `.yml`.
|
||||
|
||||
{{< alert >}}
|
||||
**Importante:** Asegúrate de establecer el nombre de rama correcto bajo `branches` y en el parámetro `if` del paso de despliegue hacia la rama fuente usada en tu proyecto.
|
||||
{{< /alert >}}
|
||||
|
||||
```yaml
|
||||
# .github/workflows/gh-pages.yml
|
||||
|
||||
name: GitHub Pages
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
build-deploy:
|
||||
runs-on: ubuntu-24.04
|
||||
concurrency:
|
||||
group: ${{ github.workflow }}-${{ github.ref }}
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: true
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Setup Hugo
|
||||
uses: peaceiris/actions-hugo@v2
|
||||
with:
|
||||
hugo-version: "latest"
|
||||
|
||||
- name: Build
|
||||
run: hugo --minify
|
||||
|
||||
- name: Deploy
|
||||
uses: peaceiris/actions-gh-pages@v3
|
||||
if: ${{ github.ref == 'refs/heads/main' }}
|
||||
with:
|
||||
github_token: ${{ secrets.GITHUB_TOKEN }}
|
||||
publish_branch: gh-pages
|
||||
publish_dir: ./public
|
||||
```
|
||||
|
||||
Sube el archivo de configuración a GitHub y la acción debería ejecutarse automáticamente. Puede fallar la primera vez y necesitarás visitar la sección **Settings > Pages** de tu repositorio de GitHub para verificar que la fuente es correcta. Debería estar configurada para usar la rama `gh-pages`.
|
||||
|
||||
{{< screenshot src="github-pages-source.jpg" alt="Captura de pantalla de la fuente de GitHub Pages" >}}
|
||||
|
||||
Una vez que los ajustes estén configurados, vuelve a ejecutar la acción y el sitio debería construirse y desplegarse correctamente. Puedes consultar los logs de acciones para verificar que todo se desplegó exitosamente.
|
||||
|
||||
## Netlify
|
||||
|
||||
Para desplegar en [Netlify](https://www.netlify.com), crea un nuevo sitio de despliegue continuo y enlázalo a tu código fuente. Los ajustes de construcción pueden dejarse en blanco en la interfaz de Netlify. Solo necesitarás configurar el dominio que usarás.
|
||||
|
||||
{{< screenshot src="netlify-build-settings.jpg" alt="Captura de pantalla de los ajustes de construcción de Netlify" >}}
|
||||
|
||||
Luego en la raíz del repositorio de tu sitio, crea un archivo `netlify.toml`:
|
||||
|
||||
```toml
|
||||
# netlify.toml
|
||||
|
||||
[build]
|
||||
command = "hugo mod get -u && hugo --gc --minify -b $URL"
|
||||
publish = "public"
|
||||
|
||||
[build.environment]
|
||||
NODE_ENV = "production"
|
||||
GO_VERSION = "1.16"
|
||||
TZ = "UTC" # Establecer a la zona horaria preferida
|
||||
|
||||
[context.production.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
HUGO_ENV = "production"
|
||||
|
||||
[context.deploy-preview.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
```
|
||||
|
||||
Esta configuración asume que estás desplegando Blowfish como un módulo de Hugo. Si has instalado el tema usando otro método, cambia el comando de construcción simplemente a `hugo --gc --minify -b $URL`.
|
||||
|
||||
Cuando subas el archivo de configuración a tu repositorio, Netlify debería desplegar automáticamente tu sitio. Puedes verificar los logs de despliegue en la interfaz de Netlify para cualquier error.
|
||||
|
||||
## Render
|
||||
|
||||
Desplegar en [Render](https://render.com) es muy sencillo y toda la configuración se hace a través de la interfaz de Render.
|
||||
|
||||
Crea un nuevo **Static Site** y enlázalo al repositorio de código de tu proyecto. Luego simplemente configura el comando de construcción como `hugo --gc --minify` y el directorio de publicación como `public`.
|
||||
|
||||
{{< screenshot src="render-settings.jpg" alt="Captura de pantalla de los ajustes de Render" >}}
|
||||
|
||||
El sitio se construirá y desplegará automáticamente cada vez que subas un cambio a tu repositorio.
|
||||
|
||||
## Cloudflare Pages
|
||||
|
||||
Cloudflare ofrece el servicio [Pages](https://pages.cloudflare.com/) que puede alojar blogs de Hugo. Construye el sitio desde un repositorio git y luego lo aloja en el CDN de Cloudflare. Sigue su [guía de despliegue de Hugo](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site) para comenzar.
|
||||
|
||||
La función Rocket Loader™ ofrecida por Cloudflare intenta acelerar el renderizado de páginas web con JavaScript, pero rompe el selector de apariencia en el tema. También puede causar un molesto parpadeo de pantalla claro/oscuro al navegar por tu sitio debido a que los scripts se cargan en el orden incorrecto.
|
||||
|
||||
Este problema se puede solucionar desactivándolo:
|
||||
|
||||
- Ve al [panel de Cloudflare](https://dash.cloudflare.com)
|
||||
- Haz clic en tu nombre de dominio en la lista
|
||||
- Haz clic en _Optimization_ en la sección _Speed_
|
||||
- Desplázate hacia abajo hasta _Rocket Loader™_ y desactívalo
|
||||
|
||||
Los sitios Hugo construidos con Blowfish aún cargan muy rápido, incluso con esta función desactivada.
|
||||
|
||||
## Hosting compartido, VPS o servidor web privado
|
||||
|
||||
Usar hosting web tradicional, o desplegar en tu propio servidor web, es tan simple como construir tu sitio Hugo y transferir los archivos a tu host.
|
||||
|
||||
Asegúrate de que el parámetro `baseURL` en `hugo.toml` esté establecido a la URL completa hacia la raíz de tu sitio web (incluyendo cualquier subdominio o subcarpeta).
|
||||
|
||||
Luego construye tu sitio usando `hugo` y copia el contenido del directorio de salida a la raíz de tu servidor web y estarás listo. Por defecto, el directorio de salida se llama `public`.
|
||||
|
||||
_Si necesitas un proveedor de hosting, echa un vistazo a [Vultr](https://www.vultr.com/?ref=8957394-8H) o [DigitalOcean](https://m.do.co/c/36841235e565). Registrarte usando estos enlaces de afiliado te dará hasta $100 en crédito gratis para que puedas probar el servicio._
|
||||
148
exampleSite/content/docs/hosting-deployment/index.fr.md
Normal file
148
exampleSite/content/docs/hosting-deployment/index.fr.md
Normal file
@@ -0,0 +1,148 @@
|
||||
---
|
||||
title: "Hébergement & Déploiement"
|
||||
weight: 14
|
||||
draft: false
|
||||
description: "Apprenez à déployer un site Blowfish."
|
||||
slug: "hosting-deployment"
|
||||
tags: ["documentation", "hébergement", "déploiement", "github", "netlify", "render"]
|
||||
series: ["Documentation"]
|
||||
series_order: 14
|
||||
---
|
||||
|
||||
Il existe de nombreuses façons de déployer votre site web Hugo construit avec Blowfish. Le thème est conçu pour être flexible dans presque tous les scénarios de déploiement.
|
||||
|
||||
Blowfish utilise des URLs relatives tout au long du thème. Cela permet aux sites d'être facilement déployés dans des sous-dossiers et sur des hôtes comme GitHub Pages. Il n'y a généralement pas de configuration spéciale requise tant que le paramètre `baseURL` a été configuré dans le fichier `hugo.toml`.
|
||||
|
||||
La documentation officielle Hugo [Hébergement et Déploiement](https://gohugo.io/hosting-and-deployment/) est le meilleur endroit pour apprendre à déployer votre site. Les sections ci-dessous contiennent quelques détails de configuration spécifiques au thème qui peuvent vous aider à déployer sans problème avec certains fournisseurs.
|
||||
|
||||
**Choisissez votre fournisseur :**
|
||||
|
||||
- [GitHub Pages](#github-pages)
|
||||
- [Netlify](#netlify)
|
||||
- [Render](#render)
|
||||
- [Cloudflare Pages](#cloudflare-pages)
|
||||
- [Hébergement partagé, VPS ou serveur web privé](#hébergement-partagé-vps-ou-serveur-web-privé)
|
||||
|
||||
---
|
||||
|
||||
## GitHub Pages
|
||||
|
||||
GitHub permet l'hébergement sur [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages) en utilisant Actions. Pour activer cette fonctionnalité, activez Pages sur votre dépôt et créez un nouveau workflow Actions pour construire et déployer votre site.
|
||||
|
||||
Le fichier doit être au format YAML, placé dans le répertoire `.github/workflows/` de votre dépôt GitHub et nommé avec une extension `.yml`.
|
||||
|
||||
{{< alert >}}
|
||||
**Important :** Assurez-vous de définir le bon nom de branche sous `branches` et dans le paramètre `if` de l'étape de déploiement vers la branche source utilisée dans votre projet.
|
||||
{{< /alert >}}
|
||||
|
||||
```yaml
|
||||
# .github/workflows/gh-pages.yml
|
||||
|
||||
name: GitHub Pages
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
build-deploy:
|
||||
runs-on: ubuntu-24.04
|
||||
concurrency:
|
||||
group: ${{ github.workflow }}-${{ github.ref }}
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: true
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Setup Hugo
|
||||
uses: peaceiris/actions-hugo@v2
|
||||
with:
|
||||
hugo-version: "latest"
|
||||
|
||||
- name: Build
|
||||
run: hugo --minify
|
||||
|
||||
- name: Deploy
|
||||
uses: peaceiris/actions-gh-pages@v3
|
||||
if: ${{ github.ref == 'refs/heads/main' }}
|
||||
with:
|
||||
github_token: ${{ secrets.GITHUB_TOKEN }}
|
||||
publish_branch: gh-pages
|
||||
publish_dir: ./public
|
||||
```
|
||||
|
||||
Poussez le fichier de configuration vers GitHub et l'action devrait s'exécuter automatiquement. Elle peut échouer la première fois et vous devrez visiter la section **Settings > Pages** de votre dépôt GitHub pour vérifier que la source est correcte. Elle devrait être configurée pour utiliser la branche `gh-pages`.
|
||||
|
||||
{{< screenshot src="github-pages-source.jpg" alt="Capture d'écran de la source GitHub Pages" >}}
|
||||
|
||||
Une fois les paramètres configurés, relancez l'action et le site devrait se construire et se déployer correctement. Vous pouvez consulter les logs d'actions pour vérifier que tout s'est déployé avec succès.
|
||||
|
||||
## Netlify
|
||||
|
||||
Pour déployer sur [Netlify](https://www.netlify.com), créez un nouveau site de déploiement continu et liez-le à votre code source. Les paramètres de construction peuvent être laissés vides dans l'interface Netlify. Vous n'aurez qu'à configurer le domaine que vous utiliserez.
|
||||
|
||||
{{< screenshot src="netlify-build-settings.jpg" alt="Capture d'écran des paramètres de construction Netlify" >}}
|
||||
|
||||
Puis dans la racine du dépôt de votre site, créez un fichier `netlify.toml` :
|
||||
|
||||
```toml
|
||||
# netlify.toml
|
||||
|
||||
[build]
|
||||
command = "hugo mod get -u && hugo --gc --minify -b $URL"
|
||||
publish = "public"
|
||||
|
||||
[build.environment]
|
||||
NODE_ENV = "production"
|
||||
GO_VERSION = "1.16"
|
||||
TZ = "UTC" # Définir selon le fuseau horaire préféré
|
||||
|
||||
[context.production.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
HUGO_ENV = "production"
|
||||
|
||||
[context.deploy-preview.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
```
|
||||
|
||||
Cette configuration suppose que vous déployez Blowfish en tant que module Hugo. Si vous avez installé le thème en utilisant une autre méthode, changez la commande de construction simplement en `hugo --gc --minify -b $URL`.
|
||||
|
||||
Lorsque vous poussez le fichier de configuration vers votre dépôt, Netlify devrait déployer automatiquement votre site. Vous pouvez vérifier les logs de déploiement dans l'interface Netlify pour toute erreur.
|
||||
|
||||
## Render
|
||||
|
||||
Le déploiement sur [Render](https://render.com) est très simple et toute la configuration se fait via l'interface Render.
|
||||
|
||||
Créez un nouveau **Static Site** et liez-le au dépôt de code de votre projet. Puis configurez simplement la commande de construction comme `hugo --gc --minify` et le répertoire de publication comme `public`.
|
||||
|
||||
{{< screenshot src="render-settings.jpg" alt="Capture d'écran des paramètres Render" >}}
|
||||
|
||||
Le site se construira et se déploiera automatiquement chaque fois que vous pousserez un changement vers votre dépôt.
|
||||
|
||||
## Cloudflare Pages
|
||||
|
||||
Cloudflare offre le service [Pages](https://pages.cloudflare.com/) qui peut héberger des blogs Hugo. Il construit le site à partir d'un dépôt git et l'héberge ensuite sur le CDN de Cloudflare. Suivez leur [guide de déploiement Hugo](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site) pour commencer.
|
||||
|
||||
La fonctionnalité Rocket Loader™ offerte par Cloudflare essaie d'accélérer le rendu des pages web avec JavaScript, mais elle casse le sélecteur d'apparence dans le thème. Elle peut également causer un flash d'écran clair/sombre ennuyeux lors de la navigation sur votre site en raison du chargement des scripts dans le mauvais ordre.
|
||||
|
||||
Ce problème peut être résolu en le désactivant :
|
||||
|
||||
- Allez sur le [tableau de bord Cloudflare](https://dash.cloudflare.com)
|
||||
- Cliquez sur votre nom de domaine dans la liste
|
||||
- Cliquez sur _Optimization_ dans la section _Speed_
|
||||
- Faites défiler jusqu'à _Rocket Loader™_ et désactivez-le
|
||||
|
||||
Les sites Hugo construits avec Blowfish chargent toujours très rapidement, même avec cette fonctionnalité désactivée.
|
||||
|
||||
## Hébergement partagé, VPS ou serveur web privé
|
||||
|
||||
Utiliser un hébergement web traditionnel, ou déployer sur votre propre serveur web, est aussi simple que de construire votre site Hugo et de transférer les fichiers vers votre hôte.
|
||||
|
||||
Assurez-vous que le paramètre `baseURL` dans `hugo.toml` est défini sur l'URL complète vers la racine de votre site web (y compris les sous-domaines ou sous-dossiers).
|
||||
|
||||
Puis construisez votre site en utilisant `hugo` et copiez le contenu du répertoire de sortie vers la racine de votre serveur web et vous serez prêt. Par défaut, le répertoire de sortie est nommé `public`.
|
||||
|
||||
_Si vous avez besoin d'un fournisseur d'hébergement, consultez [Vultr](https://www.vultr.com/?ref=8957394-8H) ou [DigitalOcean](https://m.do.co/c/36841235e565). L'inscription via ces liens d'affiliation vous donnera jusqu'à 100$ de crédit gratuit pour essayer le service._
|
||||
148
exampleSite/content/docs/hosting-deployment/index.pt-br.md
Normal file
148
exampleSite/content/docs/hosting-deployment/index.pt-br.md
Normal file
@@ -0,0 +1,148 @@
|
||||
---
|
||||
title: "Hospedagem e implantação"
|
||||
weight: 14
|
||||
draft: false
|
||||
description: "Aprenda como implantar um site Blowfish."
|
||||
slug: "hosting-deployment"
|
||||
tags: ["documentação", "hospedagem", "implantação", "github", "netlify", "render"]
|
||||
series: ["Documentação"]
|
||||
series_order: 14
|
||||
---
|
||||
|
||||
Existem muitas formas de implantar seu site Hugo construído com Blowfish. O tema é projetado para ser flexível em quase qualquer cenário de implantação.
|
||||
|
||||
O Blowfish usa URLs relativas em todo o tema. Isso permite que sites sejam facilmente implantados em subpastas e hosts como GitHub Pages. Normalmente não há configuração especial necessária, desde que o parâmetro `baseURL` tenha sido configurado no arquivo `hugo.toml`.
|
||||
|
||||
A documentação oficial do Hugo [Hospedagem e Implantação](https://gohugo.io/hosting-and-deployment/) é o melhor lugar para aprender como implantar seu site. As seções abaixo contêm alguns detalhes de configuração específicos do tema que podem ajudá-lo a implantar sem problemas com certos provedores.
|
||||
|
||||
**Escolha seu provedor:**
|
||||
|
||||
- [GitHub Pages](#github-pages)
|
||||
- [Netlify](#netlify)
|
||||
- [Render](#render)
|
||||
- [Cloudflare Pages](#cloudflare-pages)
|
||||
- [Hospedagem compartilhada, VPS ou servidor web privado](#hospedagem-compartilhada-vps-ou-servidor-web-privado)
|
||||
|
||||
---
|
||||
|
||||
## GitHub Pages
|
||||
|
||||
O GitHub permite hospedagem no [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages) usando Actions. Para habilitar essa funcionalidade, ative o Pages em seu repositório e crie um novo workflow de Actions para construir e implantar seu site.
|
||||
|
||||
O arquivo precisa estar no formato YAML, colocado dentro do diretório `.github/workflows/` do seu repositório GitHub e nomeado com extensão `.yml`.
|
||||
|
||||
{{< alert >}}
|
||||
**Importante:** Certifique-se de definir o nome correto da branch em `branches` e no parâmetro `if` da etapa de implantação para a branch de origem usada em seu projeto.
|
||||
{{< /alert >}}
|
||||
|
||||
```yaml
|
||||
# .github/workflows/gh-pages.yml
|
||||
|
||||
name: GitHub Pages
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
build-deploy:
|
||||
runs-on: ubuntu-24.04
|
||||
concurrency:
|
||||
group: ${{ github.workflow }}-${{ github.ref }}
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: true
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Setup Hugo
|
||||
uses: peaceiris/actions-hugo@v2
|
||||
with:
|
||||
hugo-version: "latest"
|
||||
|
||||
- name: Build
|
||||
run: hugo --minify
|
||||
|
||||
- name: Deploy
|
||||
uses: peaceiris/actions-gh-pages@v3
|
||||
if: ${{ github.ref == 'refs/heads/main' }}
|
||||
with:
|
||||
github_token: ${{ secrets.GITHUB_TOKEN }}
|
||||
publish_branch: gh-pages
|
||||
publish_dir: ./public
|
||||
```
|
||||
|
||||
Envie o arquivo de configuração para o GitHub e a action deve ser executada automaticamente. Pode falhar na primeira vez e você precisará visitar a seção **Settings > Pages** do seu repositório GitHub para verificar se a origem está correta. Ela deve estar configurada para usar a branch `gh-pages`.
|
||||
|
||||
{{< screenshot src="github-pages-source.jpg" alt="Captura de tela da origem do GitHub Pages" >}}
|
||||
|
||||
Uma vez que as configurações estejam definidas, execute novamente a action e o site deve ser construído e implantado corretamente. Você pode consultar os logs das actions para verificar se tudo foi implantado com sucesso.
|
||||
|
||||
## Netlify
|
||||
|
||||
Para implantar no [Netlify](https://www.netlify.com), crie um novo site de implantação contínua e vincule-o ao seu código-fonte. As configurações de build podem ser deixadas em branco na interface do Netlify. Você só precisará configurar o domínio que usará.
|
||||
|
||||
{{< screenshot src="netlify-build-settings.jpg" alt="Captura de tela das configurações de build do Netlify" >}}
|
||||
|
||||
Em seguida, na raiz do repositório do seu site, crie um arquivo `netlify.toml`:
|
||||
|
||||
```toml
|
||||
# netlify.toml
|
||||
|
||||
[build]
|
||||
command = "hugo mod get -u && hugo --gc --minify -b $URL"
|
||||
publish = "public"
|
||||
|
||||
[build.environment]
|
||||
NODE_ENV = "production"
|
||||
GO_VERSION = "1.16"
|
||||
TZ = "UTC" # Definir para o fuso horário preferido
|
||||
|
||||
[context.production.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
HUGO_ENV = "production"
|
||||
|
||||
[context.deploy-preview.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
```
|
||||
|
||||
Esta configuração assume que você está implantando o Blowfish como um módulo Hugo. Se você instalou o tema usando outro método, altere o comando de build simplesmente para `hugo --gc --minify -b $URL`.
|
||||
|
||||
Quando você enviar o arquivo de configuração para seu repositório, o Netlify deve implantar automaticamente seu site. Você pode verificar os logs de implantação na interface do Netlify para quaisquer erros.
|
||||
|
||||
## Render
|
||||
|
||||
Implantar no [Render](https://render.com) é muito simples e toda a configuração é feita através da interface do Render.
|
||||
|
||||
Crie um novo **Static Site** e vincule-o ao repositório de código do seu projeto. Em seguida, simplesmente configure o comando de build como `hugo --gc --minify` e o diretório de publicação como `public`.
|
||||
|
||||
{{< screenshot src="render-settings.jpg" alt="Captura de tela das configurações do Render" >}}
|
||||
|
||||
O site será construído e implantado automaticamente sempre que você enviar uma alteração para seu repositório.
|
||||
|
||||
## Cloudflare Pages
|
||||
|
||||
A Cloudflare oferece o serviço [Pages](https://pages.cloudflare.com/) que pode hospedar blogs Hugo. Ele constrói o site a partir de um repositório git e o hospeda no CDN da Cloudflare. Siga o [guia de implantação Hugo](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site) deles para começar.
|
||||
|
||||
O recurso Rocket Loader™ oferecido pela Cloudflare tenta acelerar a renderização de páginas web com JavaScript, mas ele quebra o seletor de aparência no tema. Também pode causar um flash irritante de tela clara/escura ao navegar em seu site devido aos scripts carregando na ordem errada.
|
||||
|
||||
Este problema pode ser corrigido desativando-o:
|
||||
|
||||
- Vá para o [painel da Cloudflare](https://dash.cloudflare.com)
|
||||
- Clique no nome do seu domínio na lista
|
||||
- Clique em _Optimization_ na seção _Speed_
|
||||
- Role até _Rocket Loader™_ e desative-o
|
||||
|
||||
Sites Hugo construídos com Blowfish ainda carregam muito rápido, mesmo com este recurso desativado.
|
||||
|
||||
## Hospedagem compartilhada, VPS ou servidor web privado
|
||||
|
||||
Usar hospedagem web tradicional, ou implantar em seu próprio servidor web, é tão simples quanto construir seu site Hugo e transferir os arquivos para seu host.
|
||||
|
||||
Certifique-se de que o parâmetro `baseURL` em `hugo.toml` esteja definido para a URL completa para a raiz do seu site (incluindo quaisquer subdomínios ou subpastas).
|
||||
|
||||
Em seguida, construa seu site usando `hugo` e copie o conteúdo do diretório de saída para a raiz do seu servidor web e você estará pronto. Por padrão, o diretório de saída é chamado `public`.
|
||||
|
||||
_Se você precisa de um provedor de hospedagem, confira [Vultr](https://www.vultr.com/?ref=8957394-8H) ou [DigitalOcean](https://m.do.co/c/36841235e565). Cadastrar-se usando esses links de afiliado lhe dará até $100 em crédito grátis para que você possa experimentar o serviço._
|
||||
148
exampleSite/content/docs/hosting-deployment/index.pt-pt.md
Normal file
148
exampleSite/content/docs/hosting-deployment/index.pt-pt.md
Normal file
@@ -0,0 +1,148 @@
|
||||
---
|
||||
title: "Alojamento e implementação"
|
||||
weight: 14
|
||||
draft: false
|
||||
description: "Aprenda como implementar um site Blowfish."
|
||||
slug: "hosting-deployment"
|
||||
tags: ["documentação", "alojamento", "implementação", "github", "netlify", "render"]
|
||||
series: ["Documentação"]
|
||||
series_order: 14
|
||||
---
|
||||
|
||||
Existem muitas formas de implementar o seu website Hugo construído com Blowfish. O tema é concebido para ser flexível em quase qualquer cenário de implementação.
|
||||
|
||||
O Blowfish utiliza URLs relativos em todo o tema. Isto permite que os sites sejam facilmente implementados em subpastas e hosts como GitHub Pages. Normalmente não é necessária nenhuma configuração especial desde que o parâmetro `baseURL` tenha sido configurado no ficheiro `hugo.toml`.
|
||||
|
||||
A documentação oficial do Hugo [Alojamento e Implementação](https://gohugo.io/hosting-and-deployment/) é o melhor local para aprender como implementar o seu site. As secções abaixo contêm alguns detalhes de configuração específicos do tema que podem ajudá-lo a implementar sem problemas com certos fornecedores.
|
||||
|
||||
**Escolha o seu fornecedor:**
|
||||
|
||||
- [GitHub Pages](#github-pages)
|
||||
- [Netlify](#netlify)
|
||||
- [Render](#render)
|
||||
- [Cloudflare Pages](#cloudflare-pages)
|
||||
- [Alojamento partilhado, VPS ou servidor web privado](#alojamento-partilhado-vps-ou-servidor-web-privado)
|
||||
|
||||
---
|
||||
|
||||
## GitHub Pages
|
||||
|
||||
O GitHub permite alojamento no [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages) utilizando Actions. Para ativar esta funcionalidade, ative o Pages no seu repositório e crie um novo workflow de Actions para construir e implementar o seu site.
|
||||
|
||||
O ficheiro precisa de estar no formato YAML, colocado dentro do diretório `.github/workflows/` do seu repositório GitHub e nomeado com extensão `.yml`.
|
||||
|
||||
{{< alert >}}
|
||||
**Importante:** Certifique-se de definir o nome correto da branch em `branches` e no parâmetro `if` da etapa de implementação para a branch de origem utilizada no seu projeto.
|
||||
{{< /alert >}}
|
||||
|
||||
```yaml
|
||||
# .github/workflows/gh-pages.yml
|
||||
|
||||
name: GitHub Pages
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
|
||||
jobs:
|
||||
build-deploy:
|
||||
runs-on: ubuntu-24.04
|
||||
concurrency:
|
||||
group: ${{ github.workflow }}-${{ github.ref }}
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
submodules: true
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Setup Hugo
|
||||
uses: peaceiris/actions-hugo@v2
|
||||
with:
|
||||
hugo-version: "latest"
|
||||
|
||||
- name: Build
|
||||
run: hugo --minify
|
||||
|
||||
- name: Deploy
|
||||
uses: peaceiris/actions-gh-pages@v3
|
||||
if: ${{ github.ref == 'refs/heads/main' }}
|
||||
with:
|
||||
github_token: ${{ secrets.GITHUB_TOKEN }}
|
||||
publish_branch: gh-pages
|
||||
publish_dir: ./public
|
||||
```
|
||||
|
||||
Envie o ficheiro de configuração para o GitHub e a action deve ser executada automaticamente. Pode falhar na primeira vez e precisará de visitar a secção **Settings > Pages** do seu repositório GitHub para verificar se a origem está correta. Deve estar configurada para utilizar a branch `gh-pages`.
|
||||
|
||||
{{< screenshot src="github-pages-source.jpg" alt="Captura de ecrã da origem do GitHub Pages" >}}
|
||||
|
||||
Assim que as definições estejam configuradas, execute novamente a action e o site deve ser construído e implementado corretamente. Pode consultar os logs das actions para verificar se tudo foi implementado com sucesso.
|
||||
|
||||
## Netlify
|
||||
|
||||
Para implementar no [Netlify](https://www.netlify.com), crie um novo site de implementação contínua e vincule-o ao seu código-fonte. As definições de build podem ser deixadas em branco na interface do Netlify. Só precisará de configurar o domínio que utilizará.
|
||||
|
||||
{{< screenshot src="netlify-build-settings.jpg" alt="Captura de ecrã das definições de build do Netlify" >}}
|
||||
|
||||
Em seguida, na raiz do repositório do seu site, crie um ficheiro `netlify.toml`:
|
||||
|
||||
```toml
|
||||
# netlify.toml
|
||||
|
||||
[build]
|
||||
command = "hugo mod get -u && hugo --gc --minify -b $URL"
|
||||
publish = "public"
|
||||
|
||||
[build.environment]
|
||||
NODE_ENV = "production"
|
||||
GO_VERSION = "1.16"
|
||||
TZ = "UTC" # Definir para o fuso horário preferido
|
||||
|
||||
[context.production.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
HUGO_ENV = "production"
|
||||
|
||||
[context.deploy-preview.environment]
|
||||
HUGO_VERSION = "0.104.1"
|
||||
```
|
||||
|
||||
Esta configuração assume que está a implementar o Blowfish como um módulo Hugo. Se instalou o tema utilizando outro método, altere o comando de build simplesmente para `hugo --gc --minify -b $URL`.
|
||||
|
||||
Quando enviar o ficheiro de configuração para o seu repositório, o Netlify deve implementar automaticamente o seu site. Pode verificar os logs de implementação na interface do Netlify para quaisquer erros.
|
||||
|
||||
## Render
|
||||
|
||||
Implementar no [Render](https://render.com) é muito simples e toda a configuração é feita através da interface do Render.
|
||||
|
||||
Crie um novo **Static Site** e vincule-o ao repositório de código do seu projeto. Em seguida, simplesmente configure o comando de build como `hugo --gc --minify` e o diretório de publicação como `public`.
|
||||
|
||||
{{< screenshot src="render-settings.jpg" alt="Captura de ecrã das definições do Render" >}}
|
||||
|
||||
O site será construído e implementado automaticamente sempre que enviar uma alteração para o seu repositório.
|
||||
|
||||
## Cloudflare Pages
|
||||
|
||||
A Cloudflare oferece o serviço [Pages](https://pages.cloudflare.com/) que pode alojar blogues Hugo. Constrói o site a partir de um repositório git e depois aloja-o na CDN da Cloudflare. Siga o [guia de implementação Hugo](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site) deles para começar.
|
||||
|
||||
A funcionalidade Rocket Loader™ oferecida pela Cloudflare tenta acelerar a renderização de páginas web com JavaScript, mas quebra o seletor de aparência no tema. Também pode causar um flash irritante de ecrã claro/escuro ao navegar no seu site devido aos scripts a carregar na ordem errada.
|
||||
|
||||
Este problema pode ser corrigido desativando-o:
|
||||
|
||||
- Vá ao [painel da Cloudflare](https://dash.cloudflare.com)
|
||||
- Clique no nome do seu domínio na lista
|
||||
- Clique em _Optimization_ na secção _Speed_
|
||||
- Desloque-se até _Rocket Loader™_ e desative-o
|
||||
|
||||
Sites Hugo construídos com Blowfish ainda carregam muito rapidamente, mesmo com esta funcionalidade desativada.
|
||||
|
||||
## Alojamento partilhado, VPS ou servidor web privado
|
||||
|
||||
Utilizar alojamento web tradicional, ou implementar no seu próprio servidor web, é tão simples como construir o seu site Hugo e transferir os ficheiros para o seu host.
|
||||
|
||||
Certifique-se de que o parâmetro `baseURL` em `hugo.toml` está definido para o URL completo para a raiz do seu website (incluindo quaisquer subdomínios ou subpastas).
|
||||
|
||||
Em seguida, construa o seu site utilizando `hugo` e copie o conteúdo do diretório de saída para a raiz do seu servidor web e estará pronto. Por predefinição, o diretório de saída chama-se `public`.
|
||||
|
||||
_Se precisa de um fornecedor de alojamento, confira [Vultr](https://www.vultr.com/?ref=8957394-8H) ou [DigitalOcean](https://m.do.co/c/36841235e565). Registar-se utilizando estes links de afiliado dar-lhe-á até $100 em crédito grátis para que possa experimentar o serviço._
|
||||
Reference in New Issue
Block a user