前書き

Manifoldは、ユーザーがこれらのテキストを自由に読んだり注釈を付けたりできるように、書籍やその他のテキストベースのメディアのWebベースのエディションを公開できるオープンソースWebアプリケーションです。 特に、オープンアクセス(OA)教材およびオープン教育リソース(OER)での使用に適したManifoldは、教室、コーディングブートキャンプ、ワークショップ、図書館、および共同読書を通じて知識を交換したい他の会場に組み込むことができます。

メロン財団の資金援助を受けて、マニフォールドはもともと学術モノグラフを念頭に置いて作成されましたが、プラットフォーム上で多くの形式の出版物(ジャーナル、パンフレット、コレクション)を収集、整理、読み取り、注釈付けすることができます。 マニフォールドブックの例を見るには、無料の電子ブック_https://cuny.manifoldapp.org/projects/how-to-code-in-python-3のマニフォールドバージョンをご覧ください。 Python 3] _。

このチュートリアルでは、サーバーにマニフォールドを設定し、インストールにテキストを追加します。

前提条件

開始するには、次のものが必要です。

URLを使用してWebサイトでManifoldを実行するには、完全修飾ドメイン名を設定する必要があります。 これを設定するためのガイダンスについては、ホスティングプロバイダーのドキュメントをお読みください。 DigitalOceanを使用している場合は、https://www.digitalocean.com/community/tutorials/how-to-point-to-digitalocean-nameservers-from-common-domain-registrarsのチュートリアルでガイダンスを見つけることができます。 Common Domain RegistrarsからDigitalOcean Nameserversを指します。

現時点でドメイン名を設定していない場合、ホスト名を `+ / etc / manifold / manifold.rb +`で手動で設定し、アプリケーションを再設定できます。 再構成については、以下で説明します。

これらの前提条件が整ったら、チュートリアルを開始できます。

手順1-マニホールドパッケージのダウンロードとインストール

Ubuntu 18.04用のManifoldをダウンロードします。

パッケージは後で削除できるため、まず一時ディレクトリに移動してパッケージをダウンロードします。

cd /tmp

次に、 `+ curl `コマンドと ` -O +`フラグを使用して、出力をローカルファイルに書き込みます。 これにより、パッケージがサーバーにダウンロードされます。

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

このコマンドを実行すると、次の行を含む出力が表示されます。

Output...
Manifold Scholarship


manifold: Thank you for installing Manifold!
...

これらの行を受け取ったら、次の手順に進むことができます。

ステップ2-ファイアウォールの更新

サーバーの初期設定に従った場合は、サーバー上に「+ ufw +」ファイアウォールを配置する必要があります。 ファイアウォールを設置していない場合は、https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-18-04#step-4に従ってファイアウォールを実装する必要があります。 -サーバーの初期セットアップガイドの%E2%80%94-setting-up-a-basic-firewall [基本的なファイアウォールのセットアップ]ステップ。

Web上の「+ http +」を介したトラフィックを許可するには、ポート80を開く必要があります。

sudo ufw allow 80

このルールが追加されたという出力を受け取るはずです。 「+ sudo ufw status」と入力してファイアウォールのステータスを確認し、サーバーの現在のルールを確認できます。

ステップ3-マニホールドの構成

このサーバーに完全修飾ドメイン名が既に設定されている場合は、追加の構成を行う必要はありません。 これは、ドメイン名に一致する次の出力を受け取った場合に当てはまります。

Output...
manifold: Manifold should be reachable at http://
...

ただし、現在サーバーのIPアドレスを使用している場合、または上記の出力がURLと一致しない場合は、正しい場所を指すようにマニホールドを構成できます。

ファイルは `+ / etc / manifold / manifold.rb +`で作成され、Manifoldを構成するさまざまなサービスの設定と管理に使用します。

任意のテキストエディターでこのファイルを開きます(nanoを使用します)。

sudo nano /etc/manifold/manifold.rb

