介绍
Manifold是一个开源的Web应用程序,允许您发布基于Web的书籍和其他基于文本的媒体版本,以便用户可以自由阅读和注释这些文本。
由Mellon基金会资助,Manifold最初是以学术单书为主,但许多形式的出版(期刊,小册子,收藏)可以收集,组织,阅读和注释在平台上。
在本教程中,我们将在服务器上设置Manifold,并为您的安装添加文本。
前提条件
为了开始,你应该有以下几点:
- 具有至少 1 个 CPU 的 Ubuntu 18.04 服务器,最好是 8 GB 的 RAM(最少 6 GB)。
- 具有 sudo 特权的非根用户,您可以通过遵循 Ubuntu 18.04 初始服务器设置指南来实现。
为了让Manifold在一个URL的网站上运行,您必须设置一个完全合格的域名。 对于设置此项设置的指导,您应该阅读您的托管提供商的文档。 如果您正在使用DigitalOcean,您可以在我们的教程中找到指南 如何指向DigitalOcean名称服务器从常用域名注册器。
<$>[注意] 注意 : Manifold 的开发者建议不要试图在共享托管环境中安装 Manifold 出于安全性和稳定性原因。 Manifold 由一系列不同的服务组成,每个服务都需要 RAM 才能正常运作。
如果您目前尚未设置您的域名,您可以手动在 `/etc/manifold/manifold.rb 中设置主机名,并重新配置应用程序。
有了这些前提条件,你可以开始教程。
步骤 1 – 下载和安装 Manifold 包
我们将下载Ubuntu 18.04的Manifold。
首先,转到临时目录下载包,因为包是我们稍后可以删除的东西。
1cd /tmp
接下来,使用带有-O旗的curl命令将输出写入到本地文件中。
1curl -O https://storage.googleapis.com/manifold-dist/ubuntu18/manifold_2.0.0~rc.1-1_amd64.deb
接下来,我们将安装该包。
1sudo dpkg -i manifold_2.0.0~rc.1-1_amd64.deb
当您运行此命令时,您应该收到包括以下行的输出:
1[secondary_label Output]
2...
3Manifold Scholarship
4
5manifold: Thank you for installing Manifold!
6...
一旦你收到这些行,你可以继续到下一步。
第2步:更新防火墙
如果您遵循初始服务器设置,则应在您的服务器上设有ufw防火墙;如果您没有防火墙,则应按照初始服务器设置指南的 设置基本防火墙步骤执行防火墙。
为了允许通过http在网络上的流量,你应该打开端口80。
1sudo ufw allow 80
您可以通过键入sudo ufw status来检查您的防火墙的状态,以查看服务器上的当前规则。
步骤 3 – 配置 Manifold
如果您已经在这个服务器上设置了完全合格的域名,您可能不需要进行更多配置,如果您收到与您的域名匹配的以下输出,则此情况将是正确的:
1[secondary_label Output]
2...
3manifold: Manifold should be reachable at http://your-manifold-url
4...
但是,如果您目前正在使用服务器的IP地址,或者上面的输出不匹配您的URL,您可以配置Manifold以指向正确的位置。
在 `/etc/manifold/manifold.rb 创建了一个文件,您将使用它来配置和管理包含 Manifold 的各种服务。
在您喜爱的文本编辑器中打开此文件(我们将使用nano)。
1sudo nano /etc/manifold/manifold.rb
在此檔案中,尋找在檔案頂部附近的「external_url」設定. 將此設定設定為您的伺服器的 IP 地址或您的 Manifold 安裝的域名。
1[label etc/manifold/manifold.rb]
2
3...
4
5## Manifold URL
6##! URL on which Manifold will be reachable.
7##! For more details on configuring external_url see:
8external_url 'http://your-IP-or-your-URL'
如果您的网站是example.com,您的行将看起来像这样:
1external_url 'http://example.com'
如果你的IP是192.0.2.0,你的线条会看起来像这样:
1external_url 'http://192.0.2.0'
现在,保存并退出文件. 这样做是通过按CTRL +X,然后y来确认你想保存它,然后ENTER。
此时,您可以使用以下命令重新配置 Manifold。
1sudo /usr/local/bin/manifold-ctl reconfigure
Manifold 应用程序现在将实施该文件所做的更改,以恢复新的设置和配置文件,一旦您收到类似于以下的输出,此过程将完成:
1[secondary_label Output]
2Chef Client finished, 262/347 resources updated in 51 seconds
3manifold Reconfigured!
您现在可以访问您的服务器的URL或IP地址,您应该看到一个空的Manifold主页。
随着Manifold应用程序的服务,您可以继续到下一步。
步骤 4 – 访问后台
所有存储在 Manifold 中的内容(包括文本、项目、作者、资源和用户)都通过 Manifold 后端 Web 接口通过 /backend 路径进行管理。
为了访问后端,您需要在您的服务器上创建一个管理用户. 您将通过manifold-api执行程序调用命令创建此管理用户。
要使用此命令,您需要输入自己的详细信息,包括您的电子邮件地址、密码、姓名和姓名,以以下格式:
1sudo manifold-api manifold:user:create:admin["[email protected]","password","first_name","lastName"]
在上面的命令中取代自己的信息,如下示例中所示:
1sudo manifold-api manifold:user:create:admin["[email protected]","l1ghth0us3","Virginia","Woolf"]
一旦运行命令,您将收到类似于以下的输出:
1[secondary_label Output]
2INFO: A User has been created. Its ID is 4a38dbb4-212b-4387-ad32-5e014459cd11
一旦你创建了这个用户,回到你的浏览器,并点击在Manifold的右上角的 avatar图标登录。
输入您的身份证并成功登录后,您将在头部看到一个 ENTER ADMIN MODE 按钮。
点击此按钮访问Manifold的后端。
步骤5:创建一个项目
从后端,你将被带到你的未来项目将居住的地方。
要创建一个新项目,点击顶部菜单栏上的 项目 ,然后点击 添加新项目 按钮. 您将被要求输入一个标题和一个可选的子标题和描述。 为示范目的,您可以上传免费的 _How To Code in Python 3_电子书,因此您可以输入How To Code in Python 3作为标题。
随着这些信息的输入,您可以保存项目并按 继续 。
当您创建一个新项目时,它会自动存储在 draft 模式中. 是草案的项目仅可见于已登录的管理用户。 使用项目详情视图左侧的选项卡,您可以添加小图,上传一个英雄图像或面向公众的项目页面的标签,以及添加元数据和其他资源。
由于Manifold为您提供了文本存储库,您可能要做的第一件事是添加文本。
您可以上传EPUB、Markdown和HTML文件,或Google文档到Manifold. 如果您要使用Google文档,您将需要执行一些额外的配置(https://manifoldapp.org/docs/customizing/settings/external_services/google/index.html)。 为示范目的,我们将上传 How To Code in Python 3 EPUB到我们的Manifold安装中。您可以通过此链接直接链接到电子书的EPUB:
1https://assets.digitalocean.com/books/python/how-to-code-in-python.epub
要输入文本,请点击 ** 添加新文本 ** 按钮开始吞吐过程。
在我们的演示中,我们将使用上面的链接,但您可以替代地上传或拖上文件到云图标上传文件从本地硬盘上传。
根据托管环境和您上传的文件的大小,Manifold 可能需要几分钟才能输入文本. 您应该看到显示输入状态的日志。
一旦您按下完成按钮,您将返回您的项目。
您将看到您添加的文本在 UNCATEGORIZED . 使用向上箭头将文件移动到 PUBLISHED 状态。
点击项目标题下方的 PREVIEW 链接,以查看当前项目的眼睛图标。
一旦您按下此按钮,文本应该在 Manifold 阅读器中打开。
当您对项目满意时,您可以从管理界面的 ** 一般** 选项卡中切换可见性以关闭 ** 草案模式** 。
现在,该项目应该在您的主页上可用。
此时,您可以继续在项目上工作,添加元数据、图像等。
请注意,如果您有一个与您的 Manifold 页面相关的域名,并预计用户会贡献文件,那么通过 HTTPS 协议保护您的网站并访问它是最佳做法。
结论
恭喜您,您完成了Manifold的安装,并创建了您的第一个项目!您现在应该在Ubuntu 18.04服务器上安装Manifold。
要了解更多关于Manifold项目,其发展,以及大学的压力使用它,请查看以下链接:
- Manifold的GitHub存储库 (https://twitter.com/ManifoldScholar)
- 阅读 Building Manifold Development Blog
- 加入 Manifold Community Slack频道
- 访问 Manifold网站 获取官方文档
如果您在使用该软件时遇到任何问题,Manifold团队欢迎您的反馈;您可以通过咨询他们的 docs的 [获得支持]部分(https://manifoldapp.org/docs/index.html#getting_support)与他们联系。