Configurações por projeto

A maioria das configurações do MarkNode se aplica globalmente a todos os projetos que você abre. Algumas configurações, porém, são inerentemente específicas de cada projeto — por exemplo, qual subpasta contém os documentos que você publica. A aba Projeto na caixa de diálogo de Configurações oferece um lugar dedicado para substituir os padrões globais no projeto atual, com suas alterações salvas junto com o próprio projeto.

Abrindo as Configurações por Projeto

Abra Configurações (Cmd+, no macOS, Ctrl+, no Windows e no Linux) a partir de qualquer janela de projeto. A aba Projeto aparece na parte inferior da lista à esquerda, abaixo das páginas Geral, Editor e Mapa Mental, que valem para todo o aplicativo. O caminho completo do projeto é exibido no topo da página, para que você saiba qual projeto suas alterações vão afetar.

A aba Projeto fica oculta quando você abre as Configurações a partir da janela de boas-vindas ou quando nenhum projeto está carregado — as configurações por projeto só fazem sentido quando há um projeto ao qual associá-las.

Como Funcionam as Substituições

Quando o MarkNode lê uma configuração, ele primeiro procura uma substituição no projeto atual. Se houver, esse valor é usado; caso contrário, aplica-se o padrão global.

As substituições por projeto são armazenadas na pasta .dn/ do seu projeto, o mesmo lugar onde o MarkNode mantém outros estados do projeto. Se você versionar a pasta .dn/ no Git, suas substituições acompanham o repositório, de modo que todos os colaboradores recebem a mesma configuração.

Raiz de Documentos

O motivo mais comum para usar configurações por projeto é definir uma Raiz de Documentos — uma subpasta que deve ser tratada como base para caminhos relativos e resolução de imagens. Isso é útil quando seu projeto tem conteúdo aninhado em uma subpasta, por exemplo:

  • Um site Hugo ou Jekyll em que o conteúdo fica em content/ ou _posts/.
  • Um monorepo em que os documentos estão em docs/ e o restante é código.
  • Um projeto de curso ou livro com capítulos em course/.

Uma árvore de pastas do projeto mostrando a raiz do projeto com README.md, package.json e uma subpasta course destacada, marcada como raiz de documentos. Dentro da pasta course estão os capítulos Markdown propriamente ditos e uma pasta de mídia.

Na aba Projeto, localize Raiz de documentos e digite um caminho relativo à raiz do projeto ou clique em Procurar para escolher uma pasta. Deixe o campo vazio para usar a própria raiz do projeto (o padrão).

Depois que uma raiz de documentos estiver definida:

  • Colar uma imagem a salva na pasta de mídia configurada sob a raiz de documentos, e não sob a raiz do projeto.
  • O menu de contexto do explorador de arquivos oferece duas ações de cópia de caminho: Copiar Caminho a Partir da Raiz do Projeto (o comportamento existente) e Copiar Caminho a Partir da Raiz de Documentos (relativo à raiz de documentos). Quando nenhuma raiz de documentos está definida, ambas produzem o mesmo resultado.
  • A reescrita de links internos e a busca de referências usam a raiz de documentos quando aplicável.

Se a pasta que você especificar ainda não existir, o MarkNode exibe um aviso, mas mesmo assim salva a configuração — útil se você estiver preparando um projeto antes de a pasta de conteúdo ser criada.

Configurações Disponíveis por Projeto

A aba Projeto contém atualmente duas configurações:

  • Raiz de Documentos — descrita acima.
  • Exibir painel de estrutura automaticamente — se a estrutura do documento abre automaticamente para este projeto (lembrar o último estado, sempre exibir ou sempre ocultar).

Mais configurações passarão a ser por projeto conforme novas versões forem lançadas — qualquer uma que esteja inerentemente ligada a um único projeto, e não às suas preferências pessoais.

Se você procura preferências globais (tema, layout do editor, padrões do mapa mental), abra as abas Geral, Editor ou Mapa Mental na mesma caixa de diálogo de Configurações. Essas valem para todos os projetos.