obsidian imgur plugin

Plug-in Obsidiana Imgur

Este plugin carrega imagens para imgur.com em vez de armazená-las localmente em seu cofre.

Por que?

Obsidian armazena todos os dados localmente por design (o que é perfeito para texto e, na minha opinião, pode ser melhorado para imagens). Se você costuma adicionar imagens às suas anotações, seu cofre pode aumentar rapidamente de tamanho. O que, por sua vez, pode levar ao alcance de limites se você usar planos gratuitos de serviços de armazenamento em nuvem para sincronizar suas notas ou pode levar ao crescimento do tamanho do repositório se você usar o git para fazer backup de suas notas.

Este plugin é uma solução perfeita para pessoas que colam imagens em suas anotações diariamente (ou seja, estudantes fazendo capturas de tela de slides de aula) e não querem sobrecarregar seus cofres com arquivos de imagem.

Ter imagens remotas também torna muito mais fácil compartilhar uma nota com qualquer outra pessoa, você só precisará compartilhar um único arquivo.

Se não tiver certeza se esta solução é para você, confira a seção de perguntas frequentes e/ou um vídeo criado por @santiyounger discutindo os prós e os contras dessa abordagem

Características

• Faça upload de imagens anonimamente ou para sua conta Imgur
• Faça upload de imagens colando-as da área de transferência ou arrastando-as do sistema de arquivos
• Suporte para upload de gifs animados arrastando e soltando

Instalação

Instale o plugin através da guia Community Plugins no Obsidian

Começando

Gerando ID do cliente

Para que este plugin funcione de forma confiável e para evitar atingir os limites de taxas diárias ao usar um único Client ID compartilhado, foi decidido que cada usuário deveria criar seu próprio "Client ID". Aqui estão as etapas:

0. Se você não possui uma conta Imgur, você precisa obter uma primeiro - siga https://imgur.com/register
1. Estando autenticado, acesse https://api.imgur.com/oauth2/addclient
2. Use qualquer nome para "Nome do aplicativo". Por exemplo: "Plugin Obsidian Imgur"
3. Escolha "Autorização OAuth 2 com URL de retorno de chamada "
4. Importante: use obsidian://imgur-oauth como um valor de "URL de retorno de chamada de autorização"
5. Preencha o campo "E-mail" e prossiga para obter seu ID de Cliente

Configure o ID do cliente recém-recebido nas configurações do plugin Obsidian Imgur ¹ .

Após a criação, o Client ID pode ser gerenciado em: https://imgur.com/account/settings/apps

Upload autenticado

Vá para as configurações do plugin, selecione 'Upload de Imgur autenticado' e conclua a autenticação. Isso é tudo! Agora você está pronto para fazer anotações e enviar todas as suas imagens remotamente. Você verá todas as imagens enviadas em https://your_login.imgur.com/all/

Carregamento anônimo

Você pode não querer ver suas imagens Obsidian vinculadas à conta Imgur.

Para este caso existe a opção ‘Upload anônimo de Imgur’.

Perguntas frequentes

P: Quão segura é essa abordagem?
R: Ninguém vê a imagem enviada, a menos que você compartilhe um link ou alguém adivinhe magicamente o URL da sua imagem.

P: Posso remover uma imagem remota enviada acidentalmente?
R: Para uploads autenticados - sim, vá para https://your_login.imgur.com/all/, para uploads anônimos - não (é tecnicamente possível, mas você precisará de um deleteHash que não está registrado. Eu gravaria, mas ainda não há lugar para fazer login no Obsidian)

P: Por quanto tempo uma imagem permanece no imgur.com? Existe uma chance de perder os dados?
R: Para uploads autenticados, acho que eles nunca são excluídos. E quanto aos uploads anônimos? Anteriormente, foi declarado no site Imgur que a imagem que você carrega permanece para sempre . Acho que isso é verdade desde 2015. Hoje não consegui encontrar essa afirmação no site Imgur. Posso presumir que imagens que não foram visualizadas durante anos podem ser removidas, mas não há nada com que se preocupar. Você pode ler meus pensamentos detalhados sobre isso nas discussões

P: Imgur oferece suporte a vídeos. O plugin suporta upload de vídeos?
R: Não. Inicialmente, não considerei o suporte para upload de vídeos, pois não há sintaxe Markdown para incorporar vídeos. Por outro lado, você pode simplesmente usar a tag HTML <video> , então provavelmente adicionarei suporte para vídeos no futuro

P: É possível fazer upload de imagens para algum outro serviço?
R: Por enquanto, não há planos para oferecer suporte a outras soluções de hospedagem de imagens, mas não deve ser difícil para você fazer um fork e criar sua própria implementação da interface ImageUploader .

Discussão

Se você tiver alguma dúvida/sugestão, considere usar as discussões do GitHub. Há também um tópico de plugin no fórum Obsidian.

Limitações conhecidas

• você não pode colar gifs animados da área de transferência (eles inicialmente são copiados como imagens estáticas para a área de transferência). Use arrastar e soltar se quiser fazer upload de um gif animado.
• existem limites diários para usar a API Imgur associada a um ID de cliente específico.

Problemas conhecidos

• Às vezes, o Imgur pode rejeitar sua solicitação de upload de uma imagem sem motivo óbvio. O erro normalmente relatado neste caso é uma solicitação CORS com falha, que não permite que a Obsidian prossiga com o upload da imagem. Se você enfrentar esse problema, nenhuma ação será necessária de sua parte: apenas espere e ele desaparecerá em breve. Sempre que o plug-in falhar ao carregar uma imagem remotamente, ele retornará ao método padrão de armazenamento local de uma imagem.

Contribuição

Contribuições são bem-vindas. Confira o DEVELOPMENT.md para começar com o código.

Seu apoio

Se este plugin for útil para você, você pode mostrar seu ❤️ dando uma estrela ️ no GitHub. Você também pode me comprar um café usando Ko-fi:

Notas de rodapé

1. Você só precisará configurar o ID do cliente nas configurações do plugin Imgur, o segredo não é necessário. ↩