Links Pendentes - Guia de Uso do Plugin Broken Links

Resumo

O plugin "Broken Links" do Obsidian permite identificar e gerenciar links quebrados em seu vault. Este documento fornece instruções sobre como usar o plugin para encontrar e corrigir links pendentes.

O plugin identifica:

• Links para arquivos inexistentes
• Links para cabeçalhos inexistentes dentro de arquivos
• Links para blocos inexistentes dentro de arquivos

Você pode visualizar os links quebrados de três formas:

• Agrupados por pasta
• Agrupados por arquivo de origem
• Agrupados por link de destino

Como Usar o Plugin Broken Links

1. Abrir o plugin:

   • Clique no ícone "Broken Links" na barra lateral do Obsidian (ícone de link quebrado)
   • Ou use o comando "View broken links" no Command Palette (Ctrl+P)
   • Ou execute o comando: Broken Links: View broken links

2. Visualizar links quebrados:

   • Os links quebrados serão mostrados em uma estrutura de árvore organizada por pasta, arquivo ou link
   • Você pode alternar entre essas visualizações usando os botões na parte superior do painel

3. Navegar pelos links quebrados:

   • Clique em uma pasta para expandir/recolher seu conteúdo
   • Clique em um arquivo para ver os links quebrados que ele contém
   • Clique em um link quebrado para abrir o arquivo onde ele está localizado

4. Corrigir links quebrados:

   • Ao clicar em um link quebrado, o Obsidian abrirá o arquivo na posição exata do link
   • Você pode então editar o link para apontar para um arquivo existente ou criar o arquivo ausente

Configurações do Plugin

Para acessar as configurações do plugin:

1. Abra as Configurações do Obsidian (ícone de engrenagem)
2. Navegue até "Community plugins"
3. Encontre "Broken Links" e clique em "Options"

Opções disponíveis:

• Agrupar por: Escolha como os links quebrados são organizados (pasta, arquivo, link)
• Ordenação: Configure como pastas, arquivos e links são ordenados
• Pastas ignoradas: Especifique pastas que devem ser excluídas da análise
• Consolidar links: Agrupe links idênticos mesmo que tenham texto de exibição diferente

Dicas para Gerenciar Links Quebrados

1. Criar arquivos ausentes:

   • Clique com o botão direito em um link quebrado e selecione "Create new note"
   • Isso criará automaticamente um novo arquivo com o nome correto

2. Renomear links:

   • Se um arquivo foi renomeado, atualize todos os links quebrados para apontar para o novo nome
   • Use a funcionalidade de busca e substituição do Obsidian para fazer isso em massa

3. Verificação regular:

   • Faça verificações periódicas de links quebrados para manter seu vault organizado
   • Considere corrigir links quebrados assim que eles aparecerem

4. Pastas para verificar com prioridade:

   • Notas/01-Fundamentos/A-Conceitos-Centrais
   • Notas/01-Fundamentos/B-Receptores-Sinalizacao
   • Notas/01-Fundamentos/C-Sistema-Hormonal
   • Notas/01-Fundamentos/F-Regulacao-Molecular

Problemas Comuns em Seu Vault

Baseado na estrutura de pastas do seu vault, alguns problemas comuns de links quebrados podem ser:

1. Links para arquivos com nomes alterados:

   • Arquivos de conceitos que foram renomeados (ex: de "EAA" para "Esteroides Anabólicos Androgênicos")
   • Links que usam abreviações mas apontam para arquivos com nomes completos

2. Links para arquivos em pastas diferentes:

   • Links entre as pastas de fundamentos e compostos
   • Links de protocolos para conceitos fundamentais

3. Links com caracteres especiais:

   • Arquivos com acentos que podem ter sido referenciados sem acentuação
   • Caracteres especiais que podem causar problemas de codificação

4. Links para seções inexistentes:

   • Links para cabeçalhos que foram renomeados ou removidos
   • Links para blocos que foram movidos para outros arquivos

Benefícios de Manter Links Íntegros

• Navegação mais fluida entre notas relacionadas
• Melhor organização do conhecimento
• Prevenção de perda de informações importantes
• Experiência de uso mais agradável do Obsidian

Passo a Passo para Corrigir Links Quebrados no Seu Vault

1. Identificação inicial:

   • Abra o plugin Broken Links usando o comando Broken Links: View broken links
   • Observe o número total de links quebrados no seu vault

2. Priorização:

   • Comece pelas pastas com mais links quebrados
   • Dê prioridade aos arquivos mais importantes ou mais frequentemente acessados

3. Análise e correção:

   • Para cada link quebrado, determine se:
     • O arquivo de destino existe mas com nome diferente (renomeie o link)
     • O arquivo de destino não existe (crie o arquivo)
     • O link está incorreto (corrija o link)

4. Verificação:

   • Após corrigir um conjunto de links, atualize a visualização do plugin
   • Confirme que os links corrigidos não aparecem mais na lista

5. Documentação:

   • Mantenha um registro das correções feitas
   • Documente padrões de nomenclatura para evitar problemas futuros

Nota: Este documento é um guia para usar o plugin Broken Links. Para obter uma lista completa e atualizada de links quebrados, use o plugin diretamente no Obsidian seguindo as instruções acima.