Пример. Управление цитатами в документе Word с помощью надстройки Word

Управление цитатами является важным аспектом документов, особенно в научных кругах и образовании. Каждый стиль ссылки имеет свои собственные рекомендации по маркировке ссылок в документе, а также где и как следует отмечать источники. К таким стилям относятся APA и MLA.

В этой статье представлен пример надстройки, которая управляет цитатами в Word документе. Надстройка отображает ссылки, загруженные из BIB-файла, который пользователь выбирает для цитирования в своем документе.

Область задач надстройки управления цитатами.

Предварительные требования

  • Visual Studio Code.
  • Пакет Office, подключенный к подписке Microsoft 365 (включая Office в Интернете).
  • Node.js версии 16 или более поздней.
  • npm версии 8 или более поздней.

Выполнение примера кода

Пример кода для этой статьи называется Управление цитатами в Word документе. Чтобы запустить пример, следуйте инструкциям в файле сведений.

Основные шаги в примере

  1. Пользователь выбирает локальный BIB-файл, содержащий ссылки, которые он хотел бы процитировать.
  2. Надстройка считывает BIB-файл, а затем отображает ссылки на список литературы в области задач. В примере используется @orcid/bibtexParseJs для анализа BIB-файла.
  3. Пользователь выбирает соответствующую ссылку, а затем вставляет ее в расположение курсора (или в конце выделенного текста) в документе.
  4. Надстройка добавляет ссылочный знак в этом расположении в документе и добавляет ссылку в концевую сноску. Все концевые сноски автоматически отображаются в конце документа.

Сделайте его своим

Ниже приведено несколько рекомендаций по адаптации этого примера к своему сценарию.

Управление пользовательскими настройками

Включите единый вход (SSO) в надстройке Office для поддержки сохранения данных и параметров пользователей в нескольких документах. Если ваша служба предоставляет или размещает библиотеку литературы, авторизованный пользователь может получить доступ к этой литературе в своем документе и выбрать ее из нее.

Вы также можете сохранить состояние и параметры надстройки в текущем документе пользователя.

Предостережение

Не храните конфиденциальную информацию, например маркеры проверки подлинности или строки подключения. Свойства документа не шифруются и не защищены.

Использование сносок

Вывод списка ссылок в сносках в конце страницы вместо концевых сносок в соответствии со стилем ссылки.

Кроме того, можно разрешить пользователю выбрать место, в котором будут отображаться ссылки. Если это так, вы можете обновить надстройку, чтобы сохранить предпочтения пользователя с помощью свойства документа или в рамках проверки подлинности.

Обновление стиля ссылки

Обновите стиль ссылки, используемый для отображения ссылок в концевых сносках (или сносках).

Кроме того, укажите различные параметры стиля, а затем разрешите пользователю выбирать. Если это так, вы можете обновить надстройку, чтобы сохранить предпочтения пользователя с помощью свойства документа или в рамках проверки подлинности.

Замена bibtexParseJs

Замените средство синтаксического анализа BIB-файлов @orcid/bibtexParseJs собственным или другим доступным анализатором, особенно если этот параметр не предоставляет необходимые функции для решения.

См. также