Как установить и настроить коллектор Scholar

Manifold - это веб-приложение с открытым исходным кодом, которое позволяет публиковать веб-издания книг и других текстовых носителей, чтобы пользователи могли свободно читать и комментировать эти тексты. Манифольд, специально предназначенный для использования с материалами открытого доступа (ОА) и открытыми образовательными ресурсами (ООР), может быть встроен в учебные классы, кодовые учебные лагеря, семинары, библиотеки и другие места, где вы можете обмениваться знаниями посредством совместного чтения.

При поддержке Фонда Меллона «Манифольд» изначально создавался с учетом научной монографии, но многие формы публикаций (журналы, брошюры, сборники) можно собирать, организовывать, читать и комментировать на платформе. Чтобы увидеть пример книги по Manifold, вы можете взглянуть на версию бесплатной электронной книги для Manifold: http://cuny.manifoldapp.org/projects/how-to-code-in-python-3 [Как кодировать в Python 3] _.

В этом руководстве мы настроим Manifold на сервере и добавим текст к вашей установке.

Для того, чтобы начать, вы должны иметь следующее:

Чтобы Manifold работал на веб-сайте с URL-адресом, необходимо настроить полное доменное имя. Для получения инструкций по настройке, вы должны прочитать документацию от вашего хостинг-провайдера. Если вы используете DigitalOcean, вы можете найти руководство в нашем учебном пособии по адресу https://www.digitalocean.com/community/tutorials/how-to-point-to-digitalocean-nameservers-from-common-domain-registrars[How To Укажите серверы имен DigitalOcean от обычных регистраторов доменов.

Если в данный момент вы не настроили свое доменное имя, вы можете установить имя хоста вручную в + / etc / manifold / manifold.rb + и перенастроить приложение. Реконфигурация обсуждается ниже.

Имея эти предварительные условия, вы можете начать обучение.

Мы будем загружать Manifold для Ubuntu 18.04.

Сначала перейдите во временный каталог, чтобы загрузить пакет, так как этот пакет можно удалить позже.

Затем используйте команду + curl + с флагом + -O +, чтобы записать вывод в локальный файл. Это позволит загрузить пакет на наш сервер.

Далее мы установим пакет.

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

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

Если вы выполнили первоначальную настройку сервера, на вашем сервере должен быть установлен брандмауэр + ufw +. Если у вас нет брандмауэра, вы должны внедрить брандмауэр, следуя https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-18-04#step-4 -% E2% 80% 94-setting-a-basic-firewall [Настройка базового шага брандмауэра] в руководстве по первоначальной настройке сервера.

Чтобы разрешить трафик через + http + в сети, вы должны открыть порт 80.

Вы должны получить вывод, что это правило было добавлено. Вы можете проверить состояние своего брандмауэра, набрав + sudo ufw status, чтобы увидеть текущие правила на вашем сервере.

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

Однако, если вы сейчас используете IP-адрес сервера или если вышеприведенный вывод не соответствует вашему URL, вы можете настроить Manifold так, чтобы он указывал на правильное место.

Файл был создан в + / etc / manifold / manifold.rb +, который вы будете использовать для настройки и управления различными сервисами, входящими в состав Manifold.

Откройте этот файл в предпочитаемом вами текстовом редакторе (мы будем использовать nano).

В этом файле найдите параметр + external_url + в верхней части файла. Установите это либо на IP-адрес вашего сервера, либо на доменное имя вашей установки Manifold.

и т.д. / коллектор / manifold.rb

Если ваш сайт + example.com +, ваша строка будет выглядеть так:

Если ваш IP + 192.0.2.0 +, ваша строка будет выглядеть так:

Теперь сохраните и выйдите из файла. Сделайте это, нажав + CTRL + + + X +, затем + y +, чтобы подтвердить, что вы хотите сохранить его, затем + ENTER +.

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

Приложение Manifold теперь будет реализовывать изменения, внесенные в этот файл, для регенерации новых настроек и файлов конфигурации. Этот процесс будет завершен, как только вы получите вывод, подобный следующему:

Теперь вы можете посетить либо URL, либо IP-адрес вашего сервера. Вы должны увидеть пустую домашнюю страницу коллектора.

изображение: https: //assets.digitalocean.com/articles/manifold/manifold_home_page.png [Домашняя страница коллектора]

С обслуживанием приложения Manifold вы можете перейти к следующему шагу.

Все содержимое, хранящееся в Manifold (включая тексты, проекты, авторов, ресурсы и пользователей), управляется через внутренний веб-интерфейс Manifold через путь + + backend +.

Чтобы получить доступ к бэкэнду, вам нужно будет сделать административного пользователя на вашем сервере. Вы будете вызывать команду для создания этого администратора через исполняемый файл + manifold-api.

Чтобы использовать эту команду, вам нужно будет ввести свои данные, в том числе адрес электронной почты, пароль, имя и фамилию, в следующем формате:

Подставьте свою собственную информацию в команду выше, как в следующем примере:

После запуска команды вы получите вывод, подобный следующему:

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

изображение: https: //assets.digitalocean.com/articles/manifold/manifold_login.png [Вход в систему коллектора]

