Abstract
This document explains the technical architecture of the ColivingLiguria website. It details our use of Quartz as a static site generator, our GitHub-based workflow, and how our technical team collaborates on the codebase.
Website Architecture & Workflow
How We Build It
Our digital garden is built using Quartz, a fast and flexible static site generator designed for Obsidian users. This allows us to write content in simple Markdown files (like this one) while automatically publishing them as a rich, interconnected website.
GitHub Integration
The entire project, including content and code, is hosted on GitHub. This provides us with:
- Version Control: We can track every change, revert mistakes, and see the history of our project’s evolution.
- Collaboration: Our technical team works directly on the repository. Changes are proposed via Pull Requests, reviewed, and then merged into the main site.
- Transparency: The structure of our site mirrors the structure of our folders.
Accessing the Code
If you are a developer or technical contributor, you can view the entire source code and content structure directly on our repository. For a deeper dive into the software tools we use, please refer to: 👉 Software for ColivingLiguria
Want to contribute? If you want to access our code or contribute to the development, simply ask us for access to the GitHub repository. We welcome collaboration!
— Italiano sotto —
Abstract
Questo documento spiega l’architettura tecnica del sito web di ColivingLiguria. Dettaglia il nostro uso di Quartz come generatore di siti statici, il nostro flusso di lavoro basato su GitHub e come il nostro team tecnico collabora sul codice.
Architettura del Sito & Flusso di Lavoro
Come Lo Costruiamo
Il nostro giardino digitale è costruito utilizzando Quartz, un generatore di siti statici veloce e flessibile progettato per gli utenti di Obsidian. Questo ci permette di scrivere contenuti in semplici file Markdown (come questo) pubblicandoli automaticamente come un sito web ricco e interconnesso.
Integrazione GitHub
L’intero progetto, inclusi contenuti e codice, è ospitato su GitHub. Questo ci fornisce:
- Controllo Versione: Possiamo tracciare ogni modifica, annullare errori e vedere la storia dell’evoluzione del nostro progetto.
- Collaborazione: Il nostro team tecnico lavora direttamente sulla repository. Le modifiche vengono proposte tramite Pull Request, revisionate e poi unite al sito principale.
- Trasparenza: La struttura del nostro sito rispecchia la struttura delle nostre cartelle.
Accesso al Codice
Se sei uno sviluppatore o un collaboratore tecnico, puoi visualizzare l’intero codice sorgente e la struttura dei contenuti direttamente sulla nostra repository. Per un approfondimento sugli strumenti software che utilizziamo, fai riferimento a: 👉 Software per ColivingLiguria
Vuoi contribuire? Se vuoi accedere al nostro codice o contribuire allo sviluppo, chiedici semplicemente l’accesso alla repository GitHub. Accogliamo con favore la collaborazione!