brutsalvadi
0f8bd3dba6
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.
4.3 KiB
title, pubDate, description
| title | pubDate | description |
|---|---|---|
| Come funziona questo giardino digitale (e perché esiste) | 2026-05-02 | 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:
- Crei una pagina normale:
review-del-garmin.md - Dentro scrivi: "Questo è un componente di BincioTech"
- Il sito vede il wikilink e posiziona la pagina sotto BincioTech nell'albero
- 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
- Una pagina è un semplice file di testo (Markdown)
- Ha un titolo e una data
- Dentro scrivi con il linguaggio che usi per gli SMS e le email — niente complicazioni
- Aggiungi i wikilink dove ha senso:
[[Pagina Collegata]]
Esempio di pagina:
---
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, nonescursione alle tre cime - Trattini al posto degli spazi:
Escursione-alle-Tre-Cime - Descrittivo:
Racconto di Marco, noncosa
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. 🌱