Paramètres par projet

La plupart des réglages de MarkNode s’appliquent globalement à chaque projet que vous ouvrez. Certains réglages, cependant, sont par nature propres au projet — par exemple, le sous-dossier qui contient les documents que vous publiez. L’onglet Projet de la boîte de dialogue Réglages vous offre un espace dédié pour remplacer les valeurs globales par défaut pour le projet en cours, vos modifications étant enregistrées avec le projet lui-même.

Ouvrir les réglages propres au projet

Ouvrez les Réglages (Cmd+, sur macOS, Ctrl+, sur Windows et Linux) depuis n’importe quelle fenêtre de projet. L’onglet Projet apparaît en bas de la liste de gauche, sous les pages Général, Éditeur et Carte mentale, qui concernent l’application entière. Le chemin complet du projet est affiché en haut de la page afin que vous sachiez quel projet vos modifications affecteront.

L’onglet Projet est masqué lorsque vous ouvrez les Réglages depuis la fenêtre d’accueil ou lorsqu’aucun projet n’est chargé — les réglages propres au projet n’ont de sens que si vous avez un projet auquel les rattacher.

Fonctionnement des remplacements

Lorsque MarkNode lit un réglage, il cherche d’abord un remplacement dans le projet en cours. S’il en existe un, cette valeur est utilisée ; sinon, la valeur globale par défaut s’applique.

Les remplacements propres au projet sont stockés dans le dossier .dn/ de votre projet, à l’endroit même où MarkNode conserve les autres données d’état du projet. Si vous versionnez le dossier .dn/ dans Git, vos remplacements accompagnent le dépôt et chaque collaborateur récupère ainsi la même configuration.

Racine des documents

La raison la plus courante d’utiliser les réglages propres au projet est de configurer une Racine des documents — un sous-dossier qui doit servir de base pour les chemins relatifs et la résolution des images. C’est utile lorsque le contenu de votre projet est imbriqué dans un sous-dossier, par exemple :

  • Un site Hugo ou Jekyll dont le contenu se trouve sous content/ ou _posts/.
  • Un monorepo où les documents sont dans docs/ et le reste est du code.
  • Un projet de cours ou de livre avec les chapitres sous course/.

Arborescence d'un dossier de projet montrant la racine du projet contenant README.md, package.json et un sous-dossier course mis en évidence, désigné comme racine des documents. Le dossier course contient les chapitres Markdown eux-mêmes ainsi qu'un dossier media.

Dans l’onglet Projet, repérez Racine des documents et saisissez un chemin relatif à la racine du projet, ou cliquez sur Parcourir pour choisir un dossier. Laissez le champ vide pour utiliser la racine du projet elle-même (valeur par défaut).

Une fois une racine des documents définie :

  • Le collage d’une image l’enregistre dans le dossier média configuré sous la racine des documents, et non sous la racine du projet.
  • Le menu contextuel de l’explorateur de fichiers propose deux actions de copie de chemin : Copier le chemin depuis la racine du projet (le comportement existant) et Copier le chemin depuis la racine des documents (relatif à la racine des documents). Lorsqu’aucune racine des documents n’est définie, les deux produisent le même résultat.
  • La réécriture des liens internes et la recherche de références utilisent la racine des documents le cas échéant.

Si le dossier que vous indiquez n’existe pas encore, MarkNode affiche un avertissement mais enregistre tout de même le réglage — pratique si vous configurez un projet avant que son dossier de contenu ne soit créé.

Réglages propres au projet disponibles

L’onglet Projet contient actuellement deux réglages :

  • Racine des documents — décrite ci-dessus.
  • Afficher automatiquement le panneau de plan — indique si le plan s’ouvre automatiquement pour ce projet (mémoriser le dernier état, toujours afficher ou toujours masquer).

D’autres réglages deviendront propres au projet au fil des prochaines versions — tout ce qui est intrinsèquement lié à un projet particulier plutôt qu’à vos préférences personnelles.

Si vous cherchez les préférences globales (thème, disposition de l’éditeur, valeurs par défaut des cartes mentales), ouvrez les onglets Général, Éditeur ou Carte mentale de la même boîte de dialogue Réglages. Ceux-ci s’appliquent à tous les projets.