From e44535be81d75c4c97d3acec2dc751c7a468ddae Mon Sep 17 00:00:00 2001
From: rosiel ReferencesAugust 13, 2024
+ August 14, 2024
diff --git a/pr-preview/pr-2343/concepts/collection/index.html b/pr-preview/pr-2343/concepts/collection/index.html
index ebb234c99..a4085f084 100644
--- a/pr-preview/pr-2343/concepts/collection/index.html
+++ b/pr-preview/pr-2343/concepts/collection/index.html
@@ -565,7 +565,7 @@
Permissions on a CollectionAugust 13, 2024
+ August 14, 2024
diff --git a/pr-preview/pr-2343/concepts/derivatives/index.html b/pr-preview/pr-2343/concepts/derivatives/index.html
index 1d036686d..fbf703a23 100644
--- a/pr-preview/pr-2343/concepts/derivatives/index.html
+++ b/pr-preview/pr-2343/concepts/derivatives/index.html
@@ -579,7 +579,7 @@
Derivative Swimlane DiagramAugust 13, 2024
+ August 14, 2024
diff --git a/pr-preview/pr-2343/concepts/node-concepts/index.html b/pr-preview/pr-2343/concepts/node-concepts/index.html
index 8af3db099..e9a3a70e8 100644
--- a/pr-preview/pr-2343/concepts/node-concepts/index.html
+++ b/pr-preview/pr-2343/concepts/node-concepts/index.html
@@ -558,7 +558,7 @@
Nodes are attached to MediaAugust 13, 2024
+ August 14, 2024
diff --git a/pr-preview/pr-2343/concepts/node-media/index.html b/pr-preview/pr-2343/concepts/node-media/index.html
index ded042d17..ad51f69a0 100644
--- a/pr-preview/pr-2343/concepts/node-media/index.html
+++ b/pr-preview/pr-2343/concepts/node-media/index.html
@@ -558,7 +558,7 @@
Media have different usesStandard vs Multi-file media model
This describes the standard file-media relationship in Islandora. There is an alternative method of arranging files and their derivatives -which we call the "Multi-file media" method.
+which we call the "Multi-file media" method.To experience the full Islandora Starter Site, it requires access to external services such as Solr,
Fedora, Alpaca, and Matomo. It is therefore suggested to deploy the Starter Site using one of our
-two deployment platforms: ISLE-DC (using the make starter
or make starter_dev
commands), or
-the Islandora Playbook (using the starter
(default) or starter_dev
option in the Vagrantfile).
make starter
or make starter_dev
commands), ISLE Site Template, or
+the Islandora Playbook (using the starter
(default) or starter_dev
option in the Vagrantfile).
In order to generate that custom Drupal image we need to set up a development environment. You will do this +
In order to generate that custom Drupal image we need to set up a development environment. You will do this on your development computer, rather than your production server.
Once your development site is set up you will need somewhere to store your custom Drupal image. You should create a private repository in your container registry of choice (Dockerhub, GitHub, GitLab, etc.)
@@ -2886,7 +2886,7 @@If you don't already have a Drupal site, you'll be given a basic setup using Drupal 9 and the +
If you don't already have a Drupal site, you'll be given a basic setup using Drupal 10 and the Islandora Starter Site.
If you do already have a Drupal site, use git to clone it into place as the codebase
folder.
cd /path/to/isle-dc
@@ -2666,7 +2666,7 @@ Getting Startedmake starter
to install the Drupal site in your codebase
folder and spin up all the other containers with it.
Enjoy your Islandora instance! Check out the basic usage documentation to see +
Enjoy your Islandora instance! Check out the basic usage documentation to see
all the endpoints that are available and how to do things like start and stop Islandora. Your passwords,
including the Drupal admin password, can be found in the secrets/live
directory after you run make starter
.
Drupal updates are performed through composer on your development site. Once the modules have been added/removed/updated, your composer.json
and composer.lock
files can be checked into your git repository and you can rebuild your production Drupal container with the new files.
Composer commands need to run in your Drupal container. For example:
+Composer commands need to run in your Drupal container. For example:
docker compose exec drupal-dev composer update -W
Or
docker compose exec drupal-dev composer require 'drupal/islandora:^2.11'
Needs Maintenance
-The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
+The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
After all of the above pieces are in place, installed, configured, started, and otherwise prepared, the last thing we need to do is to finally configure the front-end Drupal instance to wire all the installed components together.
settings.php
Islandora¶Skip this by using the Islandora Starter Site
-The Islandora Starter Site, which was presented as an option in the "Installing Composer, Drush, and Drupal" step, +
The Islandora Starter Site, which was presented as an option in the "Installing Composer, Drush, and Drupal" step, installs Islandora and other modules and configures them, allowing you to skip this section. You may want to use this manual method in the case where you want to pick and choose which Islandora modules you use.
Needs Maintenance
-The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
+The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
The Drupal installation process can be done through the GUI in a series of form steps, or can be done quickly using Drush's site-install
command. It can be invoked with the full list of parameters (such as --db-url
and --site-name
), but if parameters are missing, they will be asked of you interactively.
The Drupal installation process can be done through the GUI in a series of form steps, or can be done quickly using Drush's site-install
command. It can be invoked with the full list of parameters (such as --db-url
and --site-name
), but if parameters are missing, they will be asked of you interactively.
Follow the instructions in the README of the Islandora Starter Site. The steps are not reproduced here to remove redundancy. But specifically,
@@ -2919,7 +2919,7 @@Needs Maintenance
-The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
+The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
Needs Maintenance
-The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
+The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
Needs Maintenance
-The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
+The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
Needs Maintenance
-The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
+The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
Notice
@@ -2829,7 +2829,7 @@Needs Maintenance
-The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
+The manual installation documentation is in need of attention. We are aware that some components no longer work as documented here. If you are interested in helping us improve the documentation, please see Contributing.
Alternately, you can use Docker and install the Online Sandbox repository locally, with minimal command-line usage. Note that this method does not support installing modules or themes that are not included with the demo. See the instructions for "Running Locally" in the Sandbox's README.
To provision a local Vagrant or remote Ubuntu virtual machine (without Docker), you can use the Islandora Ansible Playbook. The playbook results in all services installed on a single machine, but can be altered to spread services across various machines. This is a full-fledged VM where you can install modules and themes using Composer. This method requires basic command-line usage and it's advantageous if you are familiar with provisioning software on Ubuntu. This Playbook is suitable for local or production use, though local use (through VirtualBox and Vagrant) is not supported yet by Apple hardware (i.e. M1/M2 machines). See documentation: Installation - Ansible Playbook for more details.
+To provision a local Vagrant or remote Ubuntu virtual machine (without Docker), you can use the Islandora Ansible Playbook. The playbook results in all services installed on a single machine, but can be altered to spread services across various machines. This is a full-fledged VM where you can install modules and themes using Composer. This method requires basic command-line usage and it's advantageous if you are familiar with provisioning software on Ubuntu. This Playbook is suitable for local or production use, though local use (through VirtualBox and Vagrant) is not supported yet by Apple hardware (i.e. M1/M2 machines). See documentation: Installation - Ansible Playbook for more details.
ISLE Site Template uses Docker and is based off images created by ISLE Buildkit, but is a simpler tool than ISLE-DC. This is a full-fledged Docker installation where you can install modules and themes using Composer, either by executing commands in the container or by using the built-in IDE. It is suitable for local development or production. See documentation: Installation - Site Template for more details.
+ISLE Site Template uses Docker and is based off images created by ISLE Buildkit, but is a simpler tool than ISLE-DC. This is a full-fledged Docker installation where you can install modules and themes using Composer, either by executing commands in the container or by using the built-in IDE. It is suitable for local development or production. See documentation: Installation - Site Template for more details.
ISLE-DC uses Docker and provisions each service in the Islandora stack in a separate container. The containers are also based off of the images in ISLE Buildkit. ISLE-DC uses the GNU Make tool to provide several shortcuts to performing common management functions. It is suitable for local development or production. See documentation: Installation - Docker ISLE for more details.
+ISLE-DC uses Docker and provisions each service in the Islandora stack in a separate container. The containers are also based off of the images in ISLE Buildkit. ISLE-DC uses the GNU Make tool to provide several shortcuts to performing common management functions. It is suitable for local development or production. See documentation: Installation - Docker ISLE for more details.
http://pcdm.org/use#OriginalFile
)
http://purl.org/coar/resource_type/c_18cc
)The mimetype formats allowed by Homarus are configured in Homarus itself - see Installing Crayfish
+The mimetype formats allowed by Homarus are configured in Homarus itself - see Installing Crayfish
Drupal provides a "Video" field formatter for file fields that displays a simple playable video widget. It works but does not support captions/subtitles. Islandora provides a "Video with Captions" formatter that allows for captions.
To use the Captions feature out of the box, add the captions track as a WEBVTT file (.vtt
) in the Video media's "Track" field (see below regarding which Video media to use). If you don't have the "Track" field (provided by Islandora Starter Site), create a field of type "Media Track" (a type provided by Islandora) on the same Media (or more broadly, same entity) as your audio file. Then use the Manage Display page to set your audio file field to render using the "Audio with captions" field formatter.