Интерактивные веб -библиографии с Zotero
Пример установки
Лабораторный веб -сайт в Penn State
Личный сайт
Документация
http://zot-bib-web.readthedocs.io/
Автор/Контакт:
David [email protected] http://www.david-reitter.com
Функции
Этот инструмент генерирует интерактивные веб -библиографии на основе одной или нескольких коллекций в репозитории Zotero. Коллекции могут поддерживаться группами людей, используя веб -интерфейс Zotero или их настольные приложения.
Библиографии могут быть заказаны по сбору, в год публикации или типом публикации (например, журнальные статьи сначала), могут быть связаны с доступными для поиска, могут быть связаны с документами PDF или другими URL -адресами, имеют записи для Bibtex, Endnette и Wikipedia и могут быть экспортированы в HTML или подтолкнут к DataBase WordPress.
ZOT_BIB_WEB не зависит от любого стороннего веб-сервера. Сгенерированные библиографии загружаются быстро, потому что они хранятся как статические файлы вместе с остальной частью вашего сайта. Это является хорошим источником для веб -кров, включая Google Scholar и Citeseer.
Настройка проста для тех, кто запускает свой собственный веб -сайт и знает, как использовать командную строку (Shell). Самый простой способ его использовать - это позвонить Zot.py с ключом публичной коллекции Zotero. Это сделает файл Zotero-bib.html. Скопируйте это вместе с каталогом «Сайт» и «Файлы» (если есть) в свой веб -сервер.
Демо
Посмотреть файлы HTML в демонстрационной папке для некоторых примеров библиографий. Их соответствующие файлы настройки и файлы стиля CSS включены.
Бегать:
./zot.py -settings demo/settings3.py
Чтобы увидеть это в действии.
Лицензия и пожертвования
- Используйте и измените это программное обеспечение бесплатно.
- Гарантия не предоставляется вообще.
- Пожалуйста, напишите [email protected] Ссылка на библиографию на вашем веб-сайте, если вы решите использовать ZOT_BIB_WEB.
- Вы можете использовать это программное обеспечение бесплатно.
Требования
Python 2,7 или 3,6+
Pyzotero. Для установки Pyzotero, библиотеки для Python:
Sudo Pip установить Pyzotero
или:
sudo easy_install pyzotero
Коллекция Zotero с вашей библиографией (как пользователь или как группа)
Необязательно: пакет DateUtils для Python (улучшает анализ даты, если присутствует)
Настраивать
Убедитесь, что Zot.py выполняется (CHMOD UG+x Zot.py)
Попробуйте это. Из командной строки, похожей на UNIX, сделайте это:
./zot.py -Group 160464 DTDTV2EP
Затем просмотрите Zotero-bib.html в браузере. Если это выглядит хорошо, перейдите к следующим шагам для конфигурации.
- В новом файле с именем stens.py добавьте конфигурацию, как задокументировано в файле sturts_example.py. Перейдите на Zotero.org, чтобы получить свой секретный ключ API и идентификаторы пользователя или библиотеки. Это легко: см. Верхку настройки. Example.py для получения подробной информации. Если настройки.
В качестве альтернативы вы можете использовать основные настройки в аргументах программе.
Библиография в Zotero
- С Zotero создайте библиографию и отметьте его идентификатор (например, из URL -адреса в веб -интерфейсе Zotero). Пример:
MGID90AT . Этот идентификатор - это то, что вам нужно для переменной "toplevelfilter" в sutres.py. - Вы можете добавить суббочки в свою библиографию.
- Если вы форматируете заказанными коллекциями, может быть полезно предоставить им заказ. Вы можете назвать коллекции, начиная с номера: «10 социальная психология».
Вот пример библиографической структуры:
Мои публикации [mgid90at]
10 выбранных работ
15 При подготовке / рассмотрении
20 рецензируемых работ по теме
Семантика
Диапазон
Диалог
Машинное обучение
30 тезисов
40 разговоров (без бумаги)
Чтобы увидеть это, используйте предоставленные настройки.py в качестве примера.
Обзор параметров конфигурации
- Конфигурация происходит в файле настроек по умолчанию с именем stens.py.
- Позвоните ./ZOT.PY ---SHELP, чтобы увидеть список параметров командной строки.
- Пожалуйста, обратитесь к документации для получения информации в файле «Настройки» или Read Future_Example.py. Несколько вариантов обсуждаются в следующем.
- Вы можете заказать нашу библиографию по субколлекции, по годам или типу публикации (например, в журнальных статьях, а затем документах о конференции). Даже в категориях более высокого уровня вы можете сортировать свои библиографические записи по своему усмотрению. Используйте настройки «sort_crieteria» и «show_top_section_headings».
- Вы можете выбрать другое соглашение о форматировании. По умолчанию формат APA.
- Вверху можно отобразить окно поиска и набор ярлыков: например, несколько лет или пролеты лет, типов публикации или подколлекций, которые указывают тематические области. Посетитель может нажать на них, чтобы быстро отфильтровать библиографию.
- Настройте ярлыки, показанные вверху, используя переменную show_shortcuts. «Коллекция», «Тип», «Год», «место», «venue_short» и «теги» являются поддерживаемыми значениями, в дополнение к более мелкозернистым спискам значений, которые вы можете создать, используя функцию ortcut (). Вы можете дать список значений или диапазонов (в течение многих лет), их порядок и некоторую фильтрацию, чтобы показать только наиболее распространенные. См. Stens.example.py для подробного примера.
- Есть еще несколько вариантов. Опять же, см. Настройки_EXAMEL.PY.
Развертывание на веб -сайте
- Загрузите папку сайта или ее содержимое в общедоступное место на вашем веб -сервере. По умолчанию /site /... это предполагаемый URL.
Чтобы сгенерировать HTML и включить его на веб -сайте:
- Запустите Zot.py One/по требованию или установите как задание или служба Cron на сервере, не запускайте его более раз в день. Настройте его непосредственно в Zot.py, или в отдельных настройках файлов.
- Включите полученный файл Zotero-bib.html (или как настроенный) на свой веб-сайт, как вы считаете нужным. Вы также можете включить отдельные файлы сбора, которые также генерируются. Вы можете настроить Zot.py для создания полного HTML -документа или просто его части. ZOT_BIB_WEB генерирует контент HTML5.
- Стиль своей библиографии с помощью CSS. Включен пример файла стиля (см. Сайт/ каталог).
Поддержка WordPress
Этот пакет может перейти прямо на сайт WordPress. Для этого включена отдельная программа «push.py».
Следуйте этим шагам:
- Установите Zot.py, чтобы создать библиографию, которая вам нравится. Вызовите Zot.py-offull, чтобы сгенерировать полный файл Zotero-bib.html для целей отладки. Настройте настройки stens.py, чтобы не генерировать полный HTML -код.
- Установите плагин WPAutop-Control (или аналогичный плагин), чтобы убедиться, что WP не будет вставлять разрывы абзаца в различных местах в библиографии. С помощью этого плагина вам нужно будет добавить «пользовательское поле» на страницу, созданную на следующем шаге (выберите «Параметры экрана» в верхней части представления страницы, включите пользовательские поля. Затем найдите пользовательские поля в самом нижней части страницы и добавьте поле «Wpautop» со значением «нет».
- Создайте страницу WP или пост для библиографии. Вставьте [ZOT_BIB_WEB Collection], где вы хотели бы вставить библиографию. Замените коллекцию на удостоверение личности коллекции. (Больше вариантов: см. Push.py)
- Скопируйте содержимое листа стилей (в сайте/) на вашу тему WordPress (выберите «Редактор» или «Дополнительный CSS»).
- Настройте настройки. Как правило, это будет jquery_path = "../wp-includes/js/jquery/jquery.js" bulfboard.js и clippy.svg: вы можете ссылаться на публичный URL или служить файлам самостоятельно.
- Настройте push.py (вверху). Вам нужно будет знать несколько простых подробностей о вашей установке WP.
- Запустить push.py регулярно или по требованию. Он автоматически вызовет Zot.py, а затем обновляет страницу в WP.