如何安装和设置流形学者

Manifold是一个开源Web应用程序,允许您发布基于Web的书籍和其他基于文本的媒体版本,以便用户可以自由阅读和注释这些文本。特别适用于开放式(OA)材料和开放式...

介绍

Manifold是一个开源Web应用程序,允许您发布基于Web的书籍和其他基于文本的媒体版本,以便用户可以自由阅读和注释这些文本。 Manifold特别适用于开放式访问(OA)材料和开放式教育资源(OER),可以整合到教室,编写训练营,研讨会,图书馆和其他您可能希望通过协作阅读交流知识的场所。

由梅隆基金会资助,Manifold最初是​​以学术专着为基础制作的,但可以在平台上收集,组织,阅读和注释许多形式的出版物(期刊,小册子,收藏品)。 要查看Manifold书籍的示例,您可以查看Python 3中免费电子书如何编码的Manifold版本。

在本教程中,我们将在服务器上设置Manifold并向您的安装添加文本。

先决条件

要开始使用,您应该具备以下条件:

要使Manifold在具有URL的网站上运行,您必须设置完全限定的域名。 有关设置此指南的指导,您应该阅读托管服务提供商提供的文档。 如果您使用的是DigitalOcean,可以在我们的教程中找到有关如何从Common Domain Registrars指向DigitalOceanNameservers的指导。

注意 :出于安全性和稳定性的原因,Manifold的开发人员建议不要尝试在共享托管环境中安装Manifold。 Manifold由许多不同的服务组成,每个服务都需要RAM才能正常运行。 在内存小于6GB的小型VM上,您可能需要启用交换内存或冒着消耗所有可用内存的风险。

如果您当前未设置域名,则可以在/etc/manifold/manifold.rb手动设置主机名并重新配置应用程序。 重新配置将在下面讨论。

有了这些先决条件,您就可以开始学习本教程了。

第1步 - 下载并安装Manifold Package

我们将为Ubuntu 18.04下载Manifold。

首先,进入临时目录下载软件包,因为软件包是我们以后可以删除的。

cd /tmp

接下来,使用带-O标志的curl命令将输出写入本地文件。 这会将包下载到我们的服务器。

curl -O https://storage.googleapis.com/manifold-dist/ubuntu18/manifold_2.0.0~rc.1-1_amd64.deb

接下来,我们将安装该软件包。

sudo dpkg -i manifold_2.0.0~rc.1-1_amd64.deb

运行此命令时,您应该收到包含以下行的输出:

...
Manifold Scholarship


manifold: Thank you for installing Manifold!
...

收到这些行后,您可以继续下一步。

第2步 - 更新防火墙

如果您按照初始服务器设置进行操作,则应在服务器上安装ufw防火墙。 如果您没有防火墙,则应按照初始服务器设置指南的“ 设置基本防火墙”步骤实施防火墙。

为了允许通过Web上的http进行流量,您应该打开端口80。

sudo ufw allow 80

您应该收到已添加此规则的输出。 您可以通过键入sudo ufw status来检查防火墙状态,以查看服务器上的当前规则。

第3步 - 配置流形

如果您已在此服务器上设置了完全限定的域名,则可能不需要进行更多配置。 如果您收到与您的域名匹配的以下输出,则会出现这种情况:

...
manifold: Manifold should be reachable at http://your-manifold-url
...

但是,如果您现在使用服务器的IP地址,或者上面的输出与您的URL不匹配,则可以将Manifold配置为指向正确的位置。

/etc/manifold/manifold.rb中创建了一个文件,您将使用该文件配置和管理包含Manifold的各种服务。

在首选文本编辑器中打开此文件(我们将使用nano)。

sudo nano /etc/manifold/manifold.rb

在此文件中,查找文件顶部附近的external_url设置。 将其设置为服务器的IP地址或Manifold安装的域名。

等/歧管/ manifold.rb

...

## Manifold URL
##! URL on which Manifold will be reachable.
##! For more details on configuring external_url see:
external_url 'http://your-IP-or-your-URL'

如果您的网站是example.com ,您的行将如下所示:

external_url 'http://example.com'

如果您的IP是192.0.2.0 ,您的行将如下所示:

external_url 'http://192.0.2.0'

现在,保存并退出该文件。 CTRL + X ,然后按y确认要保存它,然后按ENTER

此时,您可以使用以下命令重新配置Manifold。

sudo /usr/local/bin/manifold-ctl reconfigure

Manifold应用程序现在将实现此文件中所做的更改,以重新生成新设置和配置文件。 一旦收到类似于以下内容的输出,此过程将完成:

Chef Client finished, 262/347 resources updated in 51 seconds
manifold Reconfigured!

