Diari

I diari sono serie di documenti periodici in un’area: ogni diario ha una granularità (giorno, settimana, mese, trimestre o anno), uno schema di cartella e uno schema di nome basati su segnaposto di data, un modello facoltativo e proprietà di data automatiche nel frontmatter. Gli scaffali raggruppano più diari, ad esempio dal giorno all’anno di un taccuino. Le voci vengono aperte o create al primo accesso, tramite i comandi, il pannello calendario o il blocco di navigazione.

I diari esistono solo all’interno di un’area: la configurazione vive nel file dell’area e tutti i percorsi sono relativi alla radice dell’area. Senza area, comandi e pannello mostrano un avviso. La funzionalità è commutabile come estensione «Diari» (Impostazioni → Estensioni).

Definire diari e scaffali

Impostazioni → Diari mostra gli scaffali dell’area; «Apri» su uno scaffale porta ai suoi diari, «Chiudi scaffale» riporta alla panoramica (la riga «Senza scaffale» raccoglie i diari senza assegnazione). Per diario:

• Nome e, facoltativamente, uno scaffale.
• Granularità: giorno, settimana, mese, trimestre o anno.
• Schema di cartella e schema di nome: letterali più i segnaposto di data dei modelli ({{date::…}}), valutati all’inizio del periodo. Un’anteprima mostra il percorso di esempio del periodo attuale.
• Modello (facoltativo) dalla cartella dei modelli; la creazione esegue la valutazione completa dei segnaposto, dialoghi compresi.
• Data di inizio/fine (facoltativa): prima o dopo non vengono create voci e la navigazione si ferma lì.
• Nomi di campo delle proprietà di data automatiche.

Esempio di un diario settimanale con sottocartelle per anno:

La voce della settimana 28 del 2026 si trova quindi in Diario/2026/2026-KW28.md. Per le settimane esistono due token di formato aggiuntivi: ww (settimana ISO, due cifre) e kkkk (anno della settimana, che al cambio d’anno può differire dall’anno civile); le maiuscole come KW restano letterali. Per i trimestri il token q fornisce il numero del trimestre (1–4), ad esempio {{date::yyyy-Qq}} → 2026-Q3.

Uno schema modificato non rinomina i file esistenti; i punti del calendario e il riconoscimento delle voci seguono il nuovo schema. I file periodici esistenti corrispondono automaticamente se gli schemi di cartella e nome sono configurati in modo identico.

Aprire e creare voci

• Voce di diario di oggi (menu File → Altre funzioni file): apre o crea la voce di oggi di un diario giornaliero; con selezione se esistono più diari giornalieri.
• Voce di diario per una data… (menu File → Altre funzioni file): chiede una data (AAAA-MM-GG) e il diario; il periodo è quello della data nella granularità del diario.

La creazione produce la catena di cartelle, il contenuto del modello compilato (una voce vuota senza modello) e le proprietà del diario nel frontmatter. Una voce porta quattro proprietà, indipendentemente dalla granularità: il nome del diario (journal), la data del periodo (journal-date), l’inizio (journal-start-date) e la fine (journal-end-date). La data del periodo è sempre il suo inizio; nelle voci giornaliere le tre date coincidono quindi. I nomi di campo sono configurabili per diario e disponibili per la query Perspective — poiché ogni voce porta lo stesso insieme, una query non deve distinguere per granularità. I segnaposto di data del modello vengono valutati all’inizio del periodo: {{date}} restituisce la data del periodo, non il momento della creazione. Annullare un dialogo del modello interrompe la creazione; non viene creato alcun file.

Una voce già esistente viene completata quando le mancano proprietà, per esempio perché proviene da un’altra applicazione o è stata creata a mano. Ciò avviene in due modi. All’apertura tramite comando, calendario o blocco di navigazione, le proprietà mancanti vengono aggiunte in silenzio; se la voce è già completa, il file resta intatto. Il comando Completare le proprietà del diario… porta tutte le voci esistenti di un diario allo stesso stato in una volta; prima indica quante voci vengono controllate e chiede conferma.

Creare e completare si comportano volutamente in modo diverso: alla creazione l’applicazione imposta le proprietà e sovrascrive i campi omonimi del modello. Al completamento viene aggiunto solo ciò che manca; un valore esistente resta anche se diverge dal periodo, perché può essere una correzione deliberata. I campi estranei e il resto del contenuto restano intatti in entrambi i casi, e un frontmatter danneggiato non viene toccato.

Pannello calendario

Il pannello calendario (simbolo del calendario nella barra di stato) mostra la vista mensile dell’area:

