notero
v0.6.7
Notero é um plugin do Zotero para sincronizar itens e notas no Notion. Para usá-lo:
Conceito de @arhoff ??? | Construído com? por @dvanoni
O plugin Notero observa itens do Zotero sendo adicionados ou modificados em qualquer coleção que você especificar nas preferências do Notero. Sempre que um item é adicionado ou modificado, Notero faz algumas coisas:
notion ao item Zotero.Além de fornecer uma maneira conveniente de abrir uma página do Notion do Zotero, o anexo do link também serve como referência para o Notero para que ele possa atualizar a página do Notion correspondente para um determinado item do Zotero.
Por padrão, o Notero sincronizará itens em suas coleções monitoradas sempre que forem modificados. Você pode desativar essa funcionalidade desmarcando a opção Sincronizar quando os itens forem modificados nas preferências do Notero.
Você também pode sincronizar itens da coleção ou dos menus de contexto do item (clique com o botão direito):
Observação
Para evitar que a funcionalidade "sincronizar ao modificar" seja salva no Notion várias vezes, o Notero não notifica o Zotero quando a tag e o anexo do link são adicionados a um item. Isso significa que eles podem não aparecer no Zotero imediatamente e você pode precisar navegar até um item diferente e voltar para fazê-los aparecer.
As notas do Zotero associadas a um item podem ser sincronizadas no Notion como conteúdo da página correspondente para esse item. Tal como acontece com os itens normais, você pode sincronizar notas manualmente usando a opção Sincronizar com o Notion no menu de contexto.
A sincronização automática de notas pode ser habilitada através da opção Sincronizar notas nas preferências do Notero. Quando ativado, as notas serão sincronizadas automaticamente sempre que forem modificadas. Além disso, quando um item normal é sincronizado, todas as suas notas também serão sincronizadas, caso ainda não o tenham feito.
Para sincronizar anotações (notas e destaques) de um PDF, primeiro você precisa extraí-las para uma nota Zotero:
Usar o Notero requer a configuração de um banco de dados Notion, conectá-lo ao Notero e instalar o plugin Notero no Zotero. Instruções detalhadas de configuração estão abaixo.
Crie o banco de dados Notion no qual você gostaria de sincronizar os itens do Zotero.
Veja exemplos abaixo que você pode duplicar em seu espaço de trabalho do Notion.
Crie uma integração interna do Notion em https://www.notion.com/my-integrations e habilite todos os "recursos de conteúdo".
Anote o "segredo de integração interna" da etapa anterior.
Dê à sua integração acesso ao seu banco de dados.
Dos documentos do desenvolvedor do Notion:
- Acesse a página do banco de dados em sua área de trabalho.
- Clique no menu ••• Mais no canto superior direito da página.
- Role para baixo e clique em Conectar a .
- Procure e selecione sua integração no menu Procurar conexões....
Configure as propriedades do banco de dados conforme desejado. Consulte a seção de propriedades do banco de dados abaixo para obter mais detalhes.
Notero pode sincronizar dados para as propriedades listadas abaixo. A única propriedade exigida pelo Notero é aquela com o tipo de propriedade Title . As demais propriedades são opcionais, portanto você pode utilizar apenas aquelas que atendem às suas necessidades.
A propriedade Title pode ter um nome diferente de Name desde que não entre em conflito com nenhum dos outros nomes de propriedade. O nome e o tipo das demais propriedades devem ser configurados exatamente conforme especificado aqui. Observe que os nomes das propriedades diferenciam maiúsculas de minúsculas, portanto, as letras maiúsculas devem corresponder exatamente.
O suporte para customização de propriedades está planejado para o futuro; veja a edição nº 355.
| Nome da propriedade | Tipo de propriedade | Notas |
|---|---|---|
Name | Título | Formato configurável por meio da opção Notion Page Title nas preferências do Notero |
Abstract | Texto | |
Authors | Texto | |
Citation Key | Texto | Requer melhor BibTeX |
Collections | Seleção múltipla | |
Date | Texto | |
Date Added | Data | |
Date Modified | Data | |
DOI | URL | |
Editors | Texto | |
Extra | Texto | |
File Path | Texto | |
Full Citation | Texto | Formato baseado na configuração do Zotero para Exportar → Cópia Rápida → Formato do Item |
In-Text Citation | Texto | Formato baseado na configuração do Zotero para Exportar → Cópia Rápida → Formato do Item |
Item Type | Selecione | |
Place | Texto | |
Proceedings Title | Texto | |
Publication | Texto | |
Series Title | Texto | |
Short Title | Texto | |
Tags | Seleção múltipla | |
Title | Texto | |
URL | URL | |
Year | Número | |
Zotero URI | URL | Abre itens na biblioteca da web se estiver conectado ao Zotero |
Importante
.xpi ..xpi na seção Ativos da página de lançamento mais recente..xpi :Para obter mais guias visuais de configuração e uso do Notero, consulte os seguintes recursos feitos por membros maravilhosos da comunidade:
Se você gostaria de compartilhar como usa o Notero e deseja ser listado aqui, sinta-se à vontade para enviar um PR ou entre em contato comigo!
Embora isso fosse bom, infelizmente está além do escopo deste plugin. Obter atualizações do Notion para o Zotero exigiria a configuração de um serviço hospedado que assinasse webhooks do Notion e então usasse a API do Zotero para atualizar itens no Zotero. O Notion ainda não lançou suporte oficial para webhook, mas existem algumas ferramentas de terceiros que podem ser usadas para isso. Em teoria, isto é tecnicamente possível, mas seria um projeto separado.
Atualmente não há uma boa maneira de sincronizar arquivos ou vincular arquivos locais devido às seguintes limitações do Notion:
http: e https: :, portanto, não é possível vincular diretamente ao arquivo usando um file: URL.Por enquanto, as melhores soluções alternativas são:
File Path para apontar para o local do arquivo local.Zotero URI e depois abrir o arquivo a partir daí.Para sincronizar vários itens que já estão em uma coleção monitorada, você pode fazer isso nos menus de contexto da coleção ou do item. Consulte a seção Sincronizando Itens acima.
Se você receber o seguinte erro:
APIResponseError: Não foi possível encontrar o banco de dados com ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Isso provavelmente significa que você não concedeu ao Notero acesso ao seu banco de dados do Notion. Certifique-se de seguir todas as etapas da seção Configurar noção. Clicar no botão ••• no canto superior direito do seu banco de dados deve mostrar uma conexão para a integração que você criou para o Notero.
Se você receber o seguinte erro:
APIResponseError: não é possível atualizar uma página arquivada. Você deve desarquivar a página antes de atualizar.
Isso pode acontecer quando o Notero tenta sincronizar um item que já tinha uma página do Notion criada para ele em uma sincronização anterior, mas essa página já foi excluída. (Observe que a exclusão de uma página do Notion a move para a lixeira, e a API do Notion se refere a isso como "arquivada".)
Conforme descrito na seção Como funciona o Notero, o Notero associa itens do Zotero às páginas do Notion por meio de um link chamado Notion anexado ao item. Para resolver o problema, exclua este anexo de link nos itens incorretos e execute a sincronização novamente.
Se você receber o seguinte erro:
APIResponseError: propriedade não é uma propriedade que existe
Isso pode acontecer se você sincronizou itens anteriormente em um banco de dados do Notion e depois alterou suas preferências do Notero para especificar um banco de dados diferente. Notero pode estar tentando atualizar páginas no banco de dados antigo em vez de criar páginas no novo banco de dados, e esse erro pode ocorrer se propriedades diferentes tiverem sido configuradas em bancos de dados diferentes.
Para resolver isso, você deve excluir o banco de dados antigo no Notion e, em seguida, excluí-lo permanentemente da Lixeira no Notion.
Fornecemos alguns exemplos de bancos de dados Notion que foram configurados com todas as propriedades sincronizadas pelo Notero.
Depois de abrir um dos exemplos, clique no botão Duplicar no canto superior direito da página para duplicá-lo em seu espaço de trabalho do Notion.
Um banco de dados vazio que contém apenas as propriedades sincronizadas pelo Notero. Útil se você quiser começar do zero e personalizá-lo você mesmo.
Um banco de dados com múltiplas visualizações e algumas entradas de amostra. Veja abaixo as descrições de como você pode usar as diferentes visualizações.
DOI ou URL .Extra do Zotero.Zotero URI para visualizar/editar a entrada no Zotero ou para exportar a entrada bibliográfica em um estilo de citação diferente. Related References (por exemplo, artigos na mesma edição especial, capítulos de livros no mesmo livro editado, estudos e comentários que respondam ou ampliem outras obras). Notero foi desenvolvido com gerador-zotero-plugin e usa scripts de construção fortemente inspirados no zotero-plugin. Muito obrigado a @retorquere por criá-los.
As etapas abaixo são baseadas na documentação de desenvolvimento do plug-in Zotero e devem permitir que você crie e execute o Notero sozinho.
Para evitar qualquer dano potencial ao seu perfil Zotero padrão, você pode criar um novo perfil para fins de desenvolvimento.
Crie um arquivo chamado zotero.config.json que conterá as opções de configuração usadas para iniciar o Zotero. Consulte zotero.config.example.json para obter um arquivo de exemplo que contém descrições de todas as opções de configuração disponíveis.
Instale dependências:
npm ci
Crie o Notero e inicie o Zotero com o plugin instalado:
npm start
Alternativamente, você pode iniciar a versão beta desejada do Zotero:
npm run start-beta
O script start executa uma série de etapas:
Execute npm run build para construir o plugin no diretório build .
Se definido, execute o comando scripts.prestart especificado em zotero.config.json .
Escreva um arquivo contendo o caminho absoluto para o diretório build no diretório de extensions no diretório de perfil do Zotero.
Remova as linhas extensions.lastAppBuildId e extensions.lastAppVersion de prefs.js no diretório de perfil do Zotero.
Inicie o Zotero com o perfil especificado em zotero.config.json e os seguintes argumentos de linha de comando:
-purgecaches -ZoteroDebugText -jsdebugger -datadir profile
Se definido, execute o comando scripts.poststart especificado em zotero.config.json , fornecendo-lhe uma variável de ambiente ZOTERO_PID .
Os lançamentos são realizados por meio do GitHub Actions. O fluxo de trabalho release define os seguintes trabalhos:
release-please Este trabalho usa a ação release-please para criar PRs de lançamento quando novos commits voltados para o usuário são enviados para o branch main . Um PR de lançamento irá alterar a versão do pacote e atualizar o changelog. Quando o PR é mesclado, esse trabalho cria uma nova tag de versão e uma versão do GitHub.
publish-artifacts Este trabalho é executado quando uma nova versão é criada pelo trabalho release-please . Ele cria o arquivo .xpi e o publica na versão. Ele também gera um arquivo de manifesto atualizado e o publica na versão release .
