LaTeX PDF Synchronization Guide
This document clearly defines the desired synchronization structure between the source LaTeX files and the final compiled PDFs served via Quartz on the ColivingLiguria website.
Core Sync Principle
The fundamental architectural principle is to maintain structural parity between the root directories in LaTeX_CL where documents are created, and the public assets folders in Quartz_CL. If a document is moved or structurally altered in LaTeX, it must gracefully map to the same conceptual bucket in the frontend.
The Sync Script CL-sync-documents
The python script CL-sync-documents serves as the automated bridge. It reads specific .tex/.pdf bundles from the LaTeX repository and accurately copies them into Quartz_CL/quartz/public/... utilizing MD5 checksums for extreme speed and precision.
IMPORTANT
This structure is monitored and validated using the CL-SD Sync Dashboard, which actively reports the synchronization status. A unified dashboard prevents manual copying mistakes.
Guaranteed Document Architecture
Legal Documents & Contracts
These are the most critical elements and must never encounter broken paths. They are mapped into /Legal/....
1. Residential Contracts (/Legal/Contracts/Living)
| LaTeX Source Directory | Target PDF Path on Quartz |
|---|---|
LaTeX_CL/Legal/Contracts/Living/ContractForResidents | /Legal/Contracts/Living/ContractForResidents.pdf |
LaTeX_CL/Legal/Contracts/Living/ProtocontractForResidents | /Legal/Contracts/Living/ProtocontractForResidents.pdf |
2. Business Contracts (/Legal/Contracts/Business)
| LaTeX Source Directory | Target PDF Path on Quartz |
|---|---|
LaTeX_CL/Legal/Contracts/Business/ContractForWebsiteDesigner | /Legal/Contracts/Business/ContractForWebsiteDesigner.pdf |
LaTeX_CL/Legal/Contracts/Business/ContractForTutor | /Legal/Contracts/Business/ContractForTutor.pdf |
LaTeX_CL/Legal/Contracts/Business/ContractForEventOrganiser | /Legal/Contracts/Business/ContractForEventOrganiser.pdf |
LaTeX_CL/Legal/Contracts/Business/ContractForGeometra | /Legal/Contracts/Business/ContractForGeometra.pdf |
LaTeX_CL/Legal/Contracts/Business/ContractForSocialMediaManager | /Legal/Contracts/Business/ContractForSocialMediaManager.pdf |
3. Allegati (Appendices) (/Legal/Contracts/Allegati)
| LaTeX Source Directory | Target PDF Path on Quartz |
|---|---|
LaTeX_CL/Legal/Contracts/Allegati/A_Inventario | /Legal/Contracts/Allegati/A_Inventario.pdf |
LaTeX_CL/Legal/Contracts/Allegati/B_Condizioni_Abitative | /Legal/Contracts/Allegati/B_Condizioni_Abitative.pdf |
LaTeX_CL/Legal/Contracts/Allegati/D_Procedure_Emergenza | /Legal/Contracts/Allegati/D_Procedure_Emergenza.pdf |
LaTeX_CL/Legal/Contracts/Allegati/F_Gestione_Finanziaria | /Legal/Contracts/Allegati/F_Gestione_Finanziaria.pdf |
LaTeX_CL/Legal/Contracts/Allegati/P_Privacy_IT | /Legal/Contracts/Allegati/P_Privacy_IT.pdf |
LaTeX_CL/Legal/Contracts/Allegati/R_Registro_Interno | /Legal/Contracts/Allegati/R_Registro_Interno.pdf |
Regulations
| LaTeX Source Directory | Target PDF Path on Quartz |
|---|---|
LaTeX_CL/Legal/Regulations/Testo-Unico-Normative | /Legal/Regulations/Testo-Unico-Normative.pdf |
LaTeX_CL/Legal/Regulations/Construction/Wood_Stove_Engineering_and_Regulations | /Legal/Regulations/Construction/Wood_Stove_Engineering_and_Regulations.pdf |
Real Estate / Houses
These files relate to specific architectural and structural files for properties.
Casa del Forno (/Houses/Casa_del_Forno/...)
| LaTeX Source Directory | Target PDF Path on Quartz |
|---|---|
LaTeX_CL/Architecture/Properties/Casa_del_Forno/Layout/Relazione_Descrittiva_Edifici | /Houses/Casa_del_Forno/Relazione_Descrittiva_Edifici.pdf |
Enforcement via CL-SD
The architecture detailed above represents the baseline truth. Any deviation will immediately manifest as a broken link via the DocumentLinks.ts central repository map. Use the dashboard to ensure the .pdf checksum matches immediately after running CL-sync-latex which generates the master files.