- bincio_wiki/pages/ — new home for all wiki content (2 wiki pages + _docs/ with 13 docs pages), tracked by the
container repo - bincio_wiki/blog/ — new home for all blog content - site/src/content.config.ts — base: '../pages' (was ./src/content/entries) - site/astro.config.mjs — added vite.server.fs.allow: ['..'] so Vite serves files from outside the project root; updated the delete watcher to watch ../pages/ - edit/server.py — default WIKI_PAGES_DIR is now pages (was site/src/content/entries) Content is now versioned in bincio_wiki. The submodule stays clean — it's just the engine.
This commit is contained in:
brutsalvadi
@@ -0,0 +1,118 @@
|
||||
---
|
||||
title: 'Come funziona questo giardino digitale (e perché esiste)'
|
||||
pubDate: '2026-05-02'
|
||||
description: 'Una guida semplice per capire la struttura e come contribuire'
|
||||
---
|
||||
|
||||
## Cos'è un giardino digitale?
|
||||
|
||||
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.
|
||||
|
||||
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
|
||||
|
||||
## La struttura
|
||||
|
||||
### Due sezioni
|
||||
|
||||
**📝 Blog** — Storie, ricordi, avventure in bicicletta. Esempi: "Bike trip to Morocco", "Barcelona—Valencia non-stop", "Quella volta che ci è piovuto addosso a 2000m".
|
||||
|
||||
**📚 Pages** — Guide, spiegazioni, riferimenti. Esempi: "Come riparare la catena", "Quali sono le categorie", "Come usare i wikilink".
|
||||
|
||||
### Wikilink — i fili che tengono insieme tutto
|
||||
|
||||
Quando scrivi su questo giardino, puoi collegare le cose con una sintassi speciale: `[[nome-della-pagina]]`.
|
||||
|
||||
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
|
||||
|
||||
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:
|
||||
|
||||
```
|
||||
BincioTech
|
||||
├─ Review del Garmin
|
||||
├─ Come sincronizzare il power meter
|
||||
└─ Lights comparision
|
||||
|
||||
BincioOfficina
|
||||
├─ Come pulire la catena
|
||||
├─ Riparazione del cambio
|
||||
└─ Cuscinetti rotti?
|
||||
```
|
||||
|
||||
**Quindi, operativamente:**
|
||||
|
||||
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]].
|
||||
```
|
||||
|
||||
### Nome della pagina
|
||||
|
||||
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`
|
||||
|
||||
### Dove mettere la pagina?
|
||||
|
||||
Se è un **ricordo o una storia**: va nella sezione pagine "blog"
|
||||
Se è una **guida o documentazione**: va nella sezione "pages"
|
||||
|
||||
Chi lo decide? Dipende dal contenuto. Se non sei sicuro, inizia con le pagine recenti — puoi sempre spostarlo.
|
||||
|
||||
## L'ordine delle cose — tema e gerarchia
|
||||
|
||||
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. 🌱
|
||||
Reference in New Issue
Block a user