## 簡介

[Manifold](https://manifoldapp.org/) 是一個開源 Web 應用程式，能夠允許使用者釋出基於 Web 的書籍以及其他基於文字的媒體，以便使用者自由閱讀並能為這些文字新增註釋。Manifold 可以用於開放式訪問（OA）材料和開放式教育資源（OER），可以整合到教室、編寫訓練營、研討會、圖書館或其他您新網透過協作閱讀交流知識的場景。

Manifold 由 Mellon 基金會贊助，最初是以是以學術專著為基礎製作，但可以作為多種出版物（期刊、小冊子、收藏品）的收集、組織、閱讀和註釋平臺。需要了解 Manifold 書籍的事例，您可以檢視 Manifold 版本的免費電子書 [*How to Code in Python 3*](https://cuny.manifoldapp.org/projects/how-to-code-in-python-3) 。

在本教程中，我們將在伺服器上配置 Manifold 並向安裝應用中新增一個文字。

## 準備

開始之前，應該具備以下條件：
1. Ubuntu 16.04 伺服器，至少有 1 個 CPU，最好是 8 GB RAM（最小6 GB），這裡採用 4 核 8G 配置的[滴滴雲](https://blog.didiyun.com) DC2 主機。
2. 具有 sudo 許可權的非 root 使用者。

**注意：**
> 出於安全性和穩定性的原因，Manifold 的開發人員建議不要嘗試在共享託管環境中安裝 Manifold。Manifold 由許多不同的服務組成，每個服務都需要 RAM 才能正常執行。在記憶體小於 6GB 的小型 VM 上，您可能需要啟用交換記憶體或冒著消耗所有可用記憶體的風險。

如果您當前未使用域名進行設定，則可以手動在`/etc/manifold/manifold.rb` 中設定主機名並重新配置應用程式。重新配置將在下面討論。

有了這些先決條件，您就可以開始學習本教程了。

### 第1步 - 下載並安裝 Manifold Package
我們將為 Ubuntu 16.04 下載 Manifold。

首先，進入臨時目錄下載軟體包，因為軟體包我們以後是可以刪除的。
```
cd /tmp
```

接下來，使用 curl 帶有 -O 標誌的命令將輸出寫入本地檔案。這會將軟體包下載到我們的伺服器。
```
curl -O https://storage.googleapis.com/manifold-dist/ubuntu16/manifold_2.1.1-1_amd64.deb
```

### 第2步 - 安裝該軟體包
```
sudo dpkg -i manifold_2.1.1-1_amd64.deb
```
執行此命令時，您應該收到包含以下行的輸出：
```
Output
...
Manifold Scholarship

manifold: Thank you for installing Manifold!
...
```
收到這些資訊後，您可以繼續下一步操作。

### 第3步 - 配置 Manifold
如果您已在此伺服器上設定了完全限定的域名，則可能不需要進行更多配置。如果收到與您域名匹配的以下輸出，則會出現這種情況：
```
Output
...
manifold: Manifold should be reachable at http://your-manifold-url
...
```
但是，如果您現在使用伺服器的 IP 地址，或者上面的輸出與您的 URL 不匹配，則可以將 Manifold 配置為指向正確的位置。

建立了一個檔案 `/etc/manifold/manifold.rb`，您將使用該檔案配置和管理包含 Manifold 的各種服務。

在首選文字編輯器中開啟此檔案（我們將使用 nano）。
```
sudo vim /etc/manifold/manifold.rb
```
在此檔案中，查詢檔案 `external_url` 頂部附近的設定。將其設定為伺服器的 IP 地址或 Manifold 安裝的域名。

```
...
## 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'
```

現在，在 vim 的準備模式中輸入 `:wq` 儲存並退出該檔案。

此時，您需要使用以下命令重新配置 Manifold。
```
sudo /usr/bin/manifold-ctl reconfigure
```

Manifold 應用程式現在將實現此檔案中所做的更改，重新生成新設定和配置檔案。一旦收到類似於以下內容的輸出，表明此過程已完成：
```
Output
Chef Client finished, 262/347 resources updated in 51 seconds
manifold Reconfigured!
```
您現在可以訪問伺服器的 URL 或 IP 地址，並能夠看到一個空的 Manifold 主頁。

![](https://assets.digitalocean.com/articles/manifold/manifold_home_page.png)

若需使用 Manifold 應用程式，您可以繼續執行下一步。

### 第4步 - 訪問後端

儲存在 Manifold 中的所有內容（包括文字，專案，作者，資源和使用者）都需要使用 Manifold 的後端 Web 介面進行管理。

要訪問後端，您需要在伺服器上建立管理使用者。透過 `manifold-api` 可執行檔案呼叫命令來建立此管理使用者。

要使用此命令，您需要輸入自己的詳細資訊，包括您的郵件地址、密碼、您的名字和姓氏，格式如下：
```
sudo manifold-api manifold:user:create:admin["your_email@domain.com","password","first_name","lastName"]
```
在上面的命令中替換您自己的資訊，如下例所示：

```
sudo manifold-api manifold:user:create:admin["duwendi@gmail.com","Password1oo!","duke","wendi"]
```

執行該命令後，您將收到類似於以下內容的輸出：
```
Output
INFO: A User has been created. Its ID is 4a38dbb4-212b-4387-ad32-5e014459cd11
```
建立此使用者後，返回瀏覽器並單擊 Manifold 右上角的頭像圖示進行登入。

![](https://assets.digitalocean.com/articles/manifold/manifold_login.png)

輸入使用者名稱密碼成功登入後，您將在標題中看到一個 `ENTER ADMIN MODE` 按鈕。單擊此按鈕即可訪問 Manifold 的後端。

![](https://assets.digitalocean.com/articles/manifold/enter_admin_mode.png)

### 第5步 - 建立專案
進入後端之後，如果要建立一個新的專案，點選 `Project` 頂部選單欄上，然後在新增新專案按鈕。

![](https://assets.digitalocean.com/articles/manifold/projects_list.png)

系統將提示您輸入標題和可選的字幕和說明。出於演示目的，您可以上傳免費電子書 `How to Code in Python 3`，此處專案命名相同。

輸入該資訊後，您可以儲存專案後繼續。

建立新專案時，它會自動儲存為草稿模式。作為草稿的專案僅對登入的管理使用者可見。使用專案詳細資訊檢視左側的選項卡，您可以新增縮圖，為面向公眾的專案頁面上傳英雄影像或橫幅，如以及新增後設資料和其他資源。

由於 Manifold 為您提供了文字儲存庫，因此可能要做的第一件事就是新增文字，將文字檔案提取到專案中，單擊 `TEXT` 選項卡。

![](https://assets.digitalocean.com/articles/manifold/manifold_texts.png)

可以將 EPUB，Markdown 和 HTML 檔案或 Google 文件上傳到 Manifold。如果您要使用 Google 文件，則需要執行一些其他配置。出於演示目的，我們將把 `Python 3 EPUB` 中的 `How To Code` 上傳到我們的 Manifold 安裝中。您可以使用以下連結直接連結到 eBook 的 EPUB：<https:>

要引入文字，請單擊 `ADD A NEW TEXT` 按鈕開始引入。

![](https://assets.digitalocean.com/articles/manifold/add_text.png)

在演示中，我們將使用上面的連結，但您也可以將檔案上傳或拖動到雲圖示上，從本地硬碟上傳檔案。暫存檔案後，可以點選 `Continue`。該應用程式將連結到 Manifold websocket，您現在可以單擊 `Ingest` 開始上傳過程。

根據託管環境和您上傳的檔案大小，Manifold 可能需要幾分鐘才能獲取文字。您可以看到一個日誌，顯示攝取的狀態輸出。完成此過程後，可以在對話方塊底部看到 `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)

按下此按鈕後，文字將在 Manifold 閱讀器中開啟。

![](https://assets.digitalocean.com/articles/manifold/manifold_reader.png)

如果對專案感到滿意，可以從管理介面的  `Genera` 選項卡中切換可見性關閉“草稿模式”。

![](https://assets.digitalocean.com/articles/manifold/visibility.png)

現在，該專案就可以在您的主頁上找到了。

![](https://assets.digitalocean.com/articles/manifold/final_with_project.png)

此時，您可以繼續處理專案以新增後設資料，影像等。

但是請注意，如果您的域名與您的 Manifold 頁面相關聯，並且希望使用者提供檔案，最佳做法是保護您的網站並透過 HTTPS 協議訪問它。

## 最後
恭喜您完成了 Manifold 安裝並建立了您的第一個專案！您現在應該已經在 Ubuntu 16.04 伺服器上安裝了 Manifold。如果一切按計劃進行，那麼您就可以構建自己的專案並在 Manifold 上釋出自己的文字了。

要了解更多有關 Manifold 的專案開發以及使用它的更多資訊，請檢視以下連結：

[Manifold 的 GitHub 儲存庫](https://github.com/ManifoldScholar)

閱讀 [Building Manifold Development Blog](http://blog.manifoldapp.org/)

加入 [Manifold Community Slack 頻道](https://manifold-slackin.herokuapp.com/)

訪問 [Manifold 網站](https://manifoldapp.org/docs/README)獲取官方文件</https:>

在滴滴雲 DC2 上部署 Manifold 文字收集與閱讀平臺

相關文章