Rewrite user docs, trim developer-only _docs pages, add python-multipart
This commit is contained in:
brutsalvadi
@@ -1,118 +1,59 @@
|
||||
---
|
||||
title: 'Come funziona questo giardino digitale (e perché esiste)'
|
||||
title: Come funziona questo wiki
|
||||
pubDate: '2026-05-02'
|
||||
description: 'Una guida semplice per capire la struttura e come contribuire'
|
||||
---
|
||||
|
||||
## Cos'è un giardino digitale?
|
||||
## Cos'è
|
||||
|
||||
Un giardino digitale è diverso da un blog. Un blog ha pagine ordinate per data — la più recente è in primo piano. Un giardino digitale è come un orto vero: crescono insieme tante cose diverse, ognuna con i propri tempi, e tutto è collegato.
|
||||
Un posto dove raccogliamo quello che vogliamo non dimenticare: gite, riparazioni, gear, allenamenti. Non è un blog con post ordinati per data — è più come un archivio vivo, dove le pagine si collegano tra loro e si aggiornano nel tempo.
|
||||
|
||||
Qui raccogliamo:
|
||||
- Ricordi di cose che abbiamo fatto insieme
|
||||
- Idee e spunti che tornano utili
|
||||
- Documentazione tecnica quando serve
|
||||
- Semplicemente: le cose che vogliamo non dimenticare
|
||||
## Due sezioni
|
||||
|
||||
## La struttura
|
||||
**Blog** — Storie e ricordi. Cose che abbiamo fatto: "Bike trip in Marocco", "Quella volta che ci ha piovuto addosso a 2000m".
|
||||
|
||||
### Due sezioni
|
||||
**Pagine** — Guide e riferimenti. Cose che tornano utili: "Come riparare la catena", "Quale lubrificante per la pioggia".
|
||||
|
||||
**📝 Blog** — Storie, ricordi, avventure in bicicletta. Esempi: "Bike trip to Morocco", "Barcelona—Valencia non-stop", "Quella volta che ci è piovuto addosso a 2000m".
|
||||
Se non sai dove mettere qualcosa, scegli Pagine. Si può spostare.
|
||||
|
||||
**📚 Pages** — Guide, spiegazioni, riferimenti. Esempi: "Come riparare la catena", "Quali sono le categorie", "Come usare i wikilink".
|
||||
## Categorie
|
||||
|
||||
### Wikilink — i fili che tengono insieme tutto
|
||||
Le pagine sono organizzate in cinque categorie. Vedi [[come-usare-le-categorie]] per scegliere quella giusta.
|
||||
|
||||
Quando scrivi su questo giardino, puoi collegare le cose con una sintassi speciale: `[[nome-della-pagina]]`.
|
||||
Quando crei una pagina dall'editor, scegli la categoria dal menu — il sistema la posiziona nel posto giusto automaticamente.
|
||||
|
||||
Esempio:
|
||||
- Scrivi un racconto su una escursione: "[[Escursione alle Tre Cime]]"
|
||||
- In fondo al racconto, aggiungi: "Leggi anche [[Escursione al Monte Baldo]]"
|
||||
- Nel sito vedi automaticamente il collegamento, e il lettore può saltare da una storia all'altra
|
||||
## Wikilink
|
||||
|
||||
Non serve elencare tutti i link a mano — il sistema li scopre da solo e li mostra alla fine di ogni pagina.
|
||||
|
||||
### L'albero — bonsai
|
||||
|
||||
Tutte le pagine sono organizzate in un albero gerarchico. Operativamente, funziona così:
|
||||
|
||||
**La pagina "BincioTech"** esiste come pagina vera e propria. Altre pagine la referenziano con un wikilink — ad esempio una pagina su "Review del Garmin" dirà: "Vedi anche [[BincioTech]]".
|
||||
|
||||
Quando il sito vede questi collegamenti, costruisce automaticamente l'albero. Quindi:
|
||||
Puoi collegare una pagina a un'altra scrivendo il nome tra doppie parentesi quadre:
|
||||
|
||||
```
|
||||
BincioTech
|
||||
├─ Review del Garmin
|
||||
├─ Come sincronizzare il power meter
|
||||
└─ Lights comparision
|
||||
|
||||
BincioOfficina
|
||||
├─ Come pulire la catena
|
||||
├─ Riparazione del cambio
|
||||
└─ Cuscinetti rotti?
|
||||
[[nome-della-pagina]]
|
||||
```
|
||||
|
||||
**Quindi, operativamente:**
|
||||
Esempio: stai scrivendo di un bike packing e vuoi rimandare a una pagina sull'equipaggiamento:
|
||||
|
||||
1. Crei una pagina normale: `review-del-garmin.md`
|
||||
2. Dentro scrivi: "Questo è un componente di [[BincioTech]]"
|
||||
3. Il sito vede il wikilink e posiziona la pagina sotto BincioTech nell'albero
|
||||
4. Quando leggi "Review del Garmin", vedi il percorso: `BincioTech > Review del Garmin`
|
||||
|
||||
Non serve fare nulla di complicato — basta usare il wikilink giusto nella pagina e il resto succede da solo.
|
||||
|
||||
## Come contribuire
|
||||
|
||||
### Creare una pagina
|
||||
|
||||
1. Una pagina è un semplice file di testo (Markdown)
|
||||
2. Ha un titolo e una data
|
||||
3. Dentro scrivi con il linguaggio che usi per gli SMS e le email — niente complicazioni
|
||||
4. Aggiungi i wikilink dove ha senso: `[[Pagina Collegata]]`
|
||||
|
||||
Esempio di pagina:
|
||||
|
||||
```markdown
|
||||
---
|
||||
title: "Quel sabato che eravamo ubriachi al bar"
|
||||
date: '2025-05-01'
|
||||
---
|
||||
|
||||
Ricordo ancora il primo drink che ci ha ordinato Giancarlo...
|
||||
|
||||
Successivamente siamo andati a [[La pizzeria dove sempre andiamo]].
|
||||
```
|
||||
Per i dettagli su cosa portare, vedi [[zaino-da-bikepacking]].
|
||||
```
|
||||
|
||||
### Nome della pagina
|
||||
Il collegamento appare nel testo, e nella pagina collegata comparirà automaticamente "citata da questa pagina" in fondo. Non devi fare altro.
|
||||
|
||||
Il nome è importante per i wikilink. Usa:
|
||||
- Parole normali, non gergo
|
||||
- Maiuscola all'inizio: `Escursione alle Tre Cime`, non `escursione alle tre cime`
|
||||
- Trattini al posto degli spazi: `Escursione-alle-Tre-Cime`
|
||||
- Descrittivo: `Racconto di Marco`, non `cosa`
|
||||
Per collegare una pagina alla sua categoria, aggiungi il wikilink della categoria nel testo:
|
||||
|
||||
### Dove mettere la pagina?
|
||||
```
|
||||
Questo fa parte di [[BincioTour]].
|
||||
```
|
||||
|
||||
Se è un **ricordo o una storia**: va nella sezione pagine "blog"
|
||||
Se è una **guida o documentazione**: va nella sezione "pages"
|
||||
## Come creare una pagina
|
||||
|
||||
Chi lo decide? Dipende dal contenuto. Se non sei sicuro, inizia con le pagine recenti — puoi sempre spostarlo.
|
||||
1. Clicca il pulsante di modifica nel sito
|
||||
2. Scegli la sezione e la sottosezione dal menu
|
||||
3. Scrivi un nome breve per la pagina (es. `garmin-edge-540-review`)
|
||||
4. Scrivi il contenuto in markdown — vedi [[markdown]] per la sintassi
|
||||
5. Salva
|
||||
|
||||
## L'ordine delle cose — tema e gerarchia
|
||||
## Consigli pratici
|
||||
|
||||
Prima che tutti iniziate a scrivere, vogliamo stabilire un sistema di temi. Immagina di dire:
|
||||
|
||||
> "Tutte le storie di gite sono sotto Ricordi → Escursioni"
|
||||
> "Tutte le ricette sono sotto Tecniche → Cucina"
|
||||
|
||||
Così quando leggi una pagina, vedi il percorso che l'ha raggiunta. Non è un'imposizione rigida — è più un'organizzazione che rende facile muoversi.
|
||||
|
||||
## Riassumendo
|
||||
|
||||
- **Scrivi in italiano, in modo naturale** — come se stessi scrivendo a un amico
|
||||
- **Collega le pagine con wikilink** — `[[Così]]` — e tutto il resto succede da solo
|
||||
- **Non preoccuparti della perfezione** — un giardino si evolve nel tempo
|
||||
- **Scegli un nome chiaro** per la pagina, così gli altri sanno di cosa parla
|
||||
|
||||
Pronto? Allora, piantare il primo seme. 🌱
|
||||
- **Scrivi in italiano, come se scrivessi a un amico** — niente gergo, niente formalismi
|
||||
- **Usa un nome descrittivo** per la pagina: `riparazione-raggi-ruota-posteriore` è meglio di `riparazione`
|
||||
- **Aggiungi wikilink** dove ha senso — collegare le pagine le rende più utili nel tempo
|
||||
- **Non serve che sia perfetto** — si può sempre modificare
|
||||
|
||||
Reference in New Issue
Block a user