Aggiunti crediti e paragrafo azione
Some checks failed
Linting markdown on PR / unicode-check (pull_request) Failing after 1m4s

This commit is contained in:
amreo 2024-09-09 22:28:19 +02:00
parent bfb69151b8
commit 1c7ebbf66e
2 changed files with 29 additions and 15 deletions

View File

@ -1,12 +1,10 @@
---
title: "Migrazione from Wordpress to Hugo"
title: "Wordpress to Hugo migration"
date: 2024-09-09T07:50:41+02:00
#expiryDate: # set this if the post should be removed automatically some time in the future
#publishDate: # set this if the post should be published automatically some time in the future
draft: false
slug: "2024-09-09-migrazione-wordpress-hugo"
type: post
image: wordpress-to-hugo.png # if you don't specify an image, the first available is used
image: wordpress-to-hugo.png
image_alt: "Image showing an arrow from wordpress to hugo"
summary: Storytelling and details of the migration from Wordpress to Hugo.
tags:
@ -21,8 +19,8 @@ This project is the result of a long process that began in November of last year
This achievement was made possible thanks to the contributions of several people, but the main contributor was undoubtedly **Paolo Asperti**, who handled the technical aspects. It is also important to mention **Omar Lazzari**, who played a significant role in content management.
![Contributions to libreschool.org according to gitea](contributi-libreschool.org.png)
![Contributions to bglug.it according to gitea](contributi-bglug.it.png)
![Contributions to libreschool.org according to gitea](contributi-libreschool.org.png "Image credits: none, CC0")
![Contributions to bglug.it according to gitea](contributi-bglug.it.png "Image credits: none, CC0")
During the migration, nothing was lost. A tool was used to export the articles from WordPress and convert them into "Hugo format", with manual adjustments made later.
@ -34,11 +32,11 @@ Before talking about Hugo, it's important to understand what a static site gener
A [Static Site Generator (SSG)](https://en.wikipedia.org/wiki/Static_site_generator), is a software that takes text files (e.g. in markdown or rst format) as input and generates a website consisting of HTML, CSS, JS, images, and other files, but without any server-side executable logic (like PHP or a REST server).
![Diagram showing how a generic SSG works. It illustrates how the generator takes input template files such as head.html, footer.html, and sidebar.html, along with content files like contacts.md, home.md, and product.md, and produces an output file tree containing an index.html file and two directories, each with its own index.html file.
](static-site-generator.png)
](static-site-generator.png "Image credits: [devPractical](https://devpractical.com/what-are-static-site-generators/)")
## What is Hugo?
![Hugo logo](hugo-logo-wide.png)
![Hugo logo](hugo-logo-wide.png "Image credits: [Hugo](https://gohugo.io/)")
[Hugo](https://gohugo.io/) is one of the many free(as freedom) SSGs available on the market, and probably the most popular one. It was chosen for both of our websites because it is fast, flexible, and has a wide range of themes available. Specifically, we decided to use the [hugo-arcana](https://themes.gohugo.io/themes/hugo-arcana/) theme.
@ -64,3 +62,12 @@ The migration to Hugo has brought numerous benefits for us, including:
- **Simplified archiving**: Archiving is much simpler because it's automatically handled by Git. In ten years, if we want to review the old site, we just need to run *git checkout* and *hugo server* to see it as it was.
Another potential advantage is lower hosting costs, as hosting a static website is much cheaper due to its small size and the ability to host it literally anywhere, like on a CDN. However, for us, nothing has changed since the site continues to run on the same web server, which hosts other services as well.
## We Want You!
In conclusion, we would be very happy to receive contributions from external people as well. If you're willing to help us, you're more than welcome! Not only for this project but also for other BGLUG activities.
Here are some useful links to get started:
* Repository of the website on Gitea: [https://git.libreschool.org/BgLUG/bglug.it](https://git.libreschool.org/BgLUG/bglug.it)
* BGLUG chat on Mattermost: [https://chat.bglug.it/](https://chat.bglug.it/)

View File

@ -1,12 +1,10 @@
---
title: "Migrazione da Wordpress a Hugo"
date: 2024-09-08T10:50:41+02:00
#expiryDate: # impostare se il post deve essere rimosso automaticamente nel futuro
#publishDate: # impostare se il post deve essere pubblicato automaticamente nel futuro
draft: false
slug: "2024-09-09-migrazione-wordpress-hugo"
type: post
image: wordpress-to-hugo.png # se non metti un'immagine, viene presa la prima immagine del post
image: wordpress-to-hugo.png
image_alt: "Immagine che mostra una freccia da wordpress a hugo"
summary: Racconto e dettagli della migrazione da Wordpress a Hugo.
tags:
@ -21,8 +19,8 @@ Questo progetto è il risultato di un lungo percorso iniziato a novembre dell'an
Questo risultato è stato reso possibile grazie all'impegno di diverse persone, ma il contributo principale è stato senza dubbio di **Paolo Asperti**, che si è occupato della parte tecnica. È importante anche menzionare **Omar Lazzari**, che ha dato un contributo rilevante nella gestione dei contenuti.
![Contributi al sito libreschool.org secondo gitea](contributi-libreschool.org.png)
![Contributi al sito bglug.it secondo gitea](contributi-bglug.it.png)
![Contributi al sito libreschool.org secondo gitea](contributi-libreschool.org.png "Image credits: none, CC0")
![Contributi al sito bglug.it secondo gitea](contributi-bglug.it.png "Image credits: none, CC0")
Durante la migrazione non sì è perso nulla. È stato utilizzato uno strumento per esportare gli articoli da WordPress e convertirli in "formato Hugo", con successivi aggiustamenti manuali.
@ -33,11 +31,11 @@ Il codice sorgente di entrambi i siti web è pubblico e disponibile [qui](https:
Prima di parlare di Hugo, è importante capire cosa sia un generatore di siti web statici.
Un [generatore di siti web statici](https://en.wikipedia.org/wiki/Static_site_generator), o Static Site Generator (SSG), è un software che prende in input file testuali (ad esempio in formato markdown o rst) e genera un sito web composto da file HTML, CSS, JS, immagini e altri elementi, ma senza logica eseguibile lato server (come PHP o server REST).
![Schema che mostra il funzionamento di un generico SSG. Viene mostrato come il generatore prende in input dei file template come head.html, footer.html e sidebar.html, dei file contenuti come contacts.md, home.md e product.md e produce in output un albero di file con dentro un file index.html e due directory contenenti rispettivamente ciascuno un file index.html](static-site-generator.png)
![Schema che mostra il funzionamento di un generico SSG. Viene mostrato come il generatore prende in input dei file template come head.html, footer.html e sidebar.html, dei file contenuti come contacts.md, home.md e product.md e produce in output un albero di file con dentro un file index.html e due directory contenenti rispettivamente ciascuno un file index.html](static-site-generator.png "Image credits: [devPractical](https://devpractical.com/what-are-static-site-generators/)")
## Cos'è Hugo?
![Logo di hugo](hugo-logo-wide.png)
![Logo di hugo](hugo-logo-wide.png "Image credits: [Hugo](https://gohugo.io/)")
[Hugo](https://gohugo.io/) è uno dei tanti SSG liberi presenti sul mercato, ed è probabilmente il più popolare.
È stato scelto per entrambi i nostri siti web web per la sua velocità, flessibilità e l'ampia disponibilità di temi. In particolare, abbiamo deciso di adottare il tema [hugo-arcana](https://themes.gohugo.io/themes/hugo-arcana/).
@ -64,3 +62,12 @@ La migrazione a Hugo ha portato numerosi vantaggi per noi, tra cui:
- **Archiviazione semplificata**: l'archiviazione è molto più semplice perché viene gratis con git. Tra dieci anni se vorremmo rivedere il vecchio sito basta andare indietro con *git checkout* e lanciare *hugo server*.
Ci sarebbe anche il vantaggio dei costi minori in quanto l'hosting di un sito web statico costa notevolmente meno in quanto occupa relativamente poco spazio e può essere messo letteralmente ovunque, come su una CDN. Tuttavia a noi non è cambiato nulla perché continua a girare sullo stesso web server, ove sono presenti altri servizi.
## Vogliamo te!
In conclusione, ci farebbe molto piacere ricevere contributi anche da parte di persone esterne. Se hai voglia di aiutarci, sei il benvenuto! Non solo per questo progetto, ma anche per le altre attività del BGLUG.
Ecco alcuni link utili per cominciare:
* Repository del sito su Gitea: [https://git.libreschool.org/BgLUG/bglug.it](https://git.libreschool.org/BgLUG/bglug.it)
* Chat del BGLUG su Mattermost: [https://chat.bglug.it/](https://chat.bglug.it/)