Exemplo: gerenciar citações em um documento Word usando seu suplemento Word
O gerenciamento de citações é um aspecto importante dos documentos, particularmente na academia e na educação. Cada estilo de citação tem suas próprias diretrizes para como as citações devem ser marcadas em um documento, bem como onde e como as fontes devem ser anotadas. Esses estilos incluem APA e MLA.
Este artigo apresenta um suplemento de exemplo que gerencia citações em um documento Word. O suplemento exibe as referências carregadas de um arquivo .bib que o usuário seleciona para citar em seu documento.
Pré-requisitos
- Visual Studio Code.
- Office conectado a uma assinatura Microsoft 365 (incluindo o Office na web).
- Node.js versão 16 ou superior.
- npm versão 8 ou maior.
Executar o código de exemplo
O código de exemplo deste artigo é chamado Gerenciar citações em um documento Word. Para executar o exemplo, siga as instruções no readme.
Principais etapas no exemplo
- O usuário escolhe um arquivo .bib local que contém as referências que gostaria de citar.
- O suplemento lê o arquivo .bib e exibe as referências de bibliografia no painel de tarefas. O exemplo usa @orcid/bibtexParseJs para analisar o arquivo .bib.
- O usuário escolhe a referência apropriada e insere-a no local do cursor (ou no final do texto selecionado) no documento.
- O suplemento adiciona uma marca de referência nesse local no documento e adiciona a referência a uma nota de extremidade. Todas as notas de extremidade são listadas automaticamente no final do documento.
Torná-lo seu
A seguir estão algumas sugestões de como você pode adaptar esse exemplo ao seu cenário.
Gerenciar configurações de usuários
Habilite o SSO (logon único) em um Suplemento do Office para dar suporte a dados e configurações de usuário persistentes em vários documentos. Se o serviço fornecer ou hospedar a biblioteca de bibliografia, um usuário autorizado poderá acessar e selecionar nessa bibliografia no documento.
Você também pode persistir o estado de suplemento e as configurações no documento atual do usuário.
Cuidado
Não armazene informações confidenciais, como tokens de autenticação ou cadeias de conexão. As propriedades no documento não são criptografadas ou protegidas.
Usar notas de rodapé
Liste as referências em notas de rodapé no final da página em vez de notas de extremidade, de acordo com o estilo de citação.
Como alternativa, permita que o usuário escolha onde deseja que as referências sejam exibidas. Nesse caso, você pode atualizar o suplemento para persistir a preferência do usuário usando uma propriedade de documento ou como parte de sua experiência autenticada.
Atualizar estilo de citação
Atualize o estilo de citação usado para exibir as referências nas notas de extremidade (ou notas de rodapé).
Como alternativa, forneça várias opções de estilo e, em seguida, permita que o usuário escolha. Nesse caso, você pode atualizar o suplemento para persistir a preferência do usuário usando uma propriedade de documento ou como parte de sua experiência autenticada.
Substituir bibtexParseJs
Substitua o analisador de arquivos .bib @orcid/bibtexParseJs por seu próprio ou outro analisador disponível, especialmente se essa opção não fornecer a funcionalidade necessária para sua solução.