Пример. Управление цитатами в документе Word с помощью надстройки Word
Управление цитатами является важным аспектом документов, особенно в научных кругах и образовании. Каждый стиль ссылки имеет свои собственные рекомендации по маркировке ссылок в документе, а также где и как следует отмечать источники. К таким стилям относятся APA и MLA.
В этой статье представлен пример надстройки, которая управляет цитатами в Word документе. Надстройка отображает ссылки, загруженные из BIB-файла, который пользователь выбирает для цитирования в своем документе.
Предварительные требования
- Visual Studio Code.
- Пакет Office, подключенный к подписке Microsoft 365 (включая Office в Интернете).
- Node.js версии 16 или более поздней.
- npm версии 8 или более поздней.
Выполнение примера кода
Пример кода для этой статьи называется Управление цитатами в Word документе. Чтобы запустить пример, следуйте инструкциям в файле сведений.
Основные шаги в примере
- Пользователь выбирает локальный BIB-файл, содержащий ссылки, которые он хотел бы процитировать.
- Надстройка считывает BIB-файл, а затем отображает ссылки на список литературы в области задач. В примере используется @orcid/bibtexParseJs для анализа BIB-файла.
- Пользователь выбирает соответствующую ссылку, а затем вставляет ее в расположение курсора (или в конце выделенного текста) в документе.
- Надстройка добавляет ссылочный знак в этом расположении в документе и добавляет ссылку в концевую сноску. Все концевые сноски автоматически отображаются в конце документа.
Сделайте его своим
Ниже приведено несколько рекомендаций по адаптации этого примера к своему сценарию.
Управление пользовательскими настройками
Включите единый вход (SSO) в надстройке Office для поддержки сохранения данных и параметров пользователей в нескольких документах. Если ваша служба предоставляет или размещает библиотеку литературы, авторизованный пользователь может получить доступ к этой литературе в своем документе и выбрать ее из нее.
Вы также можете сохранить состояние и параметры надстройки в текущем документе пользователя.
Предостережение
Не храните конфиденциальную информацию, например маркеры проверки подлинности или строки подключения. Свойства документа не шифруются и не защищены.
Использование сносок
Вывод списка ссылок в сносках в конце страницы вместо концевых сносок в соответствии со стилем ссылки.
Кроме того, можно разрешить пользователю выбрать место, в котором будут отображаться ссылки. Если это так, вы можете обновить надстройку, чтобы сохранить предпочтения пользователя с помощью свойства документа или в рамках проверки подлинности.
Обновление стиля ссылки
Обновите стиль ссылки, используемый для отображения ссылок в концевых сносках (или сносках).
Кроме того, укажите различные параметры стиля, а затем разрешите пользователю выбирать. Если это так, вы можете обновить надстройку, чтобы сохранить предпочтения пользователя с помощью свойства документа или в рамках проверки подлинности.
Замена bibtexParseJs
Замените средство синтаксического анализа BIB-файлов @orcid/bibtexParseJs собственным или другим доступным анализатором, особенно если этот параметр не предоставляет необходимые функции для решения.
См. также
Office Add-ins