このファイル内で、ファイルの上部近くにある `+ external_url +`設定を探します。 これをサーバーのIPアドレスまたはインストールされているManifoldのドメイン名に設定します。

etc / manifold / manifold.rb

...

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

Webサイトが `+ example.com +`の場合、行は次のようになります。

external_url 'http://example.com'

IPが「192.0.2.0」の場合、行は次のようになります。

external_url 'http://192.0.2.0'

次に、ファイルを保存して終了します。 これを行うには、「+ CTRL 」「+ X 」、次に「 y 」を押して保存することを確認し、「 ENTER +」を押します。

この時点で、次のコマンドを使用してマニホールドを再構成できます。

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

これで、Manifoldアプリはこのファイルに加えられた変更を実装して、新しい設定ファイルと構成ファイルを再生成します。 次のような出力を受け取ったら、このプロセスは完了します。

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

これで、サーバーのURLまたはIPアドレスにアクセスできます。 空のManifoldホームページが表示されます。

image:https://assets.digitalocean.com/articles/manifold/manifold_home_page.png [マニホールドホームページ]

Manifoldアプリが提供されると、次のステップに進むことができます。

ステップ4-バックエンドにアクセスする

Manifoldに保存されているすべてのコンテンツ(テキスト、プロジェクト、作成者、リソース、ユーザーを含む)は、 `+ / backend +`パスを介してManifoldのバックエンドウェブインターフェースを通じて管理されます。

バックエンドにアクセスするには、サーバーで管理ユーザーを作成する必要があります。 `+ manifold-api`実行可能ファイルを介してこの管理ユーザーを作成するコマンドを呼び出します。

このコマンドを使用するには、メールアドレス、パスワード、名、姓などの詳細を次の形式で入力する必要があります。

sudo manifold-api manifold:user:create:admin["","","",""]

次の例のように、上記のコマンドで独自の情報を置き換えます。

sudo manifold-api manifold:user:create:admin["","","",""]

コマンドを実行すると、次のような出力が表示されます。

OutputINFO: A User has been created. Its ID is

このユーザーを作成したら、ブラウザに戻り、Manifoldの右上隅にあるアバターアイコンをクリックしてログインします。

image:https://assets.digitalocean.com/articles/manifold/manifold_login.png [マニホールドログイン]

資格情報を入力し、ログインに成功すると、ヘッダーに* ENTER ADMIN MODE *ボタンが表示されます。

image:https://assets.digitalocean.com/articles/manifold/enter_admin_mode.png [マニホールド管理モード]

このボタンをクリックして、マニホールドのバックエンドにアクセスします。

ステップ5-プロジェクトを作成する

バックエンドから、将来のプロジェクトが存在する場所に移動します。

image:https://assets.digitalocean.com/articles/manifold/projects_list.png [マニホールドプロジェクトリスト]

新しいプロジェクトを作成するには、トップメニューバーの[プロジェクト]をクリックし、[新しいプロジェクトの追加]ボタンをクリックします。 タイトルと、オプションのサブタイトルと説明を入力するように求められます。 デモンストレーションの目的で、無料の_https://www.do.co/python-book [Python 3のコーディング方法] _ eBookをアップロードして、タイトルとして「+ Python 3のコーディング方法」を入力できます。 。

その情報を入力したら、プロジェクトを保存して* Continue *を押します。

新しいプロジェクトを作成すると、_draft_モードで自動的に保存されます。 下書きであるプロジェクトは、ログインしている管理ユーザーのみに表示されます。 プロジェクトの詳細ビューの左側にあるタブを使用して、サムネイルを追加したり、公開されているプロジェクトページのヒーロー画像またはバナーをアップロードしたり、メタデータや追加リソースを追加したりできます。

Manifoldにはテキストのリポジトリが用意されているため、最初に行うのはテキストを追加することです。 テキストファイルをプロジェクトに取り込むには、* texts *タブをクリックします。

image:https://assets.digitalocean.com/articles/manifold/manifold_texts.png [Manifold Project Texts]

