Configuración por proyecto

La mayoría de los ajustes de MarkNode se aplican globalmente a todos los proyectos que abras. Sin embargo, algunos ajustes son intrínsecamente específicos de cada proyecto: por ejemplo, qué subcarpeta contiene los documentos que publicas. La pestaña Proyecto del cuadro de diálogo Ajustes te ofrece un lugar dedicado para anular los valores predeterminados globales en el proyecto actual, con los cambios guardados junto al propio proyecto.

Abrir los ajustes por proyecto

Abre Ajustes (Cmd+, en macOS, Ctrl+, en Windows y Linux) desde cualquier ventana de proyecto. La pestaña Proyecto aparece al final de la lista de la izquierda, debajo de las páginas General, Editor y Mapa mental, que se aplican a toda la aplicación. La ruta completa del proyecto se muestra en la parte superior de la página para que sepas a qué proyecto afectarán tus cambios.

La pestaña Proyecto se oculta cuando abres Ajustes desde la ventana de bienvenida o cuando no hay ningún proyecto cargado: los ajustes por proyecto solo tienen sentido cuando tienes un proyecto al que asociarlos.

Cómo funcionan las anulaciones

Cuando MarkNode lee un ajuste, primero busca una anulación en el proyecto actual. Si existe, se utiliza ese valor; de lo contrario, se aplica el valor predeterminado global.

Las anulaciones por proyecto se almacenan en la carpeta .dn/ de tu proyecto, el mismo lugar donde MarkNode guarda el resto del estado del proyecto. Si incluyes la carpeta .dn/ en Git, tus anulaciones viajan con el repositorio, de modo que todos los colaboradores obtienen la misma configuración.

Raíz de documentos

El motivo más habitual para usar los ajustes por proyecto es configurar una Raíz de documentos: una subcarpeta que debe tratarse como base para las rutas relativas y la resolución de imágenes. Esto resulta útil cuando tu proyecto tiene contenido anidado en una subcarpeta, por ejemplo:

  • Un sitio de Hugo o Jekyll donde el contenido vive en content/ o _posts/.
  • Un monorepo donde los documentos están en docs/ y el resto es código.
  • Un proyecto de curso o libro con los capítulos en course/.

Un árbol de carpetas del proyecto que muestra la raíz del proyecto con README.md, package.json y una subcarpeta course resaltada marcada como raíz de documentos. Dentro de la carpeta course están los capítulos Markdown reales y una carpeta de medios.

En la pestaña Proyecto, busca Raíz de documentos y escribe una ruta relativa a la raíz del proyecto o haz clic en Examinar para elegir una carpeta. Deja el campo vacío para usar la propia raíz del proyecto (el valor predeterminado).

Una vez establecida una raíz de documentos:

  • Al pegar una imagen, esta se guarda en la carpeta de medios configurada bajo la raíz de documentos, no en la raíz del proyecto.
  • El menú contextual del explorador de archivos ofrece dos acciones para copiar rutas: Copiar ruta desde la raíz del proyecto (el comportamiento existente) y Copiar ruta desde la raíz de documentos (relativa a la raíz de documentos). Cuando no hay ninguna raíz de documentos establecida, ambas producen el mismo resultado.
  • La reescritura de enlaces internos y la búsqueda de referencias usan la raíz de documentos cuando corresponde.

Si la carpeta que especificas todavía no existe, MarkNode muestra una advertencia pero guarda igualmente el ajuste, algo práctico si estás configurando un proyecto antes de crear su carpeta de contenido.

Ajustes por proyecto disponibles

Actualmente, la pestaña Proyecto contiene dos ajustes:

  • Raíz de documentos: descrita más arriba.
  • Mostrar automáticamente el panel de esquema: si el esquema se abre automáticamente en este proyecto (recordar el último estado, mostrar siempre u ocultar siempre).

Más ajustes pasarán a ser por proyecto en futuras versiones: todo aquello que esté intrínsecamente ligado a un único proyecto y no a tus preferencias personales.

Si buscas preferencias globales (tema, disposición del editor, valores predeterminados del mapa mental), abre las pestañas General, Editor o Mapa mental del mismo cuadro de diálogo de Ajustes. Esas se aplican a todos los proyectos.