После того, как вы введете свои учетные данные и войдите в систему, вы увидите кнопку * ENTER ADMIN MODE * в заголовке.

изображение: https: //assets.digitalocean.com/articles/manifold/enter_admin_mode.png [Режим администрирования коллектора]

Нажмите эту кнопку, чтобы получить доступ к бэкэнду Manifold.

Из бэкэнда вы попадете туда, где будут жить ваши будущие проекты.

изображение: https: //assets.digitalocean.com/articles/manifold/projects_list.png [Список проектов коллекторов]

Чтобы создать новый проект, нажмите * Projects * в верхней строке меню, а затем кнопку * Add a New Project *. Вам будет предложено ввести название и необязательные субтитры и описание. В демонстрационных целях вы можете загрузить бесплатную электронную книгу _https: //www.do.co/python-book [How To Code in Python 3] _, чтобы в качестве заголовка можно было ввести + How To Code in Python 3 + ,

После ввода этой информации вы можете сохранить проект и нажать * Продолжить *.

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

Поскольку Manifold предоставляет вам хранилище для текстов, первое, что вы, вероятно, захотите сделать, это добавить текст. Чтобы вставить текстовый файл в свой проект, нажмите на вкладку * тексты *.

изображение: https: //assets.digitalocean.com/articles/manifold/manifold_texts.png [Тексты проекта коллектора]

Вы можете загружать файлы EPUB, Markdown и HTML, а также Документы Google в Manifold. Если вы собираетесь работать с Документами Google, вам необходимо выполнить some дополнительную настройку. В демонстрационных целях мы будем загружать How To Code в Python 3 EPUB в нашу установку Manifold. Вы можете связаться с EPUB электронной книги напрямую, используя эту ссылку:

Чтобы ввести текст, нажмите кнопку * Добавить новый текст *, чтобы начать процесс приема пищи.

изображение: https: //assets.digitalocean.com/articles/manifold/add_text.png [Добавить текст]

В нашей демонстрации мы будем использовать приведенную выше ссылку, но вы также можете загрузить или перетащить файл на значок облака, чтобы загрузить файл с локального жесткого диска. Когда вы поставили файл, вы можете нажать * Продолжить *. Приложение подключится к веб-сокету Manifold, и теперь вы можете нажать * Ingest *, чтобы начать процесс загрузки.

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

изображение: https: //assets.digitalocean.com/articles/manifold/ingestion_complete.png [Проглатывание завершено]

После нажатия кнопки * Complete * вы вернетесь в свой проект.

Вы увидите, что ваш текст добавлен в * UNCATEGORIZED *. Используйте стрелку вверх, чтобы переместить файл в состояние * PUBLISHED *.

изображение: https: //assets.digitalocean.com/articles/manifold/uncategorized_text.png [текст без категории]

изображение: https: //assets.digitalocean.com/articles/manifold/published_text.png [Опубликованный текст]

Нажмите на ссылку * PREVIEW * под заголовком проекта рядом со значком глаза, чтобы просмотреть текущий проект. На предпросмотре вы должны увидеть кнопку * START READING * под заголовком.

изображение: https: //assets.digitalocean.com/articles/manifold/start_reading.png [Кнопка начала чтения]

После того, как вы нажмете эту кнопку, текст должен открыться в считывающем устройстве.

изображение: https: //assets.digitalocean.com/articles/manifold/manifold_reader.png [Предварительный просмотр коллектора]

Когда вы довольны своим проектом, на вкладке * Общие * административного интерфейса вы можете переключить видимость, чтобы отключить * Черновой режим *.

изображение: https: //assets.digitalocean.com/articles/manifold/visibility.png [Переключение видимости]

Теперь проект должен быть доступен на вашей главной странице.

изображение: https: //assets.digitalocean.com/articles/manifold/final_with_project.png [Финальный коллектор с опубликованным проектом]

На этом этапе вы можете продолжить работу над проектом, чтобы добавить метаданные, изображения и многое другое.

Обратите внимание, что если у вас есть домен, связанный с вашей страницей Manifold, и вы ожидаете, что пользователи будут добавлять файлы, рекомендуется защитить ваш веб-сайт и получить к нему доступ по протоколу HTTPS. Чтобы узнать, как защитить коллектор с помощью бесплатного центра сертификации Let’s Encrypt, прочитайте наш учебник «https://www.digitalocean.com/community/tutorials/an-introduction-to-let-s-encrypt[An Введение в Let’s Encrypt» »

Поздравляем, вы завершили установку Manifold и создали свой первый проект! Теперь у вас должен быть установлен Manifold на вашем сервере Ubuntu 18.04. Если все прошло по плану, вы уже на пути к созданию собственных проектов и публикации собственных текстов в Manifold.

Чтобы узнать больше о проекте Manifold, его разработке и университетских прессах, использующих его, перейдите по следующим ссылкам:

Если у вас возникнут какие-либо проблемы при использовании этого программного обеспечения, команда Manifold приветствует обратную связь; вы можете связаться с ними, обратившись к getiting раздел поддержки их docs.