EPUB、Markdown、HTMLファイル、またはGoogleドキュメントをManifoldにアップロードできます。 Googleドキュメントを使用する場合は、https://manifoldapp.org/docs/customizing/settings/external_services/google/index.html [追加の設定]を実行する必要があります。 デモンストレーションのために、Python 3のHow Toコード EPUBをManifoldインストールにアップロードします。 次のリンクを使用して、電子書籍のEPUBに直接リンクできます。

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

テキストを取り込むには、[新しいテキストを追加]ボタンをクリックして、取り込みプロセスを開始します。

image:https://assets.digitalocean.com/articles/manifold/add_text.png [テキストの追加]

デモでは、上記のリンクを使用しますが、ファイルをクラウドアイコンにアップロードまたはドラッグして、ローカルハードドライブからファイルをアップロードすることもできます。 ファイルをステージングしたら、* Continue を押すことができます。 アプリはManifold WebSocketに接続し、 Ingest *をクリックしてアップロードプロセスを開始できます。

ホスティング環境とアップロードするファイルのサイズによっては、Manifoldがテキストを取り込むのに数分かかる場合があります。 取り込みのステータス出力を示すログが表示されます。 このプロセスが完了すると、ダイアログボックスの下部に[完了]ボタンが表示されます。

image:https://assets.digitalocean.com/articles/manifold/ingestion_complete.png [取り込み完了]

[完了]ボタンを押すと、プロジェクトに戻ります。

  • UNCATEGORIZED の下にテキストが追加されます。 上矢印を使用して、ファイルを PUBLISHED *状態に移動します。

image:https://assets.digitalocean.com/articles/manifold/uncategorized_text.png [未分類テキスト]

画像:https://assets.digitalocean.com/articles/manifold/published_text.png [公開テキスト]

現在のプロジェクトを表示するには、目のアイコンの隣のプロジェクトタイトルの下にある* PREVIEW リンクをクリックします。 プレビュー側では、タイトルの下に READING *ボタンが表示されます。

image:https://assets.digitalocean.com/articles/manifold/start_reading.png [読み取り開始ボタン]

このボタンを押すと、テキストがマニフォールドリーダーで開きます。

image:https://assets.digitalocean.com/articles/manifold/manifold_reader.png [マニホールドリーダープレビュー]

プロジェクトに満足したら、管理インターフェイスの[全般]タブから、表示モードを切り替えて[ドラフトモード]をオフにできます。

image:https://assets.digitalocean.com/articles/manifold/visibility.png [可視性トグル]

これで、プロジェクトがメインページで利用可能になります。

image:https://assets.digitalocean.com/articles/manifold/final_with_project.png [公開されたプロジェクトの最終マニホールド]

この時点で、プロジェクトの作業を続けて、メタデータ、画像などを追加できます。

Manifoldページに関連付けられたドメインがあり、ユーザーがファイルを提供することを期待している場合、Webサイトを保護し、HTTPSプロトコル経由でアクセスすることがベストプラクティスであることに注意してください。 無料の認証局Let’s Encryptを使用してManifoldを保護する方法については、チュートリアル「https://www.digitalocean.com/community/tutorials/an-introduction-to-let-s-encrypt[Let’s Encryptの概要]」を参照してください。 」

結論

おめでとうございます、Manifoldのインストールが完了し、最初のプロジェクトが作成されました! Ubuntu 18.04サーバーにManifoldがインストールされているはずです。 すべてが計画どおりに進んだ場合は、独自のプロジェクトを作成し、Manifoldで独自のテキストを公開する準備ができています。

Manifoldプロジェクト、その開発、およびそれを使用する大学の出版物の詳細については、次のリンクをご覧ください。

このソフトウェアの使用中に問題が発生した場合、マニフォールドチームはフィードバックを歓迎します。彼らのhttps://manifoldapp.org/docs/index[docs]のhttps://manifoldapp.org/docs/index.html#getting_support[getting support section]を参照して連絡を取ることができます。