Istruzioni per gestire un sito web pubblicato su GitLab Pages

readme.md

Istruzioni per gestire un sito web pubblicato su GitLab Pages

Richiedere l'accesso per pubblicare pagine richiede alcuni semplici step:

1. Iscriversi a gitlab.com, o accettare l'invito arrivato sulla propria casella email
2. Scegliere uno username qualunque (nome.cognome va benissimo) e una password
3. Nella seconda schermata ci vengono rivolte alcune domande per statistica, si possono fornire risposte a piacere: scegliere un ruolo qualunque, ad es. Sviluppatore software (A), un motivo qualunque per essersi iscritti, ad es. Voglio imparare git (B), indicare che si usera' Gitlab come singolo (C) e infine scegliere di Unirsi ad un progetto esistente (D)
   
4. Si verra' quindi catapultati in una pagina con titolo Welcome to GitLab, che significa che non si e' stati ancora aggiunti al progetto/repository che contiene il sito web
5. Se non si e' stati invitati via email, richiedere all'amministratore di essere aggiunti al repository, condividendo l'username scelto

Aggiungere una pagina

1. Una volta membri del progetto, visitare la homepage di Gitlab nuovamente, e cliccare sull'unico repository presente
2. All'interno del repository sono archiviati diversi file. Git permette di "tornare indietro" nella storia di tutti i file immagazzinati, e visionare tutte le versioni che si sono succedute. Cliccare sulla cartella content/ per visionare gli articoli presenti finora.
3. Una volta all'interno della cartella con gli articoli, per aggiungere un nuovo articolo cliccare sul pulsante +, come evidenziato nell'immagine seguente, e quindi selezionare "Nuovo file":
   
4. Si aprira' una schermata al cui interno e' possibile digitare:
   
   1. Dare un nome univoco al nuovo file, senza spazi, e che termini con estensione .md, ad es. articolo-incontri-mario-24-febbraio.md
   2. Inserire nella finestra sottostante un testo come il seguente, ma assicurarsi che il titolo nella prima riga sia univoco (!), altrimenti il sito rifiutera' di aggiungere due articoli con lo stesso nome:

   Title: Qui va inserito un titolo che sia univoco tra tutti gli articoli!
   Date: 2023-02-01 22:30
   Category: Lotti
   Tags: Apicoltura
   Ref_Image: Qua-inserire-il-nome-di-un-immagine-da-usare-come-copertina.jpg
   
   Tutto quello che viene dopo la prima riga bianca viene considerato come corpo dell'articolo.
   
   Il corpo va scritto usando la formattazione Markdown: al seguente link e' disponibile una guida in
   italiano (https://www.html.it/articoli/markdown-guida-al-linguaggio/), ma in inglese si trovano
   guide piu' complete, come questa veloce introduzione a Markdown in 5 minuti
   (https://about.gitlab.com/blog/2018/08/17/gitlab-markdown-tutorial/), oppure il manuale di GitLab,
   la piattaforma che ospita questo sito (https://about.gitlab.com/handbook/markdown-guide/).
   
   Ad esempio, per scrivere in grassetto, basta circondare il testo con **due asterischi**, cosi'.
   Per scrivere in corsivo, ne basta *una coppia*.
   Per inserire un link si puo' fare [cosi'](https://google.com).
   
   Se si vuole testare il proprio codice markdown ci sono molti editor online per farlo in simultanea
   mentre si scrive, ad esempio i primi due che ho trovato sono https://markdownlivepreview.com e
   https://markdown-editor.github.io.
   

   1. Infine cliccare su Commit changes
5. Il file non e' ancora stato creato, ma e' stato semplicemente aggiunto ad un "ramo" del repository (branch nel gergo tecnico di git). Ora possiamo richiedere ad un amministratore di aggiungerlo al repository compilando alcuni campi:
   1. Dare un titolo significativo all'operazione di aggiunta, ad es. Aggiunta articolo su Mario Rossi per il 24 febbraio
   2. Scorrere in fondo alla schermata, e cliccare su Create merge request.
6. A questo punto la pagina e' in attesa di approvazione da un amministratore del repository, che potra' approvarla e aggiungerla al repository, o commentarla e richiedere ulteriori modifiche, etc.
7. Una volta che l'amministratore ha approvato, la pagina verra' automaticamente creata all'interno del sito web, e aggiunta alla lista degli ultimi articoli.

Modificare una pagina

1. Cercare la pagina che si vuole modificare all'interno del repository, nella cartella content (o contenuto/)
2. Sulla destra del pulsante Open in Web IDE/Apri con Web IDE cliccare sul triangolo per aprire il menu' a tendina
3. Dal menu' a tendina scegliere la seconda opzione Edit this file only.
4. Cliccare quindi sul pulsante blu Edit
5. Ci si trovera' in un editor come quello di creazione del file, visto precedentemente. Seguire quindi gli stessi passaggi.