Impostazioni per progetto

La maggior parte delle impostazioni di MarkNode si applica globalmente a ogni progetto che apri. Alcune impostazioni, però, sono per loro natura specifiche del progetto — per esempio, quale sottocartella contiene i documenti che pubblichi. La scheda Progetto nella finestra di dialogo Impostazioni ti offre uno spazio dedicato per sovrascrivere i valori predefiniti globali per il progetto corrente, con le modifiche salvate insieme al progetto stesso.

Aprire le impostazioni per progetto

Apri Impostazioni (Cmd+, su macOS, Ctrl+, su Windows e Linux) da una qualsiasi finestra di progetto. La scheda Progetto compare in fondo all’elenco di sinistra, sotto le pagine generali dell’app Generali, Editor e Mappa mentale. Il percorso completo del progetto è mostrato in cima alla pagina, così sai a quale progetto si applicheranno le tue modifiche.

La scheda Progetto è nascosta quando apri le Impostazioni dalla finestra di benvenuto o quando nessun progetto è caricato — le impostazioni per progetto hanno senso solo quando hai un progetto a cui associarle.

Come funzionano le sovrascritture

Quando MarkNode legge un’impostazione, cerca prima una sovrascrittura nel progetto corrente. Se ne esiste una, viene usato quel valore; altrimenti si applica il valore predefinito globale.

Le sovrascritture per progetto sono memorizzate nella cartella .dn/ del tuo progetto, lo stesso posto in cui MarkNode conserva gli altri dati di stato del progetto. Se includi la cartella .dn/ in Git, le tue sovrascritture viaggiano insieme al repository, così ogni collaboratore adotta la stessa configurazione.

Radice dei documenti

Il motivo più comune per usare le impostazioni per progetto è configurare una Radice dei documenti — una sottocartella che deve essere trattata come base per i percorsi relativi e la risoluzione delle immagini. Questo è utile quando il tuo progetto ha contenuti annidati in una sottocartella, per esempio:

  • Un sito Hugo o Jekyll in cui i contenuti si trovano sotto content/ o _posts/.
  • Un monorepo in cui i documenti sono in docs/ e il resto è codice.
  • Un progetto di corso o di libro con i capitoli sotto course/.

Un albero di cartelle di progetto che mostra la radice del progetto contenente README.md, package.json e una sottocartella course evidenziata e contrassegnata come radice dei documenti. All'interno della cartella course ci sono i veri capitoli Markdown e una cartella media.

Nella scheda Progetto, individua Radice dei documenti e digita un percorso relativo alla radice del progetto oppure fai clic su Sfoglia per scegliere una cartella. Lascia il campo vuoto per usare la radice del progetto stessa (l’impostazione predefinita).

Una volta impostata una radice dei documenti:

  • Incollando un’immagine, questa viene salvata nella cartella media configurata sotto la radice dei documenti, non sotto la radice del progetto.
  • Il menu contestuale dell’esplora file offre due azioni di copia del percorso: Copia percorso dalla radice del progetto (il comportamento esistente) e Copia percorso dalla radice dei documenti (relativo alla radice dei documenti). Quando nessuna radice dei documenti è impostata, entrambe producono lo stesso risultato.
  • La riscrittura dei link interni e la ricerca dei riferimenti usano la radice dei documenti quando applicabile.

Se la cartella che indichi non esiste ancora, MarkNode mostra un avviso ma salva comunque l’impostazione — comodo se stai preparando un progetto prima che la sua cartella dei contenuti sia stata creata.

Impostazioni per progetto disponibili

La scheda Progetto contiene attualmente due impostazioni:

  • Radice dei documenti — descritta sopra.
  • Mostra automaticamente il pannello struttura — se la struttura si apre automaticamente per questo progetto (ricorda l’ultimo stato, mostra sempre o nascondi sempre).

Altre impostazioni diventeranno specifiche per progetto nelle prossime versioni — tutto ciò che è intrinsecamente legato a un singolo progetto anziché alle tue preferenze personali.

Se cerchi le preferenze globali (tema, layout dell’editor, valori predefiniti della mappa mentale), apri le schede Generali, Editor o Mappa mentale nella stessa finestra di dialogo Impostazioni. Quelle si applicano a ogni progetto.