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
211
exampleSite/content/docs/installation/index.de.md
Normal file
211
exampleSite/content/docs/installation/index.de.md
Normal file
@@ -0,0 +1,211 @@
|
||||
---
|
||||
title: "Installation"
|
||||
weight: 2
|
||||
draft: false
|
||||
description: "Wie man das Blowfish-Theme installiert."
|
||||
slug: "installation"
|
||||
tags: ["installation", "dokumentation"]
|
||||
series: ["Dokumentation"]
|
||||
series_order: 2
|
||||
---
|
||||
|
||||
Folgen Sie einfach dem standardmäßigen Hugo [Schnellstart](https://gohugo.io/getting-started/quick-start/)-Verfahren, um schnell loszulegen.
|
||||
|
||||
Detaillierte Installationsanweisungen finden Sie unten. Anweisungen zum [Aktualisieren des Themes](#updates-installieren) sind ebenfalls verfügbar.
|
||||
|
||||
## Installation
|
||||
|
||||
Diese Anweisungen bringen Sie von einem komplett leeren Zustand mit Hugo und Blowfish zum Laufen. Die meisten der in diesem Leitfaden erwähnten Abhängigkeiten können mit dem Paketmanager Ihrer Wahl für Ihre Plattform installiert werden.
|
||||
|
||||
### Hugo installieren
|
||||
|
||||
Wenn Sie Hugo noch nicht verwendet haben, müssen Sie es [auf Ihrem lokalen Computer installieren](https://gohugo.io/getting-started/installing). Sie können überprüfen, ob es bereits installiert ist, indem Sie den Befehl `hugo version` ausführen.
|
||||
|
||||
{{< alert >}}
|
||||
Stellen Sie sicher, dass Sie **Hugo Version 0.87.0** oder höher verwenden, da das Theme einige der neuesten Hugo-Funktionen nutzt.
|
||||
{{< /alert >}}
|
||||
|
||||
Sie finden detaillierte Installationsanweisungen für Ihre Plattform in der [Hugo-Dokumentation](https://gohugo.io/getting-started/installing).
|
||||
|
||||
### Blowfish Tools (empfohlen)
|
||||
|
||||
Wir haben gerade ein neues CLI-Tool veröffentlicht, das Ihnen beim Einstieg mit Blowfish hilft. Es erstellt ein neues Hugo-Projekt, installiert das Theme und richtet die Theme-Konfigurationsdateien für Sie ein. Es befindet sich noch in der Beta-Phase, also [melden Sie bitte alle Probleme, die Sie finden](https://github.com/nunocoracao/blowfish-tools).
|
||||
|
||||
Installieren Sie das CLI-Tool global mit npm (oder einem anderen Paketmanager):
|
||||
```shell
|
||||
npx blowfish-tools
|
||||
```
|
||||
oder
|
||||
|
||||
```shell
|
||||
npm i -g blowfish-tools
|
||||
```
|
||||
|
||||
Führen Sie dann den Befehl `blowfish-tools` aus, um einen interaktiven Durchlauf zu starten, der Sie durch Erstellungs- und Konfigurationsanwendungsfälle führt.
|
||||
```shell
|
||||
blowfish-tools
|
||||
```
|
||||
|
||||
Sie können auch den Befehl `blowfish-tools new` ausführen, um ein neues Hugo-Projekt zu erstellen und das Theme in einem Schritt zu installieren. Weitere Informationen finden Sie in der CLI-Hilfe.
|
||||
```shell
|
||||
blowfish-tools new mynewsite
|
||||
```
|
||||
|
||||
Hier ist ein kurzes Video, das zeigt, wie schnell Sie mit dem CLI-Tool mit Blowfish starten können:
|
||||
|
||||
<iframe width="100%" height="350" src="https://www.youtube.com/embed/SgXhGb-7QbU?si=ce44baicuQ6zMeXz" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
|
||||
|
||||
### Installation ohne CLI
|
||||
|
||||
#### Eine neue Website erstellen
|
||||
|
||||
Führen Sie den Befehl `hugo new site mywebsite` aus, um eine neue Hugo-Website in einem Verzeichnis namens `mywebsite` zu erstellen.
|
||||
|
||||
Beachten Sie, dass Sie das Projektverzeichnis beliebig benennen können, aber die folgenden Anweisungen gehen davon aus, dass es `mywebsite` heißt. Wenn Sie einen anderen Namen verwenden, stellen Sie sicher, dass Sie ihn entsprechend ersetzen.
|
||||
|
||||
#### Das Blowfish-Theme herunterladen
|
||||
|
||||
Es gibt verschiedene Möglichkeiten, das Blowfish-Theme in Ihre Hugo-Website zu installieren. Von der einfachsten bis zur schwierigsten Installation und Wartung sind dies:
|
||||
|
||||
- [Git-Submodul](#installation-mit-git) (empfohlen)
|
||||
- [Hugo-Modul](#installation-mit-hugo)
|
||||
- [Manuelle Dateikopie](#manuelle-installation)
|
||||
|
||||
Wenn Sie unsicher sind, wählen Sie die Git-Submodul-Methode.
|
||||
|
||||
#### Installation mit Git
|
||||
|
||||
Diese Methode ist die schnellste und einfachste, um das Theme aktuell zu halten. Neben **Hugo** und **Go** müssen Sie auch sicherstellen, dass **Git** auf Ihrem lokalen Computer installiert ist.
|
||||
|
||||
Wechseln Sie in das Verzeichnis Ihrer Hugo-Website (das Sie oben erstellt haben), initialisieren Sie ein neues `git`-Repository und fügen Sie Blowfish als Submodul hinzu.
|
||||
|
||||
```bash
|
||||
cd mywebsite
|
||||
git init
|
||||
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
||||
```
|
||||
|
||||
Fahren Sie dann mit dem [Einrichten der Theme-Konfigurationsdateien](#theme-konfigurationsdateien-einrichten) fort.
|
||||
|
||||
#### Installation mit Hugo
|
||||
|
||||
Für diese Methode verwenden Sie Hugo zur Verwaltung Ihrer Themes. Hugo verwendet **Go** zum Initialisieren und Verwalten von Modulen, stellen Sie also sicher, dass `go` installiert ist, bevor Sie fortfahren.
|
||||
|
||||
1. [Laden Sie](https://golang.org/dl/) Go herunter und installieren Sie es. Sie können überprüfen, ob es bereits installiert ist, indem Sie den Befehl `go version` verwenden.
|
||||
|
||||
{{< alert >}}
|
||||
Stellen Sie sicher, dass Sie **Go Version 1.12** oder höher verwenden, da Hugo dies für die korrekte Funktion von Modulen benötigt.
|
||||
{{< /alert >}}
|
||||
|
||||
2. Initialisieren Sie von Ihrem Hugo-Projektverzeichnis (das Sie oben erstellt haben) Module für Ihre Website:
|
||||
|
||||
```shell
|
||||
# Wenn Sie Ihr Projekt auf GitHub verwalten
|
||||
hugo mod init github.com/<username>/<repo-name>
|
||||
|
||||
# Wenn Sie Ihr Projekt lokal verwalten
|
||||
hugo mod init my-project
|
||||
```
|
||||
|
||||
3. Fügen Sie das Theme zu Ihrer Konfiguration hinzu, indem Sie eine neue Datei `config/_default/module.toml` erstellen und Folgendes hinzufügen:
|
||||
|
||||
```toml
|
||||
[[imports]]
|
||||
disable = false
|
||||
path = "github.com/nunocoracao/blowfish/v2"
|
||||
```
|
||||
|
||||
4. Starten Sie Ihren Server mit `hugo server` und das Theme wird automatisch heruntergeladen.
|
||||
5. Fahren Sie mit dem [Einrichten der Theme-Konfigurationsdateien](#theme-konfigurationsdateien-einrichten) fort.
|
||||
|
||||
#### Manuelle Installation
|
||||
|
||||
1. Laden Sie die neueste Version des Theme-Quellcodes herunter.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Von Github herunterladen{{< /button >}}
|
||||
|
||||
2. Entpacken Sie das Archiv, benennen Sie den Ordner in `blowfish` um und verschieben Sie ihn in das Verzeichnis `themes/` im Stammordner Ihres Hugo-Projekts.
|
||||
3. Fahren Sie mit dem [Einrichten der Theme-Konfigurationsdateien](#theme-konfigurationsdateien-einrichten) fort.
|
||||
|
||||
#### Theme-Konfigurationsdateien einrichten
|
||||
|
||||
Löschen Sie im Stammordner Ihrer Website die von Hugo generierte Datei `hugo.toml`. Kopieren Sie die `*.toml`-Konfigurationsdateien aus dem Theme in Ihren Ordner `config/_default/`. Dadurch wird sichergestellt, dass Sie alle korrekten Theme-Einstellungen haben und das Theme einfach an Ihre Bedürfnisse anpassen können.
|
||||
|
||||
{{< alert >}}
|
||||
**Hinweis:** Sie sollten die Datei `module.toml` nicht überschreiben, wenn in Ihrem Projekt bereits eine vorhanden ist!
|
||||
{{< /alert >}}
|
||||
|
||||
Je nachdem, wie Sie das Theme installiert haben, finden Sie die Theme-Konfigurationsdateien an verschiedenen Stellen:
|
||||
|
||||
- **Hugo-Module:** Im Hugo-Cache-Verzeichnis oder [laden Sie eine Kopie herunter](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) von GitHub
|
||||
- **Git-Submodul oder manuelle Installation:** `themes/blowfish/config/_default`
|
||||
|
||||
Nachdem Sie die Dateien kopiert haben, sollte Ihr Konfigurationsordner so aussehen:
|
||||
|
||||
```shell
|
||||
config/_default/
|
||||
├─ hugo.toml
|
||||
├─ languages.en.toml
|
||||
├─ markup.toml
|
||||
├─ menus.en.toml
|
||||
├─ module.toml # wenn Sie Hugo-Module zur Installation verwendet haben
|
||||
└─ params.toml
|
||||
```
|
||||
|
||||
{{< alert >}}
|
||||
**Wichtig:** Wenn Sie Blowfish nicht mit Hugo-Modulen installiert haben, müssen Sie die Zeile `theme = "blowfish"` am Anfang Ihrer `hugo.toml`-Datei hinzufügen.
|
||||
{{< /alert >}}
|
||||
|
||||
### Nächste Schritte
|
||||
|
||||
Die grundlegende Blowfish-Installation ist nun abgeschlossen. Fahren Sie mit dem Abschnitt [Erste Schritte]({{< ref "getting-started" >}}) fort, um mehr über die Konfiguration des Themes zu erfahren.
|
||||
|
||||
---
|
||||
|
||||
## Updates installieren
|
||||
|
||||
Von Zeit zu Zeit werden [neue Versionen](https://github.com/nunocoracao/blowfish/releases) veröffentlicht, die Fehlerbehebungen anwenden und neue Funktionen zum Theme hinzufügen. Um diese Änderungen zu nutzen, müssen Sie die Theme-Dateien auf Ihrer Website aktualisieren.
|
||||
|
||||
Wie Sie dabei vorgehen, hängt von der Installationsmethode ab, die Sie bei der ursprünglichen Installation des Themes gewählt haben. Anweisungen für jede Methode finden Sie unten.
|
||||
|
||||
- [Git-Submodul](#update-mit-git)
|
||||
- [Hugo-Modul](#update-mit-hugo)
|
||||
- [Manuelle Dateikopie](#manuelles-update)
|
||||
|
||||
### Update mit Git
|
||||
|
||||
Git-Submodule können mit dem `git`-Befehl aktualisiert werden. Führen Sie einfach den folgenden Befehl aus und die neueste Version des Themes wird in Ihr lokales Repository heruntergeladen:
|
||||
|
||||
```shell
|
||||
git submodule update --remote --merge
|
||||
```
|
||||
|
||||
Nachdem das Submodul aktualisiert wurde, erstellen Sie Ihre Website neu und überprüfen Sie, ob alles wie erwartet funktioniert.
|
||||
|
||||
### Update mit Hugo
|
||||
|
||||
Hugo macht das Aktualisieren von Modulen super einfach. Wechseln Sie einfach in Ihr Projektverzeichnis und führen Sie den folgenden Befehl aus:
|
||||
|
||||
```shell
|
||||
hugo mod get -u
|
||||
```
|
||||
|
||||
Hugo aktualisiert automatisch alle Module, die für Ihr Projekt erforderlich sind. Dies geschieht durch Überprüfung Ihrer `module.toml`- und `go.mod`-Dateien. Wenn Sie Probleme mit dem Update haben, überprüfen Sie, ob diese Dateien noch korrekt konfiguriert sind.
|
||||
|
||||
Erstellen Sie dann einfach Ihre Website neu und überprüfen Sie, ob alles wie erwartet funktioniert.
|
||||
|
||||
### Manuelles Update
|
||||
|
||||
Das manuelle Aktualisieren von Blowfish erfordert, dass Sie die neueste Kopie des Themes herunterladen und die alte Version in Ihrem Projekt ersetzen.
|
||||
|
||||
{{< alert >}}
|
||||
Beachten Sie, dass alle lokalen Anpassungen, die Sie an den Theme-Dateien vorgenommen haben, bei diesem Vorgang verloren gehen.
|
||||
{{< /alert >}}
|
||||
|
||||
1. Laden Sie die neueste Version des Theme-Quellcodes herunter.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Von Github herunterladen{{< /button >}}
|
||||
|
||||
2. Entpacken Sie das Archiv, benennen Sie den Ordner in `blowfish` um und verschieben Sie ihn in das Verzeichnis `themes/` im Stammordner Ihres Hugo-Projekts. Sie müssen das vorhandene Verzeichnis überschreiben, um alle Theme-Dateien zu ersetzen.
|
||||
|
||||
3. Erstellen Sie Ihre Website neu und überprüfen Sie, ob alles wie erwartet funktioniert.
|
||||
211
exampleSite/content/docs/installation/index.es.md
Normal file
211
exampleSite/content/docs/installation/index.es.md
Normal file
@@ -0,0 +1,211 @@
|
||||
---
|
||||
title: "Instalación"
|
||||
weight: 2
|
||||
draft: false
|
||||
description: "Cómo instalar el tema Blowfish."
|
||||
slug: "installation"
|
||||
tags: ["instalación", "documentación"]
|
||||
series: ["Documentación"]
|
||||
series_order: 2
|
||||
---
|
||||
|
||||
Simplemente sigue el procedimiento estándar de Hugo [Inicio Rápido](https://gohugo.io/getting-started/quick-start/) para ponerte en marcha rápidamente.
|
||||
|
||||
Las instrucciones de instalación detalladas se encuentran a continuación. También están disponibles instrucciones para [actualizar el tema](#instalación-de-actualizaciones).
|
||||
|
||||
## Instalación
|
||||
|
||||
Estas instrucciones te ayudarán a empezar con Hugo y Blowfish desde un estado completamente vacío. La mayoría de las dependencias mencionadas en esta guía se pueden instalar utilizando el gestor de paquetes de tu elección para tu plataforma.
|
||||
|
||||
### Instalar Hugo
|
||||
|
||||
Si nunca has usado Hugo antes, necesitarás [instalarlo en tu máquina local](https://gohugo.io/getting-started/installing). Puedes verificar si ya está instalado ejecutando el comando `hugo version`.
|
||||
|
||||
{{< alert >}}
|
||||
Asegúrate de estar usando **Hugo versión 0.87.0** o posterior, ya que el tema aprovecha algunas de las últimas características de Hugo.
|
||||
{{< /alert >}}
|
||||
|
||||
Puedes encontrar instrucciones de instalación detalladas para tu plataforma en la [documentación de Hugo](https://gohugo.io/getting-started/installing).
|
||||
|
||||
### Blowfish Tools (recomendado)
|
||||
|
||||
Acabamos de lanzar una nueva herramienta CLI para ayudarte a empezar con Blowfish. Creará un nuevo proyecto Hugo, instalará el tema y configurará los archivos de configuración del tema por ti. Todavía está en beta, así que por favor [reporta cualquier problema que encuentres](https://github.com/nunocoracao/blowfish-tools).
|
||||
|
||||
Instala la herramienta CLI globalmente usando npm (u otro gestor de paquetes):
|
||||
```shell
|
||||
npx blowfish-tools
|
||||
```
|
||||
o
|
||||
|
||||
```shell
|
||||
npm i -g blowfish-tools
|
||||
```
|
||||
|
||||
Luego ejecuta el comando `blowfish-tools` para iniciar una ejecución interactiva que te guiará a través de los casos de uso de creación y configuración.
|
||||
```shell
|
||||
blowfish-tools
|
||||
```
|
||||
|
||||
También puedes ejecutar el comando `blowfish-tools new` para crear un nuevo proyecto Hugo e instalar el tema de una sola vez. Consulta la ayuda del CLI para más información.
|
||||
```shell
|
||||
blowfish-tools new mynewsite
|
||||
```
|
||||
|
||||
Aquí hay un video corto de lo rápido que es empezar con Blowfish usando la herramienta CLI:
|
||||
|
||||
<iframe width="100%" height="350" src="https://www.youtube.com/embed/SgXhGb-7QbU?si=ce44baicuQ6zMeXz" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
|
||||
|
||||
### Instalación sin CLI
|
||||
|
||||
#### Crear un nuevo sitio
|
||||
|
||||
Ejecuta el comando `hugo new site mywebsite` para crear un nuevo sitio Hugo en un directorio llamado `mywebsite`.
|
||||
|
||||
Ten en cuenta que puedes nombrar el directorio del proyecto como quieras, pero las instrucciones a continuación asumen que se llama `mywebsite`. Si usas un nombre diferente, asegúrate de sustituirlo en consecuencia.
|
||||
|
||||
#### Descargar el tema Blowfish
|
||||
|
||||
Hay varias formas diferentes de instalar el tema Blowfish en tu sitio Hugo. De la más fácil a la más difícil de instalar y mantener, son:
|
||||
|
||||
- [Submódulo Git](#instalación-con-git) (recomendado)
|
||||
- [Módulo Hugo](#instalación-con-hugo)
|
||||
- [Copia manual de archivos](#instalación-manual)
|
||||
|
||||
Si no estás seguro, elige el método del submódulo Git.
|
||||
|
||||
#### Instalación con Git
|
||||
|
||||
Este método es el más rápido y fácil para mantener el tema actualizado. Además de **Hugo** y **Go**, también necesitarás asegurarte de tener **Git** instalado en tu máquina local.
|
||||
|
||||
Cambia al directorio de tu sitio Hugo (que creaste arriba), inicializa un nuevo repositorio `git` y añade Blowfish como submódulo.
|
||||
|
||||
```bash
|
||||
cd mywebsite
|
||||
git init
|
||||
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
||||
```
|
||||
|
||||
Luego continúa para [configurar los archivos de configuración del tema](#configurar-archivos-de-configuración-del-tema).
|
||||
|
||||
#### Instalación con Hugo
|
||||
|
||||
Para este método usarás Hugo para gestionar tus temas. Hugo usa **Go** para inicializar y gestionar módulos, así que asegúrate de tener `go` instalado antes de continuar.
|
||||
|
||||
1. [Descarga](https://golang.org/dl/) e instala Go. Puedes verificar si ya está instalado usando el comando `go version`.
|
||||
|
||||
{{< alert >}}
|
||||
Asegúrate de estar usando **Go versión 1.12** o posterior, ya que Hugo lo requiere para que los módulos funcionen correctamente.
|
||||
{{< /alert >}}
|
||||
|
||||
2. Desde el directorio de tu proyecto Hugo (que creaste arriba), inicializa los módulos para tu sitio:
|
||||
|
||||
```shell
|
||||
# Si estás gestionando tu proyecto en GitHub
|
||||
hugo mod init github.com/<username>/<repo-name>
|
||||
|
||||
# Si estás gestionando tu proyecto localmente
|
||||
hugo mod init my-project
|
||||
```
|
||||
|
||||
3. Añade el tema a tu configuración creando un nuevo archivo `config/_default/module.toml` y añadiendo lo siguiente:
|
||||
|
||||
```toml
|
||||
[[imports]]
|
||||
disable = false
|
||||
path = "github.com/nunocoracao/blowfish/v2"
|
||||
```
|
||||
|
||||
4. Inicia tu servidor usando `hugo server` y el tema se descargará automáticamente.
|
||||
5. Continúa para [configurar los archivos de configuración del tema](#configurar-archivos-de-configuración-del-tema).
|
||||
|
||||
#### Instalación manual
|
||||
|
||||
1. Descarga la última versión del código fuente del tema.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Descargar desde Github{{< /button >}}
|
||||
|
||||
2. Extrae el archivo, renombra la carpeta a `blowfish` y muévela al directorio `themes/` dentro de la carpeta raíz de tu proyecto Hugo.
|
||||
3. Continúa para [configurar los archivos de configuración del tema](#configurar-archivos-de-configuración-del-tema).
|
||||
|
||||
#### Configurar archivos de configuración del tema
|
||||
|
||||
En la carpeta raíz de tu sitio, elimina el archivo `hugo.toml` que fue generado por Hugo. Copia los archivos de configuración `*.toml` del tema en tu carpeta `config/_default/`. Esto asegurará que tengas todas las configuraciones correctas del tema y te permitirá personalizar fácilmente el tema según tus necesidades.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** ¡No debes sobrescribir el archivo `module.toml` si ya existe uno en tu proyecto!
|
||||
{{< /alert >}}
|
||||
|
||||
Dependiendo de cómo instalaste el tema, encontrarás los archivos de configuración del tema en diferentes lugares:
|
||||
|
||||
- **Módulos Hugo:** En el directorio de caché de Hugo, o [descarga una copia](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) desde GitHub
|
||||
- **Submódulo Git o instalación manual:** `themes/blowfish/config/_default`
|
||||
|
||||
Una vez que hayas copiado los archivos, tu carpeta de configuración debería verse así:
|
||||
|
||||
```shell
|
||||
config/_default/
|
||||
├─ hugo.toml
|
||||
├─ languages.en.toml
|
||||
├─ markup.toml
|
||||
├─ menus.en.toml
|
||||
├─ module.toml # si instalaste usando Módulos Hugo
|
||||
└─ params.toml
|
||||
```
|
||||
|
||||
{{< alert >}}
|
||||
**Importante:** Si no usaste Módulos Hugo para instalar Blowfish, debes añadir la línea `theme = "blowfish"` en la parte superior de tu archivo `hugo.toml`.
|
||||
{{< /alert >}}
|
||||
|
||||
### Siguientes pasos
|
||||
|
||||
La instalación básica de Blowfish está ahora completa. Continúa a la sección [Primeros Pasos]({{< ref "getting-started" >}}) para aprender más sobre la configuración del tema.
|
||||
|
||||
---
|
||||
|
||||
## Instalación de actualizaciones
|
||||
|
||||
De vez en cuando se publicarán [nuevas versiones](https://github.com/nunocoracao/blowfish/releases) que aplican correcciones y añaden nuevas funcionalidades al tema. Para aprovechar estos cambios, necesitarás actualizar los archivos del tema en tu sitio.
|
||||
|
||||
Cómo hagas esto dependerá del método de instalación que elegiste cuando se instaló originalmente el tema. Las instrucciones para cada método se encuentran a continuación.
|
||||
|
||||
- [Submódulo Git](#actualización-con-git)
|
||||
- [Módulo Hugo](#actualización-con-hugo)
|
||||
- [Copia manual de archivos](#actualización-manual)
|
||||
|
||||
### Actualización con Git
|
||||
|
||||
Los submódulos Git se pueden actualizar usando el comando `git`. Simplemente ejecuta el siguiente comando y la última versión del tema se descargará en tu repositorio local:
|
||||
|
||||
```shell
|
||||
git submodule update --remote --merge
|
||||
```
|
||||
|
||||
Una vez que el submódulo se haya actualizado, reconstruye tu sitio y verifica que todo funcione como se esperaba.
|
||||
|
||||
### Actualización con Hugo
|
||||
|
||||
Hugo hace que actualizar módulos sea super fácil. Simplemente cambia a tu directorio de proyecto y ejecuta el siguiente comando:
|
||||
|
||||
```shell
|
||||
hugo mod get -u
|
||||
```
|
||||
|
||||
Hugo actualizará automáticamente cualquier módulo requerido para tu proyecto. Lo hace inspeccionando tus archivos `module.toml` y `go.mod`. Si tienes problemas con la actualización, verifica que estos archivos todavía estén configurados correctamente.
|
||||
|
||||
Luego simplemente reconstruye tu sitio y verifica que todo funcione como se esperaba.
|
||||
|
||||
### Actualización manual
|
||||
|
||||
Actualizar Blowfish manualmente requiere que descargues la última copia del tema y reemplaces la versión antigua en tu proyecto.
|
||||
|
||||
{{< alert >}}
|
||||
Ten en cuenta que cualquier personalización local que hayas hecho a los archivos del tema se perderá durante este proceso.
|
||||
{{< /alert >}}
|
||||
|
||||
1. Descarga la última versión del código fuente del tema.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Descargar desde Github{{< /button >}}
|
||||
|
||||
2. Extrae el archivo, renombra la carpeta a `blowfish` y muévela al directorio `themes/` dentro de la carpeta raíz de tu proyecto Hugo. Necesitarás sobrescribir el directorio existente para reemplazar todos los archivos del tema.
|
||||
|
||||
3. Reconstruye tu sitio y verifica que todo funcione como se esperaba.
|
||||
211
exampleSite/content/docs/installation/index.fr.md
Normal file
211
exampleSite/content/docs/installation/index.fr.md
Normal file
@@ -0,0 +1,211 @@
|
||||
---
|
||||
title: "Installation"
|
||||
weight: 2
|
||||
draft: false
|
||||
description: "Comment installer le thème Blowfish."
|
||||
slug: "installation"
|
||||
tags: ["installation", "documentation"]
|
||||
series: ["Documentation"]
|
||||
series_order: 2
|
||||
---
|
||||
|
||||
Suivez simplement la procédure standard Hugo [Démarrage Rapide](https://gohugo.io/getting-started/quick-start/) pour être opérationnel rapidement.
|
||||
|
||||
Des instructions d'installation détaillées sont disponibles ci-dessous. Des instructions pour [mettre à jour le thème](#installation-des-mises-à-jour) sont également disponibles.
|
||||
|
||||
## Installation
|
||||
|
||||
Ces instructions vous permettront de démarrer avec Hugo et Blowfish à partir d'un état complètement vierge. La plupart des dépendances mentionnées dans ce guide peuvent être installées à l'aide du gestionnaire de paquets de votre choix pour votre plateforme.
|
||||
|
||||
### Installer Hugo
|
||||
|
||||
Si vous n'avez jamais utilisé Hugo auparavant, vous devrez [l'installer sur votre machine locale](https://gohugo.io/getting-started/installing). Vous pouvez vérifier s'il est déjà installé en exécutant la commande `hugo version`.
|
||||
|
||||
{{< alert >}}
|
||||
Assurez-vous d'utiliser **Hugo version 0.87.0** ou ultérieure car le thème tire parti de certaines des dernières fonctionnalités de Hugo.
|
||||
{{< /alert >}}
|
||||
|
||||
Vous pouvez trouver des instructions d'installation détaillées pour votre plateforme dans la [documentation Hugo](https://gohugo.io/getting-started/installing).
|
||||
|
||||
### Blowfish Tools (recommandé)
|
||||
|
||||
Nous venons de lancer un nouvel outil CLI pour vous aider à démarrer avec Blowfish. Il créera un nouveau projet Hugo, installera le thème et configurera les fichiers de configuration du thème pour vous. Il est encore en bêta, veuillez donc [signaler tout problème que vous rencontrez](https://github.com/nunocoracao/blowfish-tools).
|
||||
|
||||
Installez l'outil CLI globalement en utilisant npm (ou un autre gestionnaire de paquets) :
|
||||
```shell
|
||||
npx blowfish-tools
|
||||
```
|
||||
ou
|
||||
|
||||
```shell
|
||||
npm i -g blowfish-tools
|
||||
```
|
||||
|
||||
Exécutez ensuite la commande `blowfish-tools` pour démarrer une exécution interactive qui vous guidera à travers les cas d'utilisation de création et de configuration.
|
||||
```shell
|
||||
blowfish-tools
|
||||
```
|
||||
|
||||
Vous pouvez également exécuter la commande `blowfish-tools new` pour créer un nouveau projet Hugo et installer le thème en une seule fois. Consultez l'aide CLI pour plus d'informations.
|
||||
```shell
|
||||
blowfish-tools new mynewsite
|
||||
```
|
||||
|
||||
Voici une courte vidéo montrant à quelle vitesse vous pouvez démarrer avec Blowfish en utilisant l'outil CLI :
|
||||
|
||||
<iframe width="100%" height="350" src="https://www.youtube.com/embed/SgXhGb-7QbU?si=ce44baicuQ6zMeXz" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
|
||||
|
||||
### Installation sans CLI
|
||||
|
||||
#### Créer un nouveau site
|
||||
|
||||
Exécutez la commande `hugo new site mywebsite` pour créer un nouveau site Hugo dans un répertoire nommé `mywebsite`.
|
||||
|
||||
Notez que vous pouvez nommer le répertoire du projet comme vous le souhaitez, mais les instructions ci-dessous supposent qu'il s'appelle `mywebsite`. Si vous utilisez un autre nom, assurez-vous de le remplacer en conséquence.
|
||||
|
||||
#### Télécharger le thème Blowfish
|
||||
|
||||
Il existe plusieurs façons d'installer le thème Blowfish dans votre site Hugo. De la plus facile à la plus difficile à installer et à maintenir, ce sont :
|
||||
|
||||
- [Sous-module Git](#installation-avec-git) (recommandé)
|
||||
- [Module Hugo](#installation-avec-hugo)
|
||||
- [Copie manuelle des fichiers](#installation-manuelle)
|
||||
|
||||
Si vous n'êtes pas sûr, choisissez la méthode du sous-module Git.
|
||||
|
||||
#### Installation avec Git
|
||||
|
||||
Cette méthode est la plus rapide et la plus facile pour maintenir le thème à jour. En plus de **Hugo** et **Go**, vous devez également vous assurer que **Git** est installé sur votre machine locale.
|
||||
|
||||
Accédez au répertoire de votre site Hugo (que vous avez créé ci-dessus), initialisez un nouveau dépôt `git` et ajoutez Blowfish comme sous-module.
|
||||
|
||||
```bash
|
||||
cd mywebsite
|
||||
git init
|
||||
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
||||
```
|
||||
|
||||
Continuez ensuite à [configurer les fichiers de configuration du thème](#configurer-les-fichiers-de-configuration-du-thème).
|
||||
|
||||
#### Installation avec Hugo
|
||||
|
||||
Pour cette méthode, vous utiliserez Hugo pour gérer vos thèmes. Hugo utilise **Go** pour initialiser et gérer les modules, assurez-vous donc d'avoir `go` installé avant de continuer.
|
||||
|
||||
1. [Téléchargez](https://golang.org/dl/) et installez Go. Vous pouvez vérifier s'il est déjà installé en utilisant la commande `go version`.
|
||||
|
||||
{{< alert >}}
|
||||
Assurez-vous d'utiliser **Go version 1.12** ou ultérieure car Hugo l'exige pour que les modules fonctionnent correctement.
|
||||
{{< /alert >}}
|
||||
|
||||
2. Depuis le répertoire de votre projet Hugo (que vous avez créé ci-dessus), initialisez les modules pour votre site :
|
||||
|
||||
```shell
|
||||
# Si vous gérez votre projet sur GitHub
|
||||
hugo mod init github.com/<username>/<repo-name>
|
||||
|
||||
# Si vous gérez votre projet localement
|
||||
hugo mod init my-project
|
||||
```
|
||||
|
||||
3. Ajoutez le thème à votre configuration en créant un nouveau fichier `config/_default/module.toml` et en ajoutant ce qui suit :
|
||||
|
||||
```toml
|
||||
[[imports]]
|
||||
disable = false
|
||||
path = "github.com/nunocoracao/blowfish/v2"
|
||||
```
|
||||
|
||||
4. Démarrez votre serveur en utilisant `hugo server` et le thème sera téléchargé automatiquement.
|
||||
5. Continuez à [configurer les fichiers de configuration du thème](#configurer-les-fichiers-de-configuration-du-thème).
|
||||
|
||||
#### Installation manuelle
|
||||
|
||||
1. Téléchargez la dernière version du code source du thème.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Télécharger depuis Github{{< /button >}}
|
||||
|
||||
2. Extrayez l'archive, renommez le dossier en `blowfish` et déplacez-le dans le répertoire `themes/` à l'intérieur du dossier racine de votre projet Hugo.
|
||||
3. Continuez à [configurer les fichiers de configuration du thème](#configurer-les-fichiers-de-configuration-du-thème).
|
||||
|
||||
#### Configurer les fichiers de configuration du thème
|
||||
|
||||
Dans le dossier racine de votre site, supprimez le fichier `hugo.toml` qui a été généré par Hugo. Copiez les fichiers de configuration `*.toml` du thème dans votre dossier `config/_default/`. Cela garantira que vous avez tous les paramètres de thème corrects et vous permettra de personnaliser facilement le thème selon vos besoins.
|
||||
|
||||
{{< alert >}}
|
||||
**Note :** Vous ne devez pas écraser le fichier `module.toml` si un existe déjà dans votre projet !
|
||||
{{< /alert >}}
|
||||
|
||||
Selon la façon dont vous avez installé le thème, vous trouverez les fichiers de configuration du thème à différents endroits :
|
||||
|
||||
- **Modules Hugo :** Dans le répertoire de cache Hugo, ou [téléchargez une copie](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) depuis GitHub
|
||||
- **Sous-module Git ou installation manuelle :** `themes/blowfish/config/_default`
|
||||
|
||||
Une fois que vous avez copié les fichiers, votre dossier de configuration devrait ressembler à ceci :
|
||||
|
||||
```shell
|
||||
config/_default/
|
||||
├─ hugo.toml
|
||||
├─ languages.en.toml
|
||||
├─ markup.toml
|
||||
├─ menus.en.toml
|
||||
├─ module.toml # si vous avez installé en utilisant les modules Hugo
|
||||
└─ params.toml
|
||||
```
|
||||
|
||||
{{< alert >}}
|
||||
**Important :** Si vous n'avez pas utilisé les modules Hugo pour installer Blowfish, vous devez ajouter la ligne `theme = "blowfish"` en haut de votre fichier `hugo.toml`.
|
||||
{{< /alert >}}
|
||||
|
||||
### Étapes suivantes
|
||||
|
||||
L'installation de base de Blowfish est maintenant terminée. Continuez vers la section [Premiers Pas]({{< ref "getting-started" >}}) pour en savoir plus sur la configuration du thème.
|
||||
|
||||
---
|
||||
|
||||
## Installation des mises à jour
|
||||
|
||||
De temps en temps, de [nouvelles versions](https://github.com/nunocoracao/blowfish/releases) seront publiées avec des corrections de bugs et de nouvelles fonctionnalités pour le thème. Pour profiter de ces changements, vous devrez mettre à jour les fichiers du thème sur votre site.
|
||||
|
||||
La façon de procéder dépendra de la méthode d'installation que vous avez choisie lors de l'installation initiale du thème. Les instructions pour chaque méthode sont disponibles ci-dessous.
|
||||
|
||||
- [Sous-module Git](#mise-à-jour-avec-git)
|
||||
- [Module Hugo](#mise-à-jour-avec-hugo)
|
||||
- [Copie manuelle des fichiers](#mise-à-jour-manuelle)
|
||||
|
||||
### Mise à jour avec Git
|
||||
|
||||
Les sous-modules Git peuvent être mis à jour en utilisant la commande `git`. Exécutez simplement la commande suivante et la dernière version du thème sera téléchargée dans votre dépôt local :
|
||||
|
||||
```shell
|
||||
git submodule update --remote --merge
|
||||
```
|
||||
|
||||
Une fois le sous-module mis à jour, reconstruisez votre site et vérifiez que tout fonctionne comme prévu.
|
||||
|
||||
### Mise à jour avec Hugo
|
||||
|
||||
Hugo rend la mise à jour des modules super facile. Accédez simplement à votre répertoire de projet et exécutez la commande suivante :
|
||||
|
||||
```shell
|
||||
hugo mod get -u
|
||||
```
|
||||
|
||||
Hugo mettra automatiquement à jour tous les modules requis pour votre projet. Il le fait en inspectant vos fichiers `module.toml` et `go.mod`. Si vous avez des problèmes avec la mise à jour, vérifiez que ces fichiers sont toujours configurés correctement.
|
||||
|
||||
Reconstruisez ensuite simplement votre site et vérifiez que tout fonctionne comme prévu.
|
||||
|
||||
### Mise à jour manuelle
|
||||
|
||||
La mise à jour manuelle de Blowfish nécessite de télécharger la dernière copie du thème et de remplacer l'ancienne version dans votre projet.
|
||||
|
||||
{{< alert >}}
|
||||
Notez que toutes les personnalisations locales que vous avez apportées aux fichiers du thème seront perdues au cours de ce processus.
|
||||
{{< /alert >}}
|
||||
|
||||
1. Téléchargez la dernière version du code source du thème.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Télécharger depuis Github{{< /button >}}
|
||||
|
||||
2. Extrayez l'archive, renommez le dossier en `blowfish` et déplacez-le dans le répertoire `themes/` à l'intérieur du dossier racine de votre projet Hugo. Vous devrez écraser le répertoire existant pour remplacer tous les fichiers du thème.
|
||||
|
||||
3. Reconstruisez votre site et vérifiez que tout fonctionne comme prévu.
|
||||
211
exampleSite/content/docs/installation/index.pt-br.md
Normal file
211
exampleSite/content/docs/installation/index.pt-br.md
Normal file
@@ -0,0 +1,211 @@
|
||||
---
|
||||
title: "Instalação"
|
||||
weight: 2
|
||||
draft: false
|
||||
description: "Como instalar o tema Blowfish."
|
||||
slug: "installation"
|
||||
tags: ["instalação", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 2
|
||||
---
|
||||
|
||||
Simplesmente siga o procedimento padrão do Hugo [Início Rápido](https://gohugo.io/getting-started/quick-start/) para começar rapidamente.
|
||||
|
||||
Instruções detalhadas de instalação podem ser encontradas abaixo. Instruções para [atualizar o tema](#instalando-atualizações) também estão disponíveis.
|
||||
|
||||
## Instalação
|
||||
|
||||
Estas instruções vão te ajudar a começar com Hugo e Blowfish a partir de um estado completamente vazio. A maioria das dependências mencionadas neste guia pode ser instalada usando o gerenciador de pacotes de sua escolha para sua plataforma.
|
||||
|
||||
### Instalar Hugo
|
||||
|
||||
Se você nunca usou Hugo antes, precisará [instalá-lo em sua máquina local](https://gohugo.io/getting-started/installing). Você pode verificar se já está instalado executando o comando `hugo version`.
|
||||
|
||||
{{< alert >}}
|
||||
Certifique-se de estar usando **Hugo versão 0.87.0** ou posterior, pois o tema aproveita alguns dos recursos mais recentes do Hugo.
|
||||
{{< /alert >}}
|
||||
|
||||
Você pode encontrar instruções de instalação detalhadas para sua plataforma na [documentação do Hugo](https://gohugo.io/getting-started/installing).
|
||||
|
||||
### Blowfish Tools (recomendado)
|
||||
|
||||
Acabamos de lançar uma nova ferramenta CLI para ajudá-lo a começar com o Blowfish. Ela criará um novo projeto Hugo, instalará o tema e configurará os arquivos de configuração do tema para você. Ainda está em beta, então por favor [reporte quaisquer problemas que encontrar](https://github.com/nunocoracao/blowfish-tools).
|
||||
|
||||
Instale a ferramenta CLI globalmente usando npm (ou outro gerenciador de pacotes):
|
||||
```shell
|
||||
npx blowfish-tools
|
||||
```
|
||||
ou
|
||||
|
||||
```shell
|
||||
npm i -g blowfish-tools
|
||||
```
|
||||
|
||||
Em seguida, execute o comando `blowfish-tools` para iniciar uma execução interativa que irá guiá-lo através dos casos de uso de criação e configuração.
|
||||
```shell
|
||||
blowfish-tools
|
||||
```
|
||||
|
||||
Você também pode executar o comando `blowfish-tools new` para criar um novo projeto Hugo e instalar o tema de uma só vez. Verifique a ajuda do CLI para mais informações.
|
||||
```shell
|
||||
blowfish-tools new mynewsite
|
||||
```
|
||||
|
||||
Aqui está um vídeo curto de quão rápido é começar com o Blowfish usando a ferramenta CLI:
|
||||
|
||||
<iframe width="100%" height="350" src="https://www.youtube.com/embed/SgXhGb-7QbU?si=ce44baicuQ6zMeXz" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
|
||||
|
||||
### Instalação sem CLI
|
||||
|
||||
#### Criar um novo site
|
||||
|
||||
Execute o comando `hugo new site mywebsite` para criar um novo site Hugo em um diretório chamado `mywebsite`.
|
||||
|
||||
Note que você pode nomear o diretório do projeto como quiser, mas as instruções abaixo assumem que ele se chama `mywebsite`. Se você usar um nome diferente, certifique-se de substituí-lo adequadamente.
|
||||
|
||||
#### Baixar o tema Blowfish
|
||||
|
||||
Existem várias maneiras diferentes de instalar o tema Blowfish em seu site Hugo. Da mais fácil para a mais difícil de instalar e manter, são:
|
||||
|
||||
- [Submódulo Git](#instalação-com-git) (recomendado)
|
||||
- [Módulo Hugo](#instalação-com-hugo)
|
||||
- [Cópia manual de arquivos](#instalação-manual)
|
||||
|
||||
Se você não tem certeza, escolha o método do submódulo Git.
|
||||
|
||||
#### Instalação com Git
|
||||
|
||||
Este método é o mais rápido e fácil para manter o tema atualizado. Além do **Hugo** e **Go**, você também precisará garantir que o **Git** esteja instalado em sua máquina local.
|
||||
|
||||
Mude para o diretório do seu site Hugo (que você criou acima), inicialize um novo repositório `git` e adicione o Blowfish como submódulo.
|
||||
|
||||
```bash
|
||||
cd mywebsite
|
||||
git init
|
||||
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
||||
```
|
||||
|
||||
Em seguida, continue para [configurar os arquivos de configuração do tema](#configurar-arquivos-de-configuração-do-tema).
|
||||
|
||||
#### Instalação com Hugo
|
||||
|
||||
Para este método, você usará o Hugo para gerenciar seus temas. O Hugo usa **Go** para inicializar e gerenciar módulos, então certifique-se de ter o `go` instalado antes de prosseguir.
|
||||
|
||||
1. [Baixe](https://golang.org/dl/) e instale o Go. Você pode verificar se já está instalado usando o comando `go version`.
|
||||
|
||||
{{< alert >}}
|
||||
Certifique-se de estar usando **Go versão 1.12** ou posterior, pois o Hugo exige isso para que os módulos funcionem corretamente.
|
||||
{{< /alert >}}
|
||||
|
||||
2. Do diretório do seu projeto Hugo (que você criou acima), inicialize os módulos para seu site:
|
||||
|
||||
```shell
|
||||
# Se você está gerenciando seu projeto no GitHub
|
||||
hugo mod init github.com/<username>/<repo-name>
|
||||
|
||||
# Se você está gerenciando seu projeto localmente
|
||||
hugo mod init my-project
|
||||
```
|
||||
|
||||
3. Adicione o tema à sua configuração criando um novo arquivo `config/_default/module.toml` e adicionando o seguinte:
|
||||
|
||||
```toml
|
||||
[[imports]]
|
||||
disable = false
|
||||
path = "github.com/nunocoracao/blowfish/v2"
|
||||
```
|
||||
|
||||
4. Inicie seu servidor usando `hugo server` e o tema será baixado automaticamente.
|
||||
5. Continue para [configurar os arquivos de configuração do tema](#configurar-arquivos-de-configuração-do-tema).
|
||||
|
||||
#### Instalação manual
|
||||
|
||||
1. Baixe a versão mais recente do código-fonte do tema.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Baixar do Github{{< /button >}}
|
||||
|
||||
2. Extraia o arquivo, renomeie a pasta para `blowfish` e mova-a para o diretório `themes/` dentro da pasta raiz do seu projeto Hugo.
|
||||
3. Continue para [configurar os arquivos de configuração do tema](#configurar-arquivos-de-configuração-do-tema).
|
||||
|
||||
#### Configurar arquivos de configuração do tema
|
||||
|
||||
Na pasta raiz do seu site, exclua o arquivo `hugo.toml` que foi gerado pelo Hugo. Copie os arquivos de configuração `*.toml` do tema para sua pasta `config/_default/`. Isso garantirá que você tenha todas as configurações corretas do tema e permitirá personalizar facilmente o tema de acordo com suas necessidades.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** Você não deve sobrescrever o arquivo `module.toml` se já existir um em seu projeto!
|
||||
{{< /alert >}}
|
||||
|
||||
Dependendo de como você instalou o tema, você encontrará os arquivos de configuração do tema em lugares diferentes:
|
||||
|
||||
- **Módulos Hugo:** No diretório de cache do Hugo, ou [baixe uma cópia](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) do GitHub
|
||||
- **Submódulo Git ou instalação manual:** `themes/blowfish/config/_default`
|
||||
|
||||
Depois de copiar os arquivos, sua pasta de configuração deve ficar assim:
|
||||
|
||||
```shell
|
||||
config/_default/
|
||||
├─ hugo.toml
|
||||
├─ languages.en.toml
|
||||
├─ markup.toml
|
||||
├─ menus.en.toml
|
||||
├─ module.toml # se você instalou usando Módulos Hugo
|
||||
└─ params.toml
|
||||
```
|
||||
|
||||
{{< alert >}}
|
||||
**Importante:** Se você não usou Módulos Hugo para instalar o Blowfish, você deve adicionar a linha `theme = "blowfish"` no topo do seu arquivo `hugo.toml`.
|
||||
{{< /alert >}}
|
||||
|
||||
### Próximos passos
|
||||
|
||||
A instalação básica do Blowfish está agora completa. Continue para a seção [Primeiros Passos]({{< ref "getting-started" >}}) para saber mais sobre a configuração do tema.
|
||||
|
||||
---
|
||||
|
||||
## Instalando atualizações
|
||||
|
||||
De tempos em tempos, [novas versões](https://github.com/nunocoracao/blowfish/releases) serão publicadas que aplicam correções e adicionam novas funcionalidades ao tema. Para aproveitar essas mudanças, você precisará atualizar os arquivos do tema em seu site.
|
||||
|
||||
Como você fará isso dependerá do método de instalação que você escolheu quando o tema foi originalmente instalado. Instruções para cada método podem ser encontradas abaixo.
|
||||
|
||||
- [Submódulo Git](#atualização-com-git)
|
||||
- [Módulo Hugo](#atualização-com-hugo)
|
||||
- [Cópia manual de arquivos](#atualização-manual)
|
||||
|
||||
### Atualização com Git
|
||||
|
||||
Submódulos Git podem ser atualizados usando o comando `git`. Simplesmente execute o seguinte comando e a versão mais recente do tema será baixada em seu repositório local:
|
||||
|
||||
```shell
|
||||
git submodule update --remote --merge
|
||||
```
|
||||
|
||||
Depois que o submódulo for atualizado, reconstrua seu site e verifique se tudo funciona como esperado.
|
||||
|
||||
### Atualização com Hugo
|
||||
|
||||
O Hugo torna a atualização de módulos super fácil. Simplesmente mude para o diretório do seu projeto e execute o seguinte comando:
|
||||
|
||||
```shell
|
||||
hugo mod get -u
|
||||
```
|
||||
|
||||
O Hugo atualizará automaticamente quaisquer módulos necessários para seu projeto. Ele faz isso inspecionando seus arquivos `module.toml` e `go.mod`. Se você tiver problemas com a atualização, verifique se esses arquivos ainda estão configurados corretamente.
|
||||
|
||||
Em seguida, simplesmente reconstrua seu site e verifique se tudo funciona como esperado.
|
||||
|
||||
### Atualização manual
|
||||
|
||||
Atualizar o Blowfish manualmente requer que você baixe a cópia mais recente do tema e substitua a versão antiga em seu projeto.
|
||||
|
||||
{{< alert >}}
|
||||
Note que quaisquer personalizações locais que você tenha feito nos arquivos do tema serão perdidas durante este processo.
|
||||
{{< /alert >}}
|
||||
|
||||
1. Baixe a versão mais recente do código-fonte do tema.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Baixar do Github{{< /button >}}
|
||||
|
||||
2. Extraia o arquivo, renomeie a pasta para `blowfish` e mova-a para o diretório `themes/` dentro da pasta raiz do seu projeto Hugo. Você precisará sobrescrever o diretório existente para substituir todos os arquivos do tema.
|
||||
|
||||
3. Reconstrua seu site e verifique se tudo funciona como esperado.
|
||||
211
exampleSite/content/docs/installation/index.pt-pt.md
Normal file
211
exampleSite/content/docs/installation/index.pt-pt.md
Normal file
@@ -0,0 +1,211 @@
|
||||
---
|
||||
title: "Instalação"
|
||||
weight: 2
|
||||
draft: false
|
||||
description: "Como instalar o tema Blowfish."
|
||||
slug: "installation"
|
||||
tags: ["instalação", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 2
|
||||
---
|
||||
|
||||
Simplesmente siga o procedimento padrão do Hugo [Início Rápido](https://gohugo.io/getting-started/quick-start/) para começar rapidamente.
|
||||
|
||||
Instruções detalhadas de instalação podem ser encontradas abaixo. Instruções para [atualizar o tema](#instalar-atualizações) também estão disponíveis.
|
||||
|
||||
## Instalação
|
||||
|
||||
Estas instruções irão ajudá-lo a começar com Hugo e Blowfish a partir de um estado completamente vazio. A maioria das dependências mencionadas neste guia pode ser instalada utilizando o gestor de pacotes da sua escolha para a sua plataforma.
|
||||
|
||||
### Instalar Hugo
|
||||
|
||||
Se nunca utilizou Hugo antes, precisará de [instalá-lo na sua máquina local](https://gohugo.io/getting-started/installing). Pode verificar se já está instalado executando o comando `hugo version`.
|
||||
|
||||
{{< alert >}}
|
||||
Certifique-se de que está a utilizar **Hugo versão 0.87.0** ou posterior, pois o tema aproveita algumas das funcionalidades mais recentes do Hugo.
|
||||
{{< /alert >}}
|
||||
|
||||
Pode encontrar instruções de instalação detalhadas para a sua plataforma na [documentação do Hugo](https://gohugo.io/getting-started/installing).
|
||||
|
||||
### Blowfish Tools (recomendado)
|
||||
|
||||
Acabámos de lançar uma nova ferramenta CLI para o ajudar a começar com o Blowfish. Irá criar um novo projeto Hugo, instalar o tema e configurar os ficheiros de configuração do tema por si. Ainda está em beta, por isso [reporte quaisquer problemas que encontrar](https://github.com/nunocoracao/blowfish-tools).
|
||||
|
||||
Instale a ferramenta CLI globalmente utilizando npm (ou outro gestor de pacotes):
|
||||
```shell
|
||||
npx blowfish-tools
|
||||
```
|
||||
ou
|
||||
|
||||
```shell
|
||||
npm i -g blowfish-tools
|
||||
```
|
||||
|
||||
Em seguida, execute o comando `blowfish-tools` para iniciar uma execução interativa que o guiará através dos casos de uso de criação e configuração.
|
||||
```shell
|
||||
blowfish-tools
|
||||
```
|
||||
|
||||
Também pode executar o comando `blowfish-tools new` para criar um novo projeto Hugo e instalar o tema de uma só vez. Consulte a ajuda do CLI para mais informações.
|
||||
```shell
|
||||
blowfish-tools new mynewsite
|
||||
```
|
||||
|
||||
Aqui está um vídeo curto de quão rápido é começar com o Blowfish utilizando a ferramenta CLI:
|
||||
|
||||
<iframe width="100%" height="350" src="https://www.youtube.com/embed/SgXhGb-7QbU?si=ce44baicuQ6zMeXz" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
|
||||
|
||||
### Instalação sem CLI
|
||||
|
||||
#### Criar um novo site
|
||||
|
||||
Execute o comando `hugo new site mywebsite` para criar um novo site Hugo num diretório chamado `mywebsite`.
|
||||
|
||||
Note que pode nomear o diretório do projeto como quiser, mas as instruções abaixo assumem que se chama `mywebsite`. Se utilizar um nome diferente, certifique-se de o substituir adequadamente.
|
||||
|
||||
#### Transferir o tema Blowfish
|
||||
|
||||
Existem várias formas diferentes de instalar o tema Blowfish no seu site Hugo. Da mais fácil para a mais difícil de instalar e manter, são:
|
||||
|
||||
- [Submódulo Git](#instalação-com-git) (recomendado)
|
||||
- [Módulo Hugo](#instalação-com-hugo)
|
||||
- [Cópia manual de ficheiros](#instalação-manual)
|
||||
|
||||
Se não tem a certeza, escolha o método do submódulo Git.
|
||||
|
||||
#### Instalação com Git
|
||||
|
||||
Este método é o mais rápido e fácil para manter o tema atualizado. Além do **Hugo** e **Go**, também precisará de garantir que o **Git** está instalado na sua máquina local.
|
||||
|
||||
Mude para o diretório do seu site Hugo (que criou acima), inicialize um novo repositório `git` e adicione o Blowfish como submódulo.
|
||||
|
||||
```bash
|
||||
cd mywebsite
|
||||
git init
|
||||
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
||||
```
|
||||
|
||||
Em seguida, continue para [configurar os ficheiros de configuração do tema](#configurar-ficheiros-de-configuração-do-tema).
|
||||
|
||||
#### Instalação com Hugo
|
||||
|
||||
Para este método, utilizará o Hugo para gerir os seus temas. O Hugo utiliza **Go** para inicializar e gerir módulos, por isso certifique-se de ter o `go` instalado antes de prosseguir.
|
||||
|
||||
1. [Transfira](https://golang.org/dl/) e instale o Go. Pode verificar se já está instalado utilizando o comando `go version`.
|
||||
|
||||
{{< alert >}}
|
||||
Certifique-se de que está a utilizar **Go versão 1.12** ou posterior, pois o Hugo exige isto para que os módulos funcionem corretamente.
|
||||
{{< /alert >}}
|
||||
|
||||
2. A partir do diretório do seu projeto Hugo (que criou acima), inicialize os módulos para o seu site:
|
||||
|
||||
```shell
|
||||
# Se está a gerir o seu projeto no GitHub
|
||||
hugo mod init github.com/<username>/<repo-name>
|
||||
|
||||
# Se está a gerir o seu projeto localmente
|
||||
hugo mod init my-project
|
||||
```
|
||||
|
||||
3. Adicione o tema à sua configuração criando um novo ficheiro `config/_default/module.toml` e adicionando o seguinte:
|
||||
|
||||
```toml
|
||||
[[imports]]
|
||||
disable = false
|
||||
path = "github.com/nunocoracao/blowfish/v2"
|
||||
```
|
||||
|
||||
4. Inicie o seu servidor utilizando `hugo server` e o tema será transferido automaticamente.
|
||||
5. Continue para [configurar os ficheiros de configuração do tema](#configurar-ficheiros-de-configuração-do-tema).
|
||||
|
||||
#### Instalação manual
|
||||
|
||||
1. Transfira a versão mais recente do código-fonte do tema.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Transferir do Github{{< /button >}}
|
||||
|
||||
2. Extraia o arquivo, renomeie a pasta para `blowfish` e mova-a para o diretório `themes/` dentro da pasta raiz do seu projeto Hugo.
|
||||
3. Continue para [configurar os ficheiros de configuração do tema](#configurar-ficheiros-de-configuração-do-tema).
|
||||
|
||||
#### Configurar ficheiros de configuração do tema
|
||||
|
||||
Na pasta raiz do seu site, elimine o ficheiro `hugo.toml` que foi gerado pelo Hugo. Copie os ficheiros de configuração `*.toml` do tema para a sua pasta `config/_default/`. Isto garantirá que tem todas as configurações corretas do tema e permitirá personalizar facilmente o tema de acordo com as suas necessidades.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** Não deve sobrescrever o ficheiro `module.toml` se já existir um no seu projeto!
|
||||
{{< /alert >}}
|
||||
|
||||
Dependendo de como instalou o tema, encontrará os ficheiros de configuração do tema em locais diferentes:
|
||||
|
||||
- **Módulos Hugo:** No diretório de cache do Hugo, ou [transfira uma cópia](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) do GitHub
|
||||
- **Submódulo Git ou instalação manual:** `themes/blowfish/config/_default`
|
||||
|
||||
Depois de copiar os ficheiros, a sua pasta de configuração deve ficar assim:
|
||||
|
||||
```shell
|
||||
config/_default/
|
||||
├─ hugo.toml
|
||||
├─ languages.en.toml
|
||||
├─ markup.toml
|
||||
├─ menus.en.toml
|
||||
├─ module.toml # se instalou utilizando Módulos Hugo
|
||||
└─ params.toml
|
||||
```
|
||||
|
||||
{{< alert >}}
|
||||
**Importante:** Se não utilizou Módulos Hugo para instalar o Blowfish, deve adicionar a linha `theme = "blowfish"` no topo do seu ficheiro `hugo.toml`.
|
||||
{{< /alert >}}
|
||||
|
||||
### Próximos passos
|
||||
|
||||
A instalação básica do Blowfish está agora completa. Continue para a secção [Primeiros Passos]({{< ref "getting-started" >}}) para saber mais sobre a configuração do tema.
|
||||
|
||||
---
|
||||
|
||||
## Instalar atualizações
|
||||
|
||||
De tempos a tempos, [novas versões](https://github.com/nunocoracao/blowfish/releases) serão publicadas que aplicam correções e adicionam novas funcionalidades ao tema. Para tirar partido destas alterações, precisará de atualizar os ficheiros do tema no seu site.
|
||||
|
||||
Como fará isto dependerá do método de instalação que escolheu quando o tema foi originalmente instalado. Instruções para cada método podem ser encontradas abaixo.
|
||||
|
||||
- [Submódulo Git](#atualização-com-git)
|
||||
- [Módulo Hugo](#atualização-com-hugo)
|
||||
- [Cópia manual de ficheiros](#atualização-manual)
|
||||
|
||||
### Atualização com Git
|
||||
|
||||
Submódulos Git podem ser atualizados utilizando o comando `git`. Simplesmente execute o seguinte comando e a versão mais recente do tema será transferida para o seu repositório local:
|
||||
|
||||
```shell
|
||||
git submodule update --remote --merge
|
||||
```
|
||||
|
||||
Depois de o submódulo ser atualizado, reconstrua o seu site e verifique se tudo funciona como esperado.
|
||||
|
||||
### Atualização com Hugo
|
||||
|
||||
O Hugo torna a atualização de módulos super fácil. Simplesmente mude para o diretório do seu projeto e execute o seguinte comando:
|
||||
|
||||
```shell
|
||||
hugo mod get -u
|
||||
```
|
||||
|
||||
O Hugo atualizará automaticamente quaisquer módulos necessários para o seu projeto. Faz isto inspecionando os seus ficheiros `module.toml` e `go.mod`. Se tiver problemas com a atualização, verifique se estes ficheiros ainda estão configurados corretamente.
|
||||
|
||||
Em seguida, simplesmente reconstrua o seu site e verifique se tudo funciona como esperado.
|
||||
|
||||
### Atualização manual
|
||||
|
||||
Atualizar o Blowfish manualmente requer que transfira a cópia mais recente do tema e substitua a versão antiga no seu projeto.
|
||||
|
||||
{{< alert >}}
|
||||
Note que quaisquer personalizações locais que tenha feito aos ficheiros do tema serão perdidas durante este processo.
|
||||
{{< /alert >}}
|
||||
|
||||
1. Transfira a versão mais recente do código-fonte do tema.
|
||||
|
||||
{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Transferir do Github{{< /button >}}
|
||||
|
||||
2. Extraia o arquivo, renomeie a pasta para `blowfish` e mova-a para o diretório `themes/` dentro da pasta raiz do seu projeto Hugo. Precisará de sobrescrever o diretório existente para substituir todos os ficheiros do tema.
|
||||
|
||||
3. Reconstrua o seu site e verifique se tudo funciona como esperado.
|
||||
Reference in New Issue
Block a user