diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..da6e2b9 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +resources/ +.obsidian/ diff --git a/Chiavi-SSH.md b/Chiavi-SSH.md index e305a52..c859694 100644 --- a/Chiavi-SSH.md +++ b/Chiavi-SSH.md @@ -1,7 +1,7 @@ -## Inserire le chiavi SSH - -Se intendi utilizzare git in locale, aggiungi le tue chiavi SSH in Gitea a quest'indirizzo: - -https://git.libreschool.org/user/settings/keys - +## Inserire le chiavi SSH + +Se intendi utilizzare git in locale, aggiungi le tue chiavi SSH in Gitea a quest'indirizzo: + +https://git.libreschool.org/user/settings/keys + In questo modo sarà possibile dialogare con i repository on line via SSH. \ No newline at end of file diff --git a/Home.md b/Home.md index e5948b7..85a2b82 100644 --- a/Home.md +++ b/Home.md @@ -1,31 +1,30 @@ -BENVENUTO NELLA WIKI - -**Se vuoi iniziare subito a contribuire legge le...** - -* [Regole d'oro TL;DR](Regole-d-oro) - -**Procedure fondamentali operando da locale** - - * [Controllare e gestire l'upstream (git REMOTE)](Operazioni-fondamentali#controllare-e-gestire-lupstream-git-remote) - * [Aggiornamento del repo locale (git FETCH)](Appunti#aggiornamento-del-repo-locale-git-fetch) - * [Hard reset del main locale (git RESET)](Operazioni-fondamentali#hard-reset-del-main-locale-git-reset) - * [Aggiornamento di origin/main con l'upstream (git PULL)](Operazioni-fondamentali#aggiornamento-di-originmain-con-lupstream-git-pull) - * [Avanzamento di un branch da eseguire prima di un a PR (git PULL --REBASE)](Operazioni-fondamentali#avanzamento-di-un-branch-da-eseguire-prima-di-un-a-pr-git-pull---rebase) - -**Link a comandi e guide** - -* [Merge](Merge) - -* [Branch: comandi utili](Branch) - -* [Rebase: come fare](Fare-il-rebase) - -* [Spostare i commit](Spostare-commit) - -* [Diff: differenze tra le versioni con git DIFF](Diff) - -* [Relref - link interni](Relref) - -* [Link guide online](Link-guide) - -* [Chiavi SSH](Chiavi-SSH) \ No newline at end of file +BENVENUTO NELLA WIKI + +**Se vuoi iniziare subito a contribuire legge le...** + +* [Regole d'oro TL;DR](Regole-d-oro) + +**Procedure fondamentali operando da locale con GIT** + +* [Controllare e gestire l'upstream (git REMOTE)](Operazioni-fondamentali#controllare-e-gestire-lupstream-git-remote) +* [Aggiornamento del repo locale (git FETCH)](Appunti#aggiornamento-del-repo-locale-git-fetch) +* [Hard reset del main locale (git RESET)](Operazioni-fondamentali#hard-reset-del-main-locale-git-reset) +* [Aggiornamento di origin/main con l'upstream (git PULL)](Operazioni-fondamentali#aggiornamento-di-originmain-con-lupstream-git-pull) +* [Avanzamento di un branch da eseguire prima di un a PR (git PULL --REBASE)](Operazioni-fondamentali#avanzamento-di-un-branch-da-eseguire-prima-di-un-a-pr-git-pull---rebase) + +**Come pubblicare i contenuti usando Hugo** + +* [hugo new - creare contenuti in Locale](hugo-contrib/hugo-new.md) +* [hugo new - creare contenuti dal WEB](hugo-contrib/hugo-new-manualmente.md) + +**Link a comandi e guide per GIT** + +* [Merge](Merge) +* [Branch: comandi utili](Branch) +* [Rebase: come fare](Fare-il-rebase) +* [Spostare i commit](Spostare-commit) +* [Diff: differenze tra le versioni con git DIFF](Diff) +* [Relref - link interni](Relref) +* [Link guide online](Link-guide) +* [Chiavi SSH](Chiavi-SSH) + diff --git a/_Sidebar.md b/_Sidebar.md index c73d972..93e015f 100644 --- a/_Sidebar.md +++ b/_Sidebar.md @@ -1,18 +1,23 @@ -* [Home](Home) - -* [Regole d'oro TL;DR](Regole-d-oro) -* [Procedure fondamentali](Operazioni-fondamentali) - -Comandi: - -* [Branch](Branch) -* [Diff](Diff) -* [Merge](Merge) -* [Rebase](Fare-il-rebase) -* [Relref](Relref) -* [Spostare commit](Spostare-commit) - -Guide online: - -* [Git-scm Man-pages](https://git-scm.com/) -* [Git visuale Marklodato](https://marklodato.github.io/visual-git-guide/index-it.html) +* [Home](Home) + +Come contribuire usando Gitea +* [Regole d'oro TL;DR](Regole-d-oro) +* [Procedure fondamentali](Operazioni-fondamentali) + +Comandi hugo e struttura del sito +* [hugo new - creare contenuti in LOCALE](hugo-contrib/hugo-new.md) +* [hugo new - creare contenuti dal WEB](hugo-contrib/hugo-new-manualmente.md) + +Comandi GIT: + +* [Branch](Branch) +* [Diff](Diff) +* [Merge](Merge) +* [Rebase](Fare-il-rebase) +* [Relref](Relref) +* [Spostare commit](Spostare-commit) + +Guide online: + +* [Git-scm Man-pages](https://git-scm.com/) +* [Git visuale Marklodato](https://marklodato.github.io/visual-git-guide/index-it.html) diff --git a/hugo-contrib/gitea-PR-nuovo-contributo.png b/hugo-contrib/gitea-PR-nuovo-contributo.png new file mode 100644 index 0000000..8470071 Binary files /dev/null and b/hugo-contrib/gitea-PR-nuovo-contributo.png differ diff --git a/hugo-contrib/gitea-aggiungi-file.png b/hugo-contrib/gitea-aggiungi-file.png new file mode 100644 index 0000000..586b38a Binary files /dev/null and b/hugo-contrib/gitea-aggiungi-file.png differ diff --git a/hugo-contrib/gitea-aggiunta-media.png b/hugo-contrib/gitea-aggiunta-media.png new file mode 100644 index 0000000..a76018b Binary files /dev/null and b/hugo-contrib/gitea-aggiunta-media.png differ diff --git a/hugo-contrib/gitea-cancella-file.png b/hugo-contrib/gitea-cancella-file.png new file mode 100644 index 0000000..6972e80 Binary files /dev/null and b/hugo-contrib/gitea-cancella-file.png differ diff --git a/hugo-contrib/gitea-carica-cartella.png b/hugo-contrib/gitea-carica-cartella.png new file mode 100644 index 0000000..eea8e92 Binary files /dev/null and b/hugo-contrib/gitea-carica-cartella.png differ diff --git a/hugo-contrib/gitea-carica-max5.png b/hugo-contrib/gitea-carica-max5.png new file mode 100644 index 0000000..53c4aa8 Binary files /dev/null and b/hugo-contrib/gitea-carica-max5.png differ diff --git a/hugo-contrib/gitea-carica-media.png b/hugo-contrib/gitea-carica-media.png new file mode 100644 index 0000000..fc3d1e7 Binary files /dev/null and b/hugo-contrib/gitea-carica-media.png differ diff --git a/hugo-contrib/gitea-commit-online.png b/hugo-contrib/gitea-commit-online.png new file mode 100644 index 0000000..f027e41 Binary files /dev/null and b/hugo-contrib/gitea-commit-online.png differ diff --git a/hugo-contrib/gitea-crea-post.png b/hugo-contrib/gitea-crea-post.png new file mode 100644 index 0000000..a3c3827 Binary files /dev/null and b/hugo-contrib/gitea-crea-post.png differ diff --git a/hugo-contrib/gitea-creare-cartella.png b/hugo-contrib/gitea-creare-cartella.png new file mode 100644 index 0000000..db03bb9 Binary files /dev/null and b/hugo-contrib/gitea-creare-cartella.png differ diff --git a/hugo-contrib/gitea-creare-ramo.png b/hugo-contrib/gitea-creare-ramo.png new file mode 100644 index 0000000..a62dd19 Binary files /dev/null and b/hugo-contrib/gitea-creare-ramo.png differ diff --git a/hugo-contrib/gitea-ramo-selezionato.png b/hugo-contrib/gitea-ramo-selezionato.png new file mode 100644 index 0000000..30b3a0c Binary files /dev/null and b/hugo-contrib/gitea-ramo-selezionato.png differ diff --git a/hugo-contrib/hugo-new-evento-tree.png b/hugo-contrib/hugo-new-evento-tree.png new file mode 100644 index 0000000..748022a Binary files /dev/null and b/hugo-contrib/hugo-new-evento-tree.png differ diff --git a/hugo-contrib/hugo-new-manualmente.md b/hugo-contrib/hugo-new-manualmente.md new file mode 100644 index 0000000..16d6eda --- /dev/null +++ b/hugo-contrib/hugo-new-manualmente.md @@ -0,0 +1,106 @@ +Se non vuoi o non puoi utilizzare Hugo in locale, puoi comunque creare contenuti per il sito come spiegato di seguito. + +## Completamente online + +Accedi a Gitea e al tuo fork. Crea un ramo per il contributo che intendi pubblicare e selezionalo. + +### Creare il ramo dal main + +Clicca la scheda dei Rami (Branch) e crea un ramo partendo dal main. + +![Creare un nuovo ramo](gitea-creare-ramo.png) + +Controlla il ramo appena creato sia quello attivo e in cui creerai il contenuto. + +![Controlla il ramo attivo](gitea-ramo-selezionato.png) +### Creare cartella e file index.it.md + +Posizionati nella cartella dentro cui vuoi creare il contenuto. Generalmente si creano contenuti nelle cartelle _content/posts_ e _content/events_. Guarda il contenuto esistente e capirai come agire per rispettare la struttura scelta per la gestione dei contenuti. + +![Aggiungi file](gitea-aggiungi-file.png) +Le cartelle si creano automaticamente aggiungendo lo slash `/` in fondo al nome che hai appena scritto. + +![Crea una cartella](gitea-creare-cartella.png) + +Ricorda che i file devono essere così nominati: + + * index.it.md + * index.en.md + +![Crea un file](gitea-crea-post.png) + +Copia e incolla il **front matter dell'ultimo post** pubblicato o + +```yaml +--- +title: Cercasi volontari lettura AdaZ +author: pippo +type: post +date: 2024-07-03T16:04:23+00:00 +slug: volontari-lettura-adaz +aliases: + - /2024/07/03/aaa-volontari-cercasi-per-leggere-adazangemann/ +image: banner-manifestazione.png +image_alt: "Un'immagine tratta dal libro Ada&Zangemann in cui ritrae delle persone che sono in marcia per manifestare a favore del software libero" +summary: BgLUG e FabLab Bergamo stanno cercando volontari per promuovere il progetto formativo proposto dalla FSFE rivolto ai bambini delle scuole primarie. +categories: + - News + - Scuola +--- +``` + +**il front matter dell'ultimo evento** e personalizzalo. + +```yaml +--- +title: "2024 07 10 Evento Di Prova" +date: 2024-07-10T13:54:43+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: true # false se vuoi che venga pubblicato +slug: "2024-07-10-evento-di-prova" +type: post +image: image.png # se non metti un'immagine, viene presa la prima immagine del post +image_alt: "Descrizione dell'immagine. Il ratio dell'immagine deve essere 360x250." +summary: Se non presente, usa il testo dell'articolo +tags: + - eventi +categories: + - Eventi +--- +``` + +Al termine compila una descrizione per il commit e invia. + +![Compila descrizione per commit](gitea-commit-online.png) + +### Caricare media e allegati + +Carica gli allegati e i media se presenti. Puoi importali tutti insieme in un unico commit. + +![Aggiungi file media](gitea-carica-media.png) + +![Upload gruppo di file](gitea-aggiunta-media.png) + +A questo punto il nuovo contributo e pronto per poter essere inviato cliccando l'apposito pulsante **`Nuova Pull Request`**. + +![Cartella pronta per la PR](gitea-PR-nuovo-contributo.png) + +Per eliminare un file cliccalo e usa il cestino. Ogni cancellazione è un commit e non potrai cancellare l'intera cartella con un clic; in quel caso è più veloce cancellare l'intero ramo appena creato. +Quando hai cancellato l'ultimo file, verrà cancellata anche la cartella rimasta vuota. + +![Eliminazione di un file](gitea-cancella-file.png) + +## Caricare una cartella di file preparata in locale + +Ovviamente niente di vieta di creare tutto in locale con un editor di testo e preparare, con calma, una cartella con tutti gli allegati. + +Attenzione però che: +* dovrai specificare il nome della cartella prima di confermare il commit +* spostare i file successivamente non sempre è possibile (tipo con i jpg) +* non potrai caricare più di 5 file alla volta + +![](gitea-carica-cartella.png) +**Ricordati di compilare il nome della cartella** che vuoi creare e dentro cui verranno caricati i file pronti per l'upload. + +![Upload max 5 file](gitea-carica-max5.png) \ No newline at end of file diff --git a/hugo-contrib/hugo-new.md b/hugo-contrib/hugo-new.md new file mode 100644 index 0000000..45fa3a4 --- /dev/null +++ b/hugo-contrib/hugo-new.md @@ -0,0 +1,55 @@ +## Hugo new [command] + +La guida riguarda l'uso di Hugo in ambiente locale + +Se vuoi creare aggiungere contenuti usando Gitea da browser [leggi qua](hugo-new-manualmente). + +Per utilizzare un archetipo personalizzato, per esempio per creare un **evento**, dalla root del progetto eseguire il comando: + +`hugo new events/2024-07-10-evento-di-prova -k evento` + +Nella posizione indicata, in questo caso dentro la cartella _events_, verrà creata una sottocartella contenente i due file index, generati come indicato nell'archetipo **evento**. + +![Albero cartella archetipi e content](hugo-new-evento-tree.png) + +Per maggiori dettagli sul comando riferirsi alla guida `hugo new -h` + +``` +Create a new content file and automatically set the date and title. +It will guess which kind of file to create based on the path provided. + +You can also specify the kind with `-k KIND`. + +If archetypes are provided in your theme or site, they will be used. + +Ensure you run this within the root directory of your site. + +Usage: + hugo new content [path] [flags] + +Flags: + -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/ + --cacheDir string filesystem path to cache directory + -c, --contentDir string filesystem path to content directory + --editor string edit new content with this editor, if provided + -f, --force overwrite file if it already exists + -h, --help help for content + -k, --kind string content type to create + --renderSegments strings named segments to render (configured in the segments config) + -t, --theme strings themes to use (located in /themes/THEMENAME/) + +Global Flags: + --clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00 + --config string config file (default is hugo.yaml|json|toml) + --configDir string config dir (default "config") + --debug debug output + -d, --destination string filesystem path to write files to + -e, --environment string build environment + --ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern + --logLevel string log level (debug|info|warn|error) + --quiet build in quiet mode + -M, --renderToMemory render to memory (mostly useful when running the server) + -s, --source string filesystem path to read files relative from + --themesDir string filesystem path to themes directory + -v, --verbose verbose output +``` \ No newline at end of file