您现在可以访问服务器的URL或IP地址。 你应该看到一个空的Manifold主页。

歧管主页

使用Manifold应用程序后,您可以继续执行下一步。

第4步 - 访问后端

存储在Manifold中的所有内容(包括文本,项目,作者,资源和用户)都通过Manifold的后端Web界面通过/backend路径进行管理。

要访问后端,您需要在服务器上创建管理用户。 您将通过manifold-api可执行文件调用命令来创建此管理用户。

要使用此命令,您需要输入自己的详细信息,包括您的电子邮件地址,密码,您的名字和姓氏,格式如下:

sudo manifold-api manifold:user:create:admin["your_email@domain.com","password","first_name","lastName"]

在上面的命令中替换您自己的信息,如下例所示:

sudo manifold-api manifold:user:create:admin["virginia@woolf.com","l1ghth0us3","Virginia","Woolf"]

运行该命令后,您将收到类似于以下内容的输出:

INFO: A User has been created. Its ID is 4a38dbb4-212b-4387-ad32-5e014459cd11

创建此用户后,返回浏览器并单击Manifold右上角的头像图标进行登录。

流形登录

输入凭据并成功登录后,您将在标题中看到一个ENTER ADMIN MODE按钮。

流形管理模式

单击此按钮可访问Manifold的后端。

第5步 - 创建项目

从后端开始,您将被带到未来项目所在的位置。

流形项目清单

要创建新项目,请单击顶部菜单栏上的“项目”,然后单击“ 添加新项目”按钮。 系统将提示您输入标题和可选的字幕和说明。 出于演示目的,您可以在Python 3 eBook中上传免费的How To Code ,以便您可以How To Code in Python 3输入How To Code in Python 3作为标题。

输入该信息后,您可以保存项目并按继续

创建新项目时,它会自动保存为草稿模式。 作为草稿的项目仅对登录的管理用户可见。使用项目详细信息视图左侧的选项卡,您可以添加缩略图,为面向公众的项目页面上传英雄图像或横幅,如以及添加元数据和其他资源。

由于Manifold为您提供了文本存储库,因此您可能要做的第一件事就是添加文本。 要将文本文件提取到项目中,请单击“ 文本”选项卡。

流形项目文本

您可以将EPUB,Markdown和HTML文件或Google文档上传到Manifold。 如果您要使用Google文档,则需要执行一些其他配置 出于演示目的,我们将把Python 3 EPUB中的How To Code上传到我们的Manifold安装中。 您可以使用以下链接直接链接到eBook的EPUB:

https://assets.digitalocean.com/books/python/how-to-code-in-python.epub

要引入文本,请单击“ 添加新文本”按钮以开始提取过程。

添加文字

在我们的演示中,我们将使用上面的链接,但您也可以将文件上传或拖动到云图标上,以从本地硬盘上传文件。 您已暂存文件后,可以按继续 该应用程序将连接到Manifold websocket,您现在可以单击Ingest开始上传过程。

根据托管环境和您上传的文件大小,Manifold可能需要几分钟才能获取文本。 您应该看到一个日志,显示摄取的状态输出。 完成此过程后,您将在对话框底部看到“ 完成”按钮。

摄入完成

完成按钮后,您将返回到您的项目。

您将看到在UNCATEGORIZED下添加了您的文字。 使用向上箭头将文件移动到PUBLISHED状态。

未分类的文字

发表的文字

单击眼睛图标旁边项目标题下方的PREVIEW链接以查看当前项目。 在预览方面,您应该在标题下方看到START READING按钮。

开始阅读按钮

按下此按钮后,文本应在Manifold阅读器中打开。

流形读者预览

如果对项目感到满意,可以从管理界面的“ 常规”选项卡中切换可见性以关闭“ 草稿模式”

可见性切换

现在,该项目应该可以在您的主页上找到。

已发布项目的最终流形

此时,您可以继续处理项目以添加元数据,图像等。

请注意,如果您的域名与您的Manifold页面相关联,并且希望用户提供文件,最佳做法是保护您的网站并通过HTTPS协议访问它。 要了解使用免费证书颁发机构Let's Encrypt保护Manifold,请阅读我们的教程“ Let's Encrypt简介

结论

恭喜,您完成了Manifold安装并创建了您的第一个项目! 您现在应该在Ubuntu 18.04服务器上安装Manifold。 如果一切按计划进行,那么您就可以构建自己的项目并在Manifold上发布自己的文本了。

要了解有关Manifold项目,其开发以及大学使用它的更多信息,请查看以下链接:

如果您在使用此软件时遇到任何问题,Manifold团队欢迎您提供反馈; 您可以通过咨询其文档获取支持部分与他们联系。


分享按钮