From 9cecb76c4551f6076d19d56b9623a2a2b73101e5 Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Mon, 1 Apr 2024 19:44:18 +0200 Subject: [PATCH 01/34] Update index.it.md Correct some content translation --- exampleSite/content/docs/getting-started/index.it.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/exampleSite/content/docs/getting-started/index.it.md b/exampleSite/content/docs/getting-started/index.it.md index dcefb4554..bacb9122c 100644 --- a/exampleSite/content/docs/getting-started/index.it.md +++ b/exampleSite/content/docs/getting-started/index.it.md @@ -10,7 +10,7 @@ series_order: 3 --- {{< alert >}} -Questa sezione presuppone che si sia già [installato il tema Blowfish]({{< ref "docs/installation" >}}). +Questa sezione presuppone che tu abbia già [installato il tema Blowfish]({{< ref "docs/installation" >}}). {{< /alert >}}
@@ -22,9 +22,9 @@ npx blowfish-tools {{< /alert >}} -The config files that ship with Blowfish contain all of the possible settings that the theme recognises. By default, many of these are commented out but you can simply uncomment them to activate or change a specific feature. +I file di configurazione forniti con Blowfish contengono tutte le possibili impostazioni riconosciute dal tema. Per impostazione predefinita, molti di questi sono commentati ma puoi semplicemente decommentarli per attivare o modificare una funzionalità specifica. -## Basic configuration +## Configurazione di base Before creating any content, there are a few things you should set for a new installation. Starting in the `config.toml` file, set the `baseURL` and `languageCode` parameters. The `languageCode` should be set to the main language that you will be using to author your content. From cd583f86a5a2acc055d918dd73bcce59305eb500 Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Mon, 1 Apr 2024 20:34:32 +0200 Subject: [PATCH 02/34] Update index.it.md --- exampleSite/content/docs/getting-started/index.it.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/exampleSite/content/docs/getting-started/index.it.md b/exampleSite/content/docs/getting-started/index.it.md index bacb9122c..9da04d4ae 100644 --- a/exampleSite/content/docs/getting-started/index.it.md +++ b/exampleSite/content/docs/getting-started/index.it.md @@ -26,7 +26,7 @@ I file di configurazione forniti con Blowfish contengono tutte le possibili impo ## Configurazione di base -Before creating any content, there are a few things you should set for a new installation. Starting in the `config.toml` file, set the `baseURL` and `languageCode` parameters. The `languageCode` should be set to the main language that you will be using to author your content. +Prima di creare qualsiasi contenuto, è necessario impostare alcune cose per una nuova installazione. Iniziando dal file `config.toml`, imposta i parametri `baseURL` e `lingualCode`. Il `lingualCode` dovrebbe essere impostato sulla lingua principale che utilizzerai per creare i tuoi contenuti. ```toml # config/_default/config.toml @@ -35,12 +35,12 @@ baseURL = "https://your_domain.com/" languageCode = "en" ``` -The next step is to configure the language settings. Although Blowfish supports multilingual setups, for now, just configure the main language. +Il passo successivo è configurare le impostazioni della lingua. Sebbene Blowfish supporti le configurazioni multilingue, per ora basta configurare la lingua principale. -Locate the `languages.en.toml` file in the config folder. If your main language is English you can use this file as is. Otherwise, rename it so that it includes the correct language code in the filename. For example, for French, rename the file to `languages.fr.toml`. +Individua il file "languages.en.toml" nella cartella di configurazione. Se la tua lingua principale è l'inglese puoi utilizzare questo file così com'è. Altrimenti, rinominalo in modo che includa il codice della lingua corretto nel nome del file. Ad esempio, per il francese, rinominare il file in "languages.fr.toml". {{< alert >}} -Note that the language code in the language config filename should match the `languageCode` setting in `config.toml`. +Tieni presente che il codice della lingua nel nome del file di configurazione della lingua deve corrispondere all'impostazione "languageCode" in "config.toml". {{< /alert >}} ```toml From b1c138decae1002390bc09cbe2b4c732e84d8b20 Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Tue, 2 Apr 2024 19:18:57 +0200 Subject: [PATCH 03/34] Update index.it.md Update some content IT --- .../content/docs/getting-started/index.it.md | 26 +++++++++---------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/exampleSite/content/docs/getting-started/index.it.md b/exampleSite/content/docs/getting-started/index.it.md index 9da04d4ae..bcc76038a 100644 --- a/exampleSite/content/docs/getting-started/index.it.md +++ b/exampleSite/content/docs/getting-started/index.it.md @@ -57,22 +57,20 @@ links = [ { twitter = "https://twitter.com/username" } ] ``` +La configurazione `[author]` determina il modo in cui le informazioni sull'autore vengono visualizzate sul sito web. L'immagine deve essere posizionata nella cartella `assets/`. I link verranno visualizzati nell'ordine in cui sono elencati. -The `[author]` configuration determines how the author information is displayed on the website. The image should be placed in the site's `assets/` folder. Links will be displayed in the order they are listed. +Se hai bisogno di ulteriori dettagli, ulteriori informazioni su ciascuna di queste opzioni di configurazione sono trattate nella sezione [Configurazione]({{< ref "configuration" >}}). -If you need extra detail, further information about each of these configuration options, is covered in the [Configuration]({{< ref "configuration" >}}) section. +## Schemi di colori -## Colour schemes - -Blowfish ships with a number of colour schemes out of the box. To change the scheme, simply set the `colorScheme` theme parameter. Valid options are `blowfish` (default), `avocado`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, and`slate`. +Blowfish viene fornito con una serie di schemi di colori già pronti. Per cambiare lo schema, è sufficiente impostare il parametro del tema `colorScheme`. Le opzioni valide sono `blowfish` (default), `avocado`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, and`slate`. ```toml # config/_default/params.toml colorScheme = "blowfish" ``` - -Blowfish defines a three-colour palette that is used throughout the theme. Each main colour contains ten shades which are based upon the colours that are included in [Tailwind](https://tailwindcss.com/docs/customizing-colors#color-palette-reference). The three main colours are used for the header, footer, and accent colours. Here are the colors for each scheme: +Blowfish definisce una palette di tre colori che viene utilizzata in tutto il tema. Ogni colore principale contiene dieci sfumature basate sui colori inclusi in [Tailwind](https://tailwindcss.com/docs/customizing-colors#color-palette-reference). I tre colori principali sono utilizzati per l'intestazione, il piè di pagina e i colori d'accento. Ecco i colori per ogni schema: #### Blowfish (default) {{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} @@ -117,13 +115,13 @@ Blowfish defines a three-colour palette that is used throughout the theme. Each {{< swatches "#6B7280" "#64748b" "#6B7280" >}} -Although these are the default schemes, you can also create your own. Refer to the [Advanced Customisation]({{< ref "advanced-customisation#colour-schemes" >}}) section for details. +Sebbene questi siano gli schemi predefiniti, è possibile crearne di propri. Per maggiori informazioni, consultare la sezione [Personalizzazione avanzata]({{< ref "advanced-customisation#colour-schemes" >}}). -## Organising content +## Organizzazione dei contenuti -By default, Blowfish doesn't force you to use a particular content type. In doing so you are free to define your content as you wish. You might prefer _pages_ for a static site, _posts_ for a blog, or _projects_ for a portfolio. +Per impostazione predefinita, Blowfish non obbliga a utilizzare un particolare tipo di contenuto. In questo modo si è liberi di definire il contenuto come si desidera. Potreste preferire _pages_ per un sito statico, _posts_ per un blog o _projects_ per un portfolio. -Here's a quick overview of a basic Blowfish project. All content is placed within the `content` folder: +Ecco una rapida panoramica di un progetto base di Blowfish. Tutti i contenuti sono inseriti nella cartella `content`: ```shell . @@ -144,12 +142,12 @@ Here's a quick overview of a basic Blowfish project. All content is placed withi └── themes └── blowfish ``` +È importante avere una conoscenza approfondita di come Hugo si aspetta che il contenuto sia organizzato, poiché il tema è progettato per sfruttare appieno i pacchetti di pagine di Hugo. Si consiglia di leggere i [documentazione ufficiale di Hugo](https://gohugo.io/content-management/organization/) per maggiori informazioni. -It's important to have a firm grasp of how Hugo expects content to be organised as the theme is designed to take full advantage of Hugo page bundles. Be sure to read the [official Hugo docs](https://gohugo.io/content-management/organization/) for more information. -Blowfish is also flexible when it comes to taxonomies. Some people prefer to use _tags_ and _categories_ to group their content, others prefer to use _topics_. +Blowfish è flessibile anche per quanto riguarda le tassonomie. Alcuni preferiscono usare _tags_ e _categories_ per raggruppare i loro contenuti, altri preferiscono usare _topics_. -Hugo defaults to using posts, tags and categories out of the box and this will work fine if that's what you want. If you wish to customise this, however, you can do so by creating a `taxonomies.toml` configuration file: +Hugo usa di default post, tag e categorie e questo funziona bene se è quello che vuoi. Tuttavia, se desideri personalizzare questo aspetto, è possibile farlo creando un file di configurazione `taxonomies.toml`: ```toml # config/_default/taxonomies.toml From 4c92571a0beaac0dd1afa3fc8d7607e53744099a Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Tue, 9 Apr 2024 21:28:51 +0200 Subject: [PATCH 04/34] Update started index.it.md Add more translate content --- .../content/docs/getting-started/index.it.md | 26 ++++++++++--------- 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/exampleSite/content/docs/getting-started/index.it.md b/exampleSite/content/docs/getting-started/index.it.md index bcc76038a..d9367e09c 100644 --- a/exampleSite/content/docs/getting-started/index.it.md +++ b/exampleSite/content/docs/getting-started/index.it.md @@ -155,15 +155,16 @@ Hugo usa di default post, tag e categorie e questo funziona bene se è quello ch topic = "topics" ``` -This will replace the default _tags_ and _categories_ with _topics_. Refer to the [Hugo Taxonomy docs](https://gohugo.io/content-management/taxonomies/) for more information on naming taxonomies. +Sostituirà i predefiniti _tags_ e _categorie_ con _topics_. Fare riferimento a [Hugo Taxonomy docs](https://gohugo.io/content-management/taxonomies/) per ulteriori informazioni sulla denominazione delle tassonomie. -When you create a new taxonomy, you will need to adjust the navigation links on the website to point to the correct sections, which is covered below. +Quando crei una nuova tassonomia, è necessario sistemare i collegamenti di navigazione sul sito web per puntare alle sezioni corrette, come spiegato di seguito. -## Menus +## Menu -Blowfish has two menus that can be customised to suit the content and layout of your site. The `main` menu appears in the site header and the `footer` menu appears at the bottom of the page just above the copyright notice. +Blowfish dispone di due menu che possono essere personalizzati per adattarsi al contenuto e al layout del sito. Il menu `main` appare nell'intestazione del sito e il menu `footer` appare in fondo alla pagina, appena sopra la nota di copyright. + +Entrambi i menu sono configurati nel file `menus.en.toml`. Simile al file di configurazione delle lingue, se desideri utilizzare un'altra lingua, rinomina questo file e sostituisci `en` con il codice della lingua che si vuole utilizzare. -Both menus are configured in the `menus.en.toml` file. Similarly to the languages config file, if you wish to use another language, rename this file and replace `en` with the language code you wish to use. ```toml # config/_default/menus.toml @@ -195,19 +196,20 @@ Both menus are configured in the `menus.en.toml` file. Similarly to the language url = "https://external-link" ``` -The `name` parameter specifies the text that is used in the menu link. You can also optionally provide a `title` which fills the HTML title attribute for the link. +Il parametro `name` specifica il testo utilizzato nel collegamento al menu. Si può anche fornire facoltativamente un `title` che riempie l'attributo HTML title per il collegamento. + +Il parametro `pageRef` consente di fare facilmente riferimento alle pagine di contenuto e alle tassonomie di Hugo. È il modo più rapido per configurare il menu, in quanto è sufficiente fare riferimento a qualsiasi elemento di contenuto di Hugo per creare automaticamente il collegamento corretto. Per collegarsi a URL esterni, si può usare il parametro `url`. -The `pageRef` parameter allows you to easily reference Hugo content pages and taxonomies. It is the quickest way to configure the menu as you can simply refer to any Hugo content item and it will automatically build the correct link. To link to external URLs, the `url` parameter can be used. +Il parametro `pre` consente di inserire un'icona dal [Set di icone di Blowfish] ({{< ref "samples/icons" >}}) nella voce di menu. Questo parametro può essere usato con il parametro `name` o da solo. Se si vogliono usare più voci di menu con le sole icone, imposta il parametro `identifier`, altrimenti Hugo sceglierà come id il tag di denominazione e probabilmente non visualizzerà tutte le voci di menu. -The `pre` parameter allows you to place an icon from [Blowfish's icon set]({{< ref "samples/icons" >}}) on the menu entry. This parameter can be used with `name` parameter or by itself. If you want to use multiple menu entries with just icons please set the `identifier`parameter otherwise Hugo will default to the naming tag as the id and probably not display all the menu entries. +I collegamenti al menu saranno ordinati dal più basso al più alto `peso`, e poi in ordine alfabetico per `name`. -Menu links will be sorted from lowest to highest `weight`, and then alphabetically by `name`. +Entrambi i menu sono completamente opzionali e possono essere commentati se non sono necessari. Utilizzare il modello fornito nel file come guida. -Both menus are completely optional and can be commented out if not required. Use the template provided in the file as a guide. +### Nested Menu -### Nested menus +Il tema supporta anche i menu nidificati. Per usarli devi solo definire una voce genitore in `menu.toml` e i suoi sottomenu utilizzando il parametro `parent` per fare riferimento al genitore. Tutte le proprietà possono essere utilizzate per i sottomenu. `pageRef` e `url` possono essere utilizzati anche nella voce principale. I menu nidificati sono disponibili solo nel menu principale e non nel footer. -The theme also supports nested menus. In order to use them you just need to define a parent entry in `menu.toml` and its sub-menus using the `parent` parameter to reference the parent. All properties can be used for sub-menus. `pageRef` and `url` can also be used in the parent entry. Nested menus are only available in the main menu not for the footer. ```toml # config/_default/menus.toml From a9e19f38c87641330da2311a66656521abc0bab5 Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Fri, 12 Apr 2024 13:27:11 +0200 Subject: [PATCH 05/34] Update index.it.md --- exampleSite/content/docs/getting-started/index.it.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/exampleSite/content/docs/getting-started/index.it.md b/exampleSite/content/docs/getting-started/index.it.md index d9367e09c..b41d7721a 100644 --- a/exampleSite/content/docs/getting-started/index.it.md +++ b/exampleSite/content/docs/getting-started/index.it.md @@ -238,10 +238,10 @@ Il tema supporta anche i menu nidificati. Per usarli devi solo definire una voce weight = 20 ``` -### Sub-Navigation menu +### Menu di navigazione secondario -Additionally, you can also configure a sub-navigation menu. Just define new menu entries as `subnavigation` in `menus.toml`. -This will render a second line with sub-categories below the main header menu. +Inoltre, è possibile configurare un menu di sotto-navigazione. Basta definire nuove voci di menu come `subnavigation` in `menus.toml`. +Questo renderà una seconda riga con le sottocategorie sotto il menu principale dell'intestazione. ```toml # config/_default/menus.toml @@ -257,7 +257,7 @@ This will render a second line with sub-categories below the main header menu. weight = 20 ``` -The default `name` is the `pageRef` title cased. +Il `name' predefinito è il titolo di `pageRef', con le caselle. ## Thumbnails & Backgrounds From f52acf7a0f046e72e628046c25eb519f921199f2 Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Tue, 28 May 2024 11:34:11 +0200 Subject: [PATCH 06/34] Update configuration file index.it.md Translated some content --- .../content/docs/configuration/index.it.md | 80 +++++++++---------- 1 file changed, 40 insertions(+), 40 deletions(-) diff --git a/exampleSite/content/docs/configuration/index.it.md b/exampleSite/content/docs/configuration/index.it.md index 0abe430a0..82c9e2219 100644 --- a/exampleSite/content/docs/configuration/index.it.md +++ b/exampleSite/content/docs/configuration/index.it.md @@ -1,17 +1,17 @@ --- -title: "Configuration" +title: "Configurazioni" date: 2020-08-14 draft: false -description: "All the configuration variables available in Blowfish." -slug: "configuration" +description: "Tutte le configurazioni disponibili in Blowfish." +slug: "configurazioni" tags: ["config", "docs"] -series: ["Documentation"] +series: ["Documentazione"] series_order: 4 --- -Blowfish is a highly customisable theme and uses some of the latest Hugo features to simplify how it is configured. +Blowfish è un tema altamente personalizzabile e utilizza alcune delle più recenti funzionalità di Hugo per semplificarne la configurazione. -The theme ships with a default configuration that gets you up and running with a basic blog or static website. +Il tema viene fornito con una configurazione predefinita che ti consente di essere operativo con un blog di base o un sito Web statico. {{< alert "fire" >}} We just launched a CLI tool to help you get started with Blowfish. It will help you with installation and configuration. Install the CLI tool globally using: @@ -20,47 +20,47 @@ npx blowfish-tools ``` {{< /alert >}} -> Configuration files bundled with the theme are provided in TOML format as this is the default Hugo syntax. Feel free to convert your config to YAML or JSON if you wish. +> I file di configurazione forniti con il tema sono forniti in formato TOML dato che questa è la sintassi predefinita di Hugo. Sentiti libero di convertire la tua configurazione in YAML o JSON se lo desideri. -The default theme configuration is documented in each file so you can freely adjust the settings to meet your needs. +La configurazione predefinita del tema è documentata in ogni file in modo da poter regolare liberamente le impostazioni per soddisfare le proprie esigenze. {{< alert >}} As outlined in the [installation instructions]({{< ref "/docs/installation#set-up-theme-configuration-files" >}}), you should adjust your theme configuration by modifying the files in the `config/_default/` folder of your Hugo project and delete the `config.toml` file in your project root. {{< /alert >}} -## Site configuration +## Configurazioni del sito Standard Hugo configuration variables are respected throughout the theme, however there are some specific things that should be configured for the best experience. -The site configuration is managed through the `config/_default/config.toml` file. The table below outlines all the settings that the Blowfish takes advantage of. +La configurazione del sito viene gestita tramite il file `config/_default/config.toml`. La tabella seguente descrive tutte le impostazioni di cui si avvale Blowfish. -Note that the variable names provided in this table use dot notation to simplify the TOML data structure (ie. `outputs.home` refers to `[outputs] home`). +Tieni presente che i nomi delle variabili forniti in questa tabella utilizzano il punto per semplificare la struttura dei dati TOML (ad esempio, "outputs.home" si riferisce a "[outputs] home"). | Name | Default | Description | | ------------------------ | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `theme` | `"blowfish"` | When using Hugo Modules this config value should be removed. For all other installation types, this must be set to `blowfish` for the theme to function. | +| `theme` | `"blowfish"` | Quando si utilizzano i moduli Hugo, questo valore di configurazione deve essere rimosso. Per tutti gli altri tipi di installazione, questo deve essere impostato su "blowfish" affinché il tema funzioni. | | `baseURL` | _Not set_ | The URL to the root of the website. | -| `defaultContentLanguage` | `"en"` | This value determines the default language of theme components and content. Refer to the [language and i18n](#language-and-i18n) section below for supported language codes. | -| `enableRobotsTXT` | `true` | When enabled, a `robots.txt` file will be created in the site root that allows search engines to crawl the entire site. If you prefer to provide your own pre-made `robots.txt`, set to `false` and place your file in the `static` directory. For complete control, you may provide a [custom layout]({{< ref "content-examples#custom-layouts" >}}) to generate this file. | -| `paginate` | `10` | The number of articles listed on each page of the article listing. | -| `summaryLength` | `0` | The number of words that are used to generate the article summary when one is not provided in the [front matter]({{< ref "front-matter" >}}). A value of `0` will use the first sentence. This value has no effect when summaries are hidden. | -| `outputs.home` | `["HTML", "RSS", "JSON"]` | The output formats that are generated for the site. Blowfish requires HTML, RSS and JSON for all theme components to work correctly. | -| `permalinks` | _Not set_ | Refer to the [Hugo docs](https://gohugo.io/content-management/urls/#permalinks) for permalink configuration. | -| `taxonomies` | _Not set_ | Refer to the [Organising content]({{< ref "getting-started#organising-content" >}}) section for taxonomy configuration. | +| `defaultContentLanguage` | `"en"` | This value determines the default language of theme components and content. Refer to the [language and i18n](#language-and-i18n) section below for supported language codes. | +| `enableRobotsTXT` | `true` | Se abilitato, verrà creato un file "robots.txt" nella radice del sito che consentirà ai motori di ricerca di eseguire la scansione dell'intero sito. Se preferisci fornire il tuo file `robots.txt` predefinito, impostalo su `false` e ​​posiziona il file nella directory `static`. Per un controllo completo, puoi fornire un [layout personalizzato]({{< ref "content-examples#custom-layouts" >}}) per generare questo file. | +| `paginate` | `10` | Il numero di articoli elencati in ciascuna pagina dell'elenco degli articoli. | +| `summaryLength` | `0` | Il numero di parole utilizzate per generare il riepilogo dell'articolo quando non ne viene fornita una nella [front matter]({{< ref "front-matter" >}}). Un valore pari a "0" utilizzerà la prima frase. Questo valore non ha effetto quando i riepiloghi sono nascosti. | +| `outputs.home` | `["HTML", "RSS", "JSON"]` | I formati di output generati per il sito. Blowfish richiede HTML, RSS e JSON affinché tutti i componenti del tema funzionino correttamente. | +| `permalinks` | _Not set_ | Fare riferimento alla [documentazione di Hugo](https://gohugo.io/content-management/urls/#permalinks) per la configurazione del permalink. | +| `taxonomies` | _Not set_ | Fare riferimento alla sezione [Organizzazione dei contenuti]({{< ref "getting-started#organising-content" >}}) per la configurazione della tassonomia. | ## Thumbnails -Blowfish was built so it would be easy to add visual support to your articles. If your familiar with Hugo article structure, you just need to place an image file (almost all formats are supported but we recommend `.png` or `.jpg`) that starts with `feature*` inside your article folder. And that's it, Blowfish will then able to both use the image as a thumbnail within your website as well as for oEmbed cards across social platforms. +Blowfish è stato creato in modo che sia facile aggiungere supporto visivo ai tuoi articoli. Se hai familiarità con la struttura degli articoli di Hugo, devi solo inserire un file immagine (quasi tutti i formati sono supportati ma consigliamo `.png` o `.jpg`) che inizi con `feature*` all'interno della cartella dell'articolo. E questo è tutto, Blowfish sarà quindi in grado di utilizzare l'immagine sia come miniatura all'interno del tuo sito web sia per le schede oEmbed su piattaforme sociali. -[Here]({{< ref "thumbnails" >}}) is also a guide with more info and a [sample]({{< ref "thumbnail_sample" >}}) if you want to see how you can do it. +[Qui]({{< ref "thumbnails" >}}) c'è anche una guida con maggiori informazioni e un [esempio]({{< ref "thumbnails_sample" >}}) se vuoi vedere come puoi farlo. -## Language and i18n +## Lingua e i18n -Blowfish is optimised for full multilingual websites and theme assets are translated into several languages out of the box. The language configuration allows you to generate multiple versions of your content to provide a customised experience to your visitors in their native language. +Blowfish è ottimizzato per siti Web multilingue completi e le risorse tematiche sono tradotte in diverse lingue immediatamente. La configurazione della lingua ti consente di generare più versioni dei tuoi contenuti per fornire un'esperienza personalizzata ai tuoi visitatori nella loro lingua madre. -The theme currently supports the following languages by default: +Il tema attualmente supporta le seguenti lingue per impostazione predefinita: | Language | Code | | ------------------------------ | ------- | @@ -93,40 +93,40 @@ The theme currently supports the following languages by default: -The default translations can be overridden by creating a custom file in `i18n/[code].yaml` that contains the translation strings. You can also use this method to add new languages. If you'd like to share a new translation with the community, please [open a pull request](https://github.com/nunocoracao/blowfish/pulls). +Le traduzioni predefinite possono essere sovrascritte creando un file personalizzato in "i18n/[code].yaml" che contiene le stringhe di traduzione. Puoi anche utilizzare questo metodo per aggiungere nuove lingue. Se desideri condividere una nuova traduzione con la community, [apri una richiesta pull](https://github.com/nunocoracao/blowfish/pulls). -### Configuration +### Configurazione -In order to be as flexible as possible, a language configuration file needs to be created for each language on the website. By default Blowfish includes an English language configuration at `config/_default/languages.en.toml`. +Per essere il più flessibili possibile, è necessario creare un file di configurazione lingua per ciascuna lingua sul sito web. Per impostazione predefinita Blowfish include una configurazione della lingua inglese in `config/_default/linguals.en.toml`. -The default file can be used as a template to create additional languages, or renamed if you wish to author your website in a language other than English. Simply name the file using the format `languages.[language-code].toml`. +Il file predefinito può essere utilizzato come modello per creare lingue aggiuntive o rinominato se desideri creare il tuo sito web in una lingua diversa dall'inglese. Basta nominare il file utilizzando il formato "lingue.[language-code].toml". {{< alert >}} -**Note:** Ensure the `defaultContentLanguage` parameter in the [site configuration](#site-configuration) matches the language code in your language config filename. +**Nota:** assicurati che il parametro `defaultContentLanguage` nella [configurazione del sito](#site-configuration) corrisponda al codice della lingua nel nome del file di configurazione della lingua. {{< /alert >}} -#### Global +#### Globale | Name | Default | Description | | -------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `languageCode` | `"en"` | The Hugo language code for this file. It can be a top-level language (ie. `en`) or a sub-variant (ie. `en-au`) and should match the language code in the filename. Hugo expects this value to always be in lowercase. For proper HTML compliance, set the `isoCode` parameter which is case-sensitive. | -| `languageName` | `"English"` | The name of the language. | -| `weight` | `1` | The weight determines the order of languages when building multilingual sites. | -| `title` | `"Blowfish"` | The title of the website. This will be displayed in the site header and footer. | +| `languageCode` | `"en"` | Il codice della lingua Hugo per questo file. Può essere una lingua di livello superiore (ad esempio "en") o una variante secondaria (ad esempio "en-au") e deve corrispondere al codice della lingua nel nome del file. Hugo si aspetta che questo valore sia sempre in minuscolo. Per una corretta conformità HTML, imposta il parametro "isoCode" che fa distinzione tra maiuscole e minuscole. | +| `languageName` | `"English"` | Il nome della lingua. | +| `weight` | `1` | Il peso determina l'ordine delle lingue durante la creazione di siti multilingue. | +| `title` | `"Blowfish"` | Il titolo del sito web. Questo verrà visualizzato nell'intestazione e nel piè di pagina del sito. | -#### Params +#### Parametri | Name | Default | Description | | ---------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `params.displayName` | `"EN"` | The name used when the language appears on the website. | -| `params.isoCode` | `"en"` | The ISO language code for HTML metadata purposes. It can be a top-level language (ie. `en`) or a sub-variant (ie. `en-AU`). | -| `params.rtl` | `false` | Whether or not this is a RTL language. Set to `true` to reflow content from right-to-left. Blowfish fully supports using RTL and LTR languages at the same time and will dynamically adjust to both. | -| `params.dateFormat` | `"2 January 2006"` | How dates are formatted in this language. Refer to the [Hugo docs](https://gohugo.io/functions/format/#gos-layout-string) for acceptable formats. | -| `params.logo` | _Not set_ | The relative path to the site logo file within the `assets/` folder. The logo file should be provided at 2x resolution and supports any image dimensions. | +| `params.displayName` | `"EN"` | Il nome utilizzato quando la lingua appare sul sito web. | +| `params.isoCode` | `"en"` | Il codice della lingua ISO per scopi di metadati HTML. Può essere una lingua di livello superiore (es. `en`) o una sottovariante (es. `en-AU`). | +| `params.rtl` | `false` | Se si tratta o meno di un linguaggio RTL. Imposta su "true" per ridisporre il contenuto da destra a sinistra. Blowfish supporta pienamente l'uso simultaneo dei linguaggi RTL e LTR e si adatterà dinamicamente ad entrambi. | +| `params.dateFormat` | `"2 January 2006"` | Come vengono formattate le date in questa lingua. Fare riferimento alla [documentazione di Hugo](https://gohugo.io/functions/format/#gos-layout-string) per i formati accettabili. | +| `params.logo` | _Not set_ | Il percorso relativo al file del logo del sito all'interno della cartella "assets/". Il file del logo deve essere fornito con una risoluzione 2x e supporta qualsiasi dimensione dell'immagine. | | `params.secondaryLogo` | _Not set_ | The relative path to the secondary site logo file within the `assets/` folder. The logo file should be provided at 2x resolution and supports any image dimensions. This should have an inverted/contrasting colour scheme to `logo`. If set, this logo will be shown when users toggle from the `defaultAppearance` mode. | | `params.description` | _Not set_ | The website description. This will be used in the site metadata. | | `params.copyright` | _Not set_ | A Markdown string for the site footer copyright message can include the placeholder { year } to dynamically insert the current year. If none is provided, Blowfish will automatically generate a copyright string using the site `title`. | From 41615910a75dfc87833b37dadff18e4dcf6ed6ec Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nuno=20Cora=C3=A7=C3=A3o?= Date: Sat, 10 Aug 2024 11:27:52 +0100 Subject: [PATCH 07/34] new version --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 962268f94..138ce7e25 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "hugo-blowfish-theme", - "version": "2.75.0", + "version": "2.76.0", "description": "Blowfish theme for Hugo.", "scripts": { "postinstall": "vendor-copy", From c35242e9129f7383b40b3a64ebad9d436fcc2964 Mon Sep 17 00:00:00 2001 From: "W.T. Chang" <1546333+wtchangdm@users.noreply.github.com> Date: Sat, 10 Aug 2024 19:21:45 +0800 Subject: [PATCH 08/34] add trailing slash for homepage.showMoreLinkDest --- config/_default/params.toml | 2 +- exampleSite/content/guides/202310-blowfish-tutorial/index.it.md | 2 +- exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md | 2 +- exampleSite/content/guides/202310-blowfish-tutorial/index.md | 2 +- .../content/guides/202310-blowfish-tutorial/index.zh-cn.md | 2 +- exampleSite/layouts/partials/recent-articles-demo.html | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/config/_default/params.toml b/config/_default/params.toml index 8ec5457f0..d81f34e5c 100644 --- a/config/_default/params.toml +++ b/config/_default/params.toml @@ -47,7 +47,7 @@ forgejoDefaultServer = "https://v8.next.forgejo.org" showRecent = false showRecentItems = 5 showMoreLink = false - showMoreLinkDest = "/posts" + showMoreLinkDest = "/posts/" cardView = false cardViewScreenWidth = false layoutBackgroundBlur = false # only used when layout equals background diff --git a/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md b/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md index b58aa0adc..8a6601bd3 100644 --- a/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md +++ b/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md @@ -207,7 +207,7 @@ Next, let's configure our homepage. We’re going with the _background_ layout, showRecent = true showRecentItems = 6 showMoreLink = true - showMoreLinkDest = "/posts" + showMoreLinkDest = "/posts/" cardView = true cardViewScreenWidth = false layoutBackgroundBlur = true # only used when layout equals background diff --git a/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md b/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md index b58aa0adc..8a6601bd3 100644 --- a/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md +++ b/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md @@ -207,7 +207,7 @@ Next, let's configure our homepage. We’re going with the _background_ layout, showRecent = true showRecentItems = 6 showMoreLink = true - showMoreLinkDest = "/posts" + showMoreLinkDest = "/posts/" cardView = true cardViewScreenWidth = false layoutBackgroundBlur = true # only used when layout equals background diff --git a/exampleSite/content/guides/202310-blowfish-tutorial/index.md b/exampleSite/content/guides/202310-blowfish-tutorial/index.md index b58aa0adc..8a6601bd3 100644 --- a/exampleSite/content/guides/202310-blowfish-tutorial/index.md +++ b/exampleSite/content/guides/202310-blowfish-tutorial/index.md @@ -207,7 +207,7 @@ Next, let's configure our homepage. We’re going with the _background_ layout, showRecent = true showRecentItems = 6 showMoreLink = true - showMoreLinkDest = "/posts" + showMoreLinkDest = "/posts/" cardView = true cardViewScreenWidth = false layoutBackgroundBlur = true # only used when layout equals background diff --git a/exampleSite/content/guides/202310-blowfish-tutorial/index.zh-cn.md b/exampleSite/content/guides/202310-blowfish-tutorial/index.zh-cn.md index b0175c801..107c1a743 100644 --- a/exampleSite/content/guides/202310-blowfish-tutorial/index.zh-cn.md +++ b/exampleSite/content/guides/202310-blowfish-tutorial/index.zh-cn.md @@ -208,7 +208,7 @@ defaultBackgroundImage = "image.jpg" # used as default for background images showRecent = true showRecentItems = 6 showMoreLink = true - showMoreLinkDest = "/posts" + showMoreLinkDest = "/posts/" cardView = true cardViewScreenWidth = false layoutBackgroundBlur = true # only used when layout equals background diff --git a/exampleSite/layouts/partials/recent-articles-demo.html b/exampleSite/layouts/partials/recent-articles-demo.html index 21bbd8db2..07cf4704c 100644 --- a/exampleSite/layouts/partials/recent-articles-demo.html +++ b/exampleSite/layouts/partials/recent-articles-demo.html @@ -1,5 +1,5 @@ {{ $recentArticles := 5 }} -{{ $showMoreLinkDest := "/posts" }} +{{ $showMoreLinkDest := "/posts/" }} {{ if index .Site.Params.homepage "showRecentItems" }} {{ $recentArticles = .Site.Params.homepage.showRecentItems }} {{ end }} From 40422fe062ba10987ce354e5bf5516d8417a4a5d Mon Sep 17 00:00:00 2001 From: Asterisk Date: Sat, 10 Aug 2024 11:17:52 -0400 Subject: [PATCH 09/34] Add mastodon sharing link --- data/sharing.json | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/data/sharing.json b/data/sharing.json index f176a2cd6..8fbd1107d 100644 --- a/data/sharing.json +++ b/data/sharing.json @@ -43,5 +43,10 @@ "icon": "bluesky", "title": "sharing.bluesky", "url": "https://bsky.app/intent/compose?text=%[2]s+%[1]s" - } -} \ No newline at end of file + }. + "mastodon": { + "icon": "mastodon", + "title": "sharing.mastodon", + "url": "https://toot.kytta.dev/?text=%[2]s+%[1]s" + } +} From 042eca79b2728c9f3c26076c179286d7845a8093 Mon Sep 17 00:00:00 2001 From: Asterisk Date: Sat, 10 Aug 2024 11:26:17 -0400 Subject: [PATCH 10/34] fix period --- data/sharing.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/sharing.json b/data/sharing.json index 8fbd1107d..a7837c6d1 100644 --- a/data/sharing.json +++ b/data/sharing.json @@ -43,7 +43,7 @@ "icon": "bluesky", "title": "sharing.bluesky", "url": "https://bsky.app/intent/compose?text=%[2]s+%[1]s" - }. + }, "mastodon": { "icon": "mastodon", "title": "sharing.mastodon", From be6ce389c6cac6647f40fc0f57a4635a5171437d Mon Sep 17 00:00:00 2001 From: Asterisk Date: Sat, 10 Aug 2024 11:28:30 -0400 Subject: [PATCH 11/34] Update sharing.json --- data/sharing.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/sharing.json b/data/sharing.json index a7837c6d1..e08a0cb74 100644 --- a/data/sharing.json +++ b/data/sharing.json @@ -47,6 +47,6 @@ "mastodon": { "icon": "mastodon", "title": "sharing.mastodon", - "url": "https://toot.kytta.dev/?text=%[2]s+%[1]s" + "url": "https://toot.kytta.dev/?text=%[2]s %[1]s" } } From a5e9ac3997c36f6ec639b1d9e8e9cd60ff4c0490 Mon Sep 17 00:00:00 2001 From: Asterisk Date: Sat, 10 Aug 2024 11:40:07 -0400 Subject: [PATCH 12/34] edit default sharing link config --- config/_default/params.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/_default/params.toml b/config/_default/params.toml index 8ec5457f0..b69c7d5de 100644 --- a/config/_default/params.toml +++ b/config/_default/params.toml @@ -80,7 +80,7 @@ forgejoDefaultServer = "https://v8.next.forgejo.org" showTaxonomies = false showAuthorsBadges = false showWordCount = true - # sharingLinks = [ "linkedin", "twitter", "bluesky", "reddit", "pinterest", "facebook", "email", "whatsapp", "telegram"] + # sharingLinks = [ "linkedin", "twitter", "bluesky", "mastodon", "reddit", "pinterest", "facebook", "email", "whatsapp", "telegram"] showZenMode = false [list] From e7a24c2e8686f889c6ce78754755dc9f99409383 Mon Sep 17 00:00:00 2001 From: Asterisk Date: Sat, 10 Aug 2024 12:29:57 -0400 Subject: [PATCH 13/34] toot is now share2fedi (sharing.json) --- data/sharing.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/sharing.json b/data/sharing.json index e08a0cb74..18aa4e637 100644 --- a/data/sharing.json +++ b/data/sharing.json @@ -47,6 +47,6 @@ "mastodon": { "icon": "mastodon", "title": "sharing.mastodon", - "url": "https://toot.kytta.dev/?text=%[2]s %[1]s" + "url": "https://s2f.kytta.dev/?text=%[2]s %[1]s" } } From 213880a1a3741466d2d58310439c95727f08084a Mon Sep 17 00:00:00 2001 From: sculptor189 Date: Sat, 10 Aug 2024 15:15:59 -0400 Subject: [PATCH 14/34] add rel attribute to button shortcode --- exampleSite/content/docs/shortcodes/index.it.md | 2 +- exampleSite/content/docs/shortcodes/index.ja.md | 2 +- layouts/shortcodes/button.html | 1 + 3 files changed, 3 insertions(+), 2 deletions(-) diff --git a/exampleSite/content/docs/shortcodes/index.it.md b/exampleSite/content/docs/shortcodes/index.it.md index 4102673b7..699c2a0f8 100644 --- a/exampleSite/content/docs/shortcodes/index.it.md +++ b/exampleSite/content/docs/shortcodes/index.it.md @@ -104,7 +104,7 @@ New article! ## Button -`button` outputs a styled button component which can be used to highlight a primary action. It has two optional variables `href` and `target` which can be used to specify the URL and target of the link. +`button` outputs a styled button component which can be used to highlight a primary action. It has three optional variables `href`, `target` and `rel` which can be used to specify the URL, target and relation of the link. **Example:** diff --git a/exampleSite/content/docs/shortcodes/index.ja.md b/exampleSite/content/docs/shortcodes/index.ja.md index a93cc2370..95734f0ef 100644 --- a/exampleSite/content/docs/shortcodes/index.ja.md +++ b/exampleSite/content/docs/shortcodes/index.ja.md @@ -104,7 +104,7 @@ New article! ## Button -`button` outputs a styled button component which can be used to highlight a primary action. It has two optional variables `href` and `target` which can be used to specify the URL and target of the link. +`button` outputs a styled button component which can be used to highlight a primary action. It has three optional variables `href`, `target` and `rel` which can be used to specify the URL, target and relation of the link. **Example:** diff --git a/layouts/shortcodes/button.html b/layouts/shortcodes/button.html index c6a4c36b4..8bddea141 100644 --- a/layouts/shortcodes/button.html +++ b/layouts/shortcodes/button.html @@ -2,6 +2,7 @@ class="!rounded-md bg-primary-600 px-4 py-2 !text-neutral !no-underline hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700" {{ with .Get "href" }}href="{{ . }}"{{ end }} {{ with .Get "target" }}target="{{ . }}"{{ end }} + {{ with .Get "rel" }}rel="{{ . }}"{{ end }} role="button" > {{ .Inner }} From 3ea13cfe37719e02cb306446d8c94bdb57434f28 Mon Sep 17 00:00:00 2001 From: sculptor189 Date: Sat, 10 Aug 2024 19:23:16 -0400 Subject: [PATCH 15/34] correct time format --- layouts/partials/meta/date-updated.html | 2 +- layouts/partials/meta/date.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/layouts/partials/meta/date-updated.html b/layouts/partials/meta/date-updated.html index 73bb4e148..949a1723c 100644 --- a/layouts/partials/meta/date-updated.html +++ b/layouts/partials/meta/date-updated.html @@ -1,4 +1,4 @@ -