• Intestazione dei giorni con inizio lunedì, a sinistra la colonna delle settimane ISO.
• I punti segnano i giorni con una voce giornaliera esistente; oggi è evidenziato.
• Un clic su un giorno apre o crea la voce giornaliera; un clic sulla cella della settimana, la voce settimanale; con più diari corrispondenti compare una selezione.
• Il filtro dell’intestazione limita a tutti i diari, uno scaffale o un singolo diario; le frecce sfogliano i mesi e il pulsante Oggi torna al mese attuale.

Blocco di navigazione

Il blocco di navigazione sta nella voce come blocco di codice, tipicamente tramite il modello del diario:

```perspective-journal-nav
```

All’interno di una voce di diario mostra il periodo attuale in grande (sotto, la collocazione temporale: «Oggi» o «Questa settimana» per il periodo in corso, altrimenti la sua distanza — «ieri», «3 settimane fa», «tra 2 anni», sempre nell’unità del periodo), sopra i periodi superiori dello stesso scaffale (mese, trimestre, anno, dove esiste un diario; le lacune vengono omesse) e frecce al periodo precedente e successivo. I clic aprono le voci e creano quelle mancanti; la navigazione si ferma ai limiti di data del diario. Le due frecce sfogliano nella stessa scheda: la voce precedente cede il posto alla nuova, e la scheda conserva modalità di visualizzazione, modalità di modifica, ingrandimento, gruppo e posizione. Se porta modifiche non salvate compare la stessa domanda della chiusura; se la voce vicina è già aperta, viene attivata la sua scheda. I collegamenti ai periodi superiori aprono invece una scheda propria, perché cambiano livello invece di sfogliare. Accanto a ogni freccia sta il nome del suo periodo di destinazione, così si vede dove porta; se il blocco si restringe, quel nome cede e il pulsante resta. Un punto sotto un periodo significa: quella voce esiste già — lo stesso segno del pannello calendario e della linea del tempo. Compare su tutti i periodi del blocco, anche su quelli superiori e su entrambi i vicini; dove manca, il clic crea la voce. Proprio qui, nella pagina del manuale, lo stesso blocco mostra l’avviso per i documenti al di fuori di un diario:

Entrambi i blocchi del diario, questo e la linea temporale più sotto, verificano inoltre di riferirsi alla voce visualizzata. In caso contrario, o se la voce non esiste più, un messaggio di errore sostituisce la visualizzazione: un periodo errato non sarebbe riconoscibile come tale e viene quindi omesso.

Nell’esportazione PDF e portabile il blocco viene sostituito dall’etichetta statica del periodo, senza collegamenti di creazione.

Blocco linea temporale

Il blocco linea temporale mostra il quadro dei periodi come calendario dentro la voce. Conosce quattro modi:

```perspective-journal-timeline
mode: month
```

calendar è la grafia equivalente di year (proviene da materiale importato). Senza l’indicazione mode vale month. Un valore sconosciuto compare come avviso dentro il blocco, così un errore di battitura non passa inosservato.

Struttura. La colonna dei numeri di settimana sta a sinistra, l’intestazione dei giorni in alto, a partire da lunedì. I giorni con una voce già presente portano un punto, il giorno corrente è in evidenza. La riga di intestazione mostra i periodi sopra il livello del calendario, e il livello del modo è in evidenza: il modo settimana evidenzia la settimana, il modo mese il mese, il modo trimestre il trimestre, il modo anno l’anno.

Clic. Ogni elemento apre il proprio periodo: il giorno apre la voce giornaliera, la settimana la voce settimanale, il nome del mese e le etichette di intestazione il rispettivo periodo. Le voci mancanti vengono create nel farlo. Contano i diari dello scaffale a cui appartiene la voce; dove quello scaffale non ha un diario per un livello, l’etichetta è di sola lettura. Fuori dai limiti di data di un diario non nasce alcuna voce.

Il periodo mostrato dal blocco segue la voce in cui si trova, non il giorno corrente: nella nota settimanale di una settimana passata, month mostra il mese di quella settimana.

Come il blocco di navigazione, anche questo blocco compare come avviso fuori da una voce di diario:

L’esportazione PDF stampa il calendario così come appare sullo schermo. L’esportazione portabile lo trasforma in una tabella per mese, con un punto sui giorni che hanno una voce e senza collegamenti di creazione.

Regole di settimana

Le settimane seguono rigorosamente ISO 8601: la settimana inizia il lunedì e la prima settimana di un anno è quella che contiene il primo giovedì. L’anno della settimana (kkkk) può quindi differire dall’anno civile (yyyy) al cambio d’anno: il 1° gennaio 2021, ad esempio, appartiene alla settimana 53 dell’anno di settimana 2020.