Modelli di GitLab

Overview

Teaching: 0 min
Exercises: 0 min

Questions

• Where can I find pre-built projects/themes for my site?

Objectives

• Find and fork pre-existing templates to determine the technologies behind a project and the styles of the deriving website

Modelli di Bio-IT

I modelli che abbiamo sviluppato insieme sono disponibili nella nostra piattaforma GitLab:

• Modello HTML semplice
• template Jekyll
• template Sphinx
• Libro Jupyter

Potrebbero essere leggermente arricchiti rispetto a quanto abbiamo visto in questa lezione, per esempio il modello HTML semplice presenta anche un file .css, ma sono tenuti al minimo di proposito. Se volete usarli come base per un vostro progetto, dovreste fornirli. Se lo si fa per sviluppare un proprio progetto e non per contribuire al template stesso, si deve poi rimuovere la relazione di fork. Esaminiamo insieme il processo.

Fare il fork di un progetto facendo clic sul pulsante “Fork” a destra del titolo del progetto. Si aprirà un menu (mostrato di seguito) molto simile a quello che appare quando si apre un nuovo progetto. Si può decidere di mantenere il progetto privato e di modificarne il titolo e la descrizione. È anche possibile inserirlo nel gruppo/spazio dei nomi pertinente.

Una volta terminato, rimuovere la relazione di fork. È possibile modificare le impostazioni del progetto nel menu a sinistra della pagina del progetto, seguendo: Settings > General > Advanced e poi scorrere fino alla scheda “Rimuovi relazione di fork”.

Una volta fatto questo, si può clonare il repository in locale e iniziare a modificare il template. Se avete bisogno di un riassunto su clonazione, biforcazione, push e pull in Git, date un’occhiata a questa lezione di The Carpentries.

Altri modelli

Vi chiedete dove potete trovare altri esempi di progetti di pagine GitLab? Controllate questo link. Include più di 40 esempi, basati su diverse tecnologie. Anche in questi casi, è buona norma rimuovere la relazione di fork se lo scopo è quello di utilizzare il template per lo sviluppo del proprio sito web e non di contribuire al template stesso. Alcuni esempi di template presenti in questo repository sono:

• courseware-template, un template basato su Jekyll per il sito web di un corso. Lo si può vedere in azione qui. Include stili per formattare i contenuti delle lezioni, i quiz e le diapositive.
• hugo blog template, il template per costruire blog basato su Hugo.
• jupyterbook, un modello per generare libri e documenti che integrano codice Python. Vedetelo reso qui.

Ora avete tutte le competenze necessarie per iniziare a giocare con le pagine di GitLab. Sentitevi liberi di contattarci se avete domande o di aprire un problema nei progetti modello per richiedere funzionalità o sollevare problemi. Siete anche invitati a contribuire allo sviluppo dei modelli di pagine, sia quelli esistenti che quelli nuovi che potrebbero adattarsi ai vostri casi d’uso. Infine, consultate il prossimo capitolo (bonus) per sapere come gestire gli errori nell’esecuzione della pipeline, per poter risolvere eventuali errori di CI/CD!

Key Points

• You can find many pre-existing templates for sites on the Internet

• You can find the presented themes for sites in our local GitLab

• You can avoid duplicated effort by basing new layouts on previous ones