openlibrary
1.0.0
Открытая библиотека - это открытый, редактируемый каталог библиотеки, созданный в направлении веб -страницы для каждой публикуемой книги.
Вы хотите начать? Это руководство, которое вы ищете. Вы можете узнать больше о Google Summer of Code (GSOC)? или chacktoberfest.
Обзор
Установка
Кодовая организация
Архитектура
Фронт
Бэкэнд
Сервисная архитектура
Руководство разработчика
Заводящие тесты
Вклад
Публичные API
Часто задаваемые вопросы
Открытая библиотека - это усилия, начатая в 2006 году, чтобы создать «Одна веб -страница для каждой публикации, когда -либо опубликованной». Он обеспечивает доступ ко многим общественным достояниям и изданным книгам, которые можно прочитать в Интернете.
Вот быстрый общественный тур по открытой библиотеке, чтобы узнать вас с услугами и ее предложениями (10 минут).
Узнайте больше о проекте открытой библиотеки
Видение (мечта) открытой ролики
Посетите блог
Запустить docker compose up и посетить http: // localhost: 8080
Нужна более подробная информация? Оформить инструкции Docker или видеоурок.
В качестве альтернативы , если вы не хотите устанавливать открытую библиотеку на локальном компьютере, попробуйте Gitpod! Это позволяет вам работать над открытой библиотекой в вашем браузере, не устанавливая что -либо на свой персональный компьютер. Предупреждение: эта интеграция все еще экспериментальная.
Для получения инструкций по администрированию экземпляра открытой библиотеки см. В Руководстве по QuickStart разработчика.
Вы также можете найти больше информации о документации разработчика для открытой библиотеки в вики Open Bibrary.
OpenLibrary/Core - Функциональность открытой либрарии Core, импортируется и используется www
Openlibrary/Plugins - другие модели, контроллеры и просмотр помощников
OpenLibrary/Views - Просмотры для рендеринга веб -страниц
OpenLibrary/Шаблоны - все шаблоны, используемые на веб -сайте
OpenLibrary/Macros - макросы похожи на шаблоны, но могут быть вызваны из Wikitext
OpenLibrary разработана поверх системы Wiki Infogami, которая сама построена на вершине веб -структуры Python Python и базы данных Infobase.
Обзор бэкэнд -веб -технологий
После того, как вы прочитали обзор технологий бэкэнд Openlibrary, очень рекомендуется прочитать учебник по разработчике, который объясняет, как использовать Infogami (и ее база данных Infobase).
Учебное пособие по разработчику Infogami
Если вы хотите погрузиться в исходный код для Infogami, см. Repogami Repo.
Открытые библиотечные тесты можно запускать с помощью Docker. Пожалуйста, посмотрите на наш тестовый документ для получения более подробной информации.
docker compose run --rm home make test
Есть много способов, которыми волонтеры могут внести свой вклад в проект открытой библиотеки, от разработки и проектирования до управления данными и вовлечения сообщества. Вот как вы можете принять участие:
Начало работы: Ознакомьтесь с нашим руководством для получения инструкций о том, как настроить среду разработки, найти проблемы, над которыми нужно работать и отправить свои взносы.
Хорошие первые проблемы: просмотрите наши хорошие первые проблемы, чтобы найти удобные для начинающих задачи.
Вклад дизайна: мы приветствуем дизайнеров, чтобы помочь улучшить пользовательский опыт. Вы можете начать с рассмотрения проблем, связанных с дизайном.
Вклад данных: Узнайте, как внести свой вклад в наш каталог и помочь улучшить данные книг в открытой библиотеке. Посетите нашу страницу добровольцев для получения дополнительной информации.
Присоединяйтесь к нашему сообществу: открытые библиотеки проводит еженедельные сообщества и дизайнерские звонки. Проверьте график вызова сообщества, чтобы узнать время и детали.
Задайте вопросы: если у вас есть какие -либо вопросы, присоединяйтесь к нашему чату Gitter или запросите приглашение на наш канал Slack на нашей странице добровольцев.
Для получения более подробной информации обратитесь к Руководству.
Весь исходный код, опубликованный здесь, доступен в соответствии с условиями общей публичной лицензии GNU Affero, версия 3.
