Navigating Omeka S from Omeka on Vimeo.
diff --git a/docs/admin/settings.md b/docs/admin/settings.md index beae7641..11f777bf 100644 --- a/docs/admin/settings.md +++ b/docs/admin/settings.md @@ -29,7 +29,7 @@ Settings are divided into two sections: **General** and **Security** settings. **Default site**: This dropdown gives you control over where people land when they navigate to the base url of your install. You can either display a list of all sites in the install (default) or select a specific site from the dropdown, to which people will be redirected. -**Locale**: A dropdown that lets you select from a dropdown of [available languages](https://www.transifex.com/omeka/omeka-s/){target=_blank} for the Omeka S core to change the language in which your installation's admin side displays. +**Locale**: A dropdown that lets you select from a dropdown of [available languages](https://www.transifex.com/omeka/omeka-s/) for the Omeka S core to change the language in which your installation's admin side displays. **Enable version notifications**: Check this box to enable warning banners for new versions of Omeka S, themes, and modules. If it is unchecked, no user (at any role) will see update warnings, not even the Global Administrator. If it is checked, every applicable user can see them (i.e. Supervisor users who can see the Modules page, Site Managers who can see the Themes pages, and every user on the `/admin` homepage). @@ -39,7 +39,7 @@ Settings are divided into two sections: **General** and **Security** settings. **Suggested languages for values**: List of languages to facilitate filling of the values in the resource form. -**Media alt text property**: Select a field (for example, `dc:title` or `dc:description`) from the media description to use as alternative text if no alt text is explicitly set. [Alt text](https://webaim.org/techniques/alttext/){target=_blank} is used in lieu of images (including thumbnails on browsing and search results pages) when a user is employing a screen reader and is an important part of meeting accessibility expectations. +**Media alt text property**: Select a field (for example, `dc:title` or `dc:description`) from the media description to use as alternative text if no alt text is explicitly set. [Alt text](https://webaim.org/techniques/alttext/) is used in lieu of images (including thumbnails on browsing and search results pages) when a user is employing a screen reader and is an important part of meeting accessibility expectations. **Index full-text search**: Check this box to run an index of your installation's resources and sites as soon as you click "Save". You should only need to run this process if you are having issues with searching. @@ -47,7 +47,7 @@ Settings are divided into two sections: **General** and **Security** settings.  -- **Use HTMLPurifier** checkbox. If checked, the service [HTMLPurifier](http://htmlpurifier.org/){target=_blank} will clean up any user-entered HTML. +- **Use HTMLPurifier** checkbox. If checked, the service [HTMLPurifier](http://htmlpurifier.org/) will clean up any user-entered HTML. - **Disable file validation**: a checkbox, unchecked by default. When unchecked, file uploads are limited by the following two fields. When this box is checked, any type of media or MIME type can be uploaded. - **Allowed media types**: The default list contains the most common media types. Only files with media types included in this list may be uploaded to the installation. - Separate additions to the list with a comma. @@ -56,7 +56,7 @@ Settings are divided into two sections: **General** and **Security** settings. - Separate additions to the list with a comma. - To return to defaults, click the "Restore default extensions" button. -The final two fields relate to setting up [Google reCAPTCHA](https://www.google.com/recaptcha/intro/index.html){target=_blank} for your site. You will need both a site key and a secret key. Enter them in the corresponding fields after signing up with reCAPTCHA: +The final two fields relate to setting up [Google reCAPTCHA](https://www.google.com/recaptcha/intro/index.html) for your site. You will need both a site key and a secret key. Enter them in the corresponding fields after signing up with reCAPTCHA: - **reCAPTCHA site key** enables display of the widget on your install's sites. - **reCAPTCHA secret key** allows communication between your install and reCAPTCHA's server. diff --git a/docs/admin/users.md b/docs/admin/users.md index b97c157b..4164d581 100644 --- a/docs/admin/users.md +++ b/docs/admin/users.md @@ -101,7 +101,7 @@ On this tab, create a new password. It must be entered twice, in both the New Pa  -To see the password requirements, click the arrow next to the New Password field. This will display a list of [requirements](../../configuration) if any have been configured. +To see the password requirements, click the arrow next to the New Password field. This will display a list of [requirements](../configuration) if any have been configured. ### API keys Use this tab to generate an API key for the user. To generate one, you must provide a label for the key - this could be a date or the purpose of the key. Save the page to generate the key. diff --git a/docs/configuration.md b/docs/configuration.md index cfaadaf7..58af68b2 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -2,7 +2,7 @@ The following are commonly requested options which can be configured in the file `local.config.php`, located in the `/config` directory. -For a full list of available configuration keys, please see the [developer documentation page on configuration settings](https://omeka.org/s/docs/developer/configuration/){target=_blank}. +For a full list of available configuration keys, please see the [developer documentation page on configuration settings](https://omeka.org/s/docs/developer/configuration/). ## Password settings You can change the requirements for user passwords. The options include minimum length, number of upper and lowercase letters, and setting allowed symbols. @@ -57,9 +57,9 @@ The default thumbnailer is `Omeka\File\Thumbnailer\ImageMagick`. Also available You can also set the thumbnailer to `Omeka\File\Thumbnailer\NoThumbnail`, which will prevent your Omeka S installation from generating thumbnails. -[GD](https://secure.php.net/manual/en/intro.image.php){target=_blank} is a basic graphic library installed by default with PHP. It can create thumbnails for common image formats only (jpeg, gif, png). +[GD](https://secure.php.net/manual/en/intro.image.php) is a basic graphic library installed by default with PHP. It can create thumbnails for common image formats only (jpeg, gif, png). -[Imagick and ImageMagick](https://www.imagemagick.org){target=_blank} are the same library and can create thumbnails for more than 200 formats. Imagick is integrated into PHP and ImageMagick is the command-line version. +[Imagick and ImageMagick](https://www.imagemagick.org) are the same library and can create thumbnails for more than 200 formats. Imagick is integrated into PHP and ImageMagick is the command-line version. ImageMagick may require you to manually set a path in `imagemagick_dir`, whereas Imagick and GD do not require paths. @@ -104,7 +104,7 @@ If you have downloaded the file in order to edit it, be sure to upload the chang The `mail` key can be used to configure how Omeka S sends emails. Omeka sends emails to users upon registration and when they reset their passwords; modules can add other email functions, such as [confirming submissions](modules/collecting.md). -The default is to use [sendmail](https://en.wikipedia.org/wiki/Sendmail){target=_blank}, where the server is responsible for having mail delivery configured and set up. Sendmail generally requires no configuration on the Omeka S side. Another option for some servers is to configure a direct SMTP connection for sending mail. +The default is to use [sendmail](https://en.wikipedia.org/wiki/Sendmail), where the server is responsible for having mail delivery configured and set up. Sendmail generally requires no configuration on the Omeka S side. Another option for some servers is to configure a direct SMTP connection for sending mail. An example configuration, to be added at the end of `local.config.php`, will look something like this: @@ -128,4 +128,4 @@ An example configuration, to be added at the end of `local.config.php`, will loo ], ``` -See the [laminas-mail documentation](https://docs.laminas.dev/laminas-mail/transport/smtp-options/){target=_blank} for clarification. \ No newline at end of file +See the [laminas-mail documentation](https://docs.laminas.dev/laminas-mail/transport/smtp-options/) for clarification. \ No newline at end of file diff --git a/docs/content/item-sets.md b/docs/content/item-sets.md index ffdda0e5..add58f4c 100644 --- a/docs/content/item-sets.md +++ b/docs/content/item-sets.md @@ -61,7 +61,7 @@ In the image below, the first property (Title) is public as indicated by the ope  ### Text -Text fields are entered with text. The keyboard at the top of the field input indicates text. You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes){target=_blank} code for the language in which the text is written. +Text fields are entered with text. The keyboard at the top of the field input indicates text. You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) code for the language in which the text is written. ### Omeka Resource These fields create an internal link between the resource you are creating and the resource which fills that field. You have the option to use either another item or an item set. Once you select an item or item set, detailed information will load, and you must click "Select resource" to finish linking the resources. You can also click the "X" button in the upper right-hand corner to go back to the list of items or item sets. @@ -104,7 +104,7 @@ When you input a value for a property associated for a resource, you are making - Certainty: What is the confidence of this fact? - Type: What type of concept/thing is this fact? -In the world of linked data, this process is know as [reification](https://www.w3.org/wiki/RdfReification){target=_blank}. Each value can have any number of annotations. +In the world of linked data, this process is know as [reification](https://www.w3.org/wiki/RdfReification). Each value can have any number of annotations. To create an annotation, click on the ellipsis on the right side of the value input interface, and then click on the annotation icon (a dialogue bubble). @@ -125,7 +125,7 @@ By default, Omeka S will use the media from the first item added to an item set  -The assets you select from and upload as thumbnails in this tab are the same as those created for [site logos](../../sites/site_theme/#settings-options). +The assets you select from and upload as thumbnails in this tab are the same as those created for [site logos](../sites/site_theme.md#settings-options). To assign an asset as a thumbnail, click on the "Select" button in the main work area of the tab. This will open a drawer on the right side. diff --git a/docs/content/items.md b/docs/content/items.md index 3eb6ca99..2d8e1d57 100644 --- a/docs/content/items.md +++ b/docs/content/items.md @@ -85,7 +85,7 @@ Text fields allow for unformatted text entry.  -You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the [IETF Language tag](https://en.wikipedia.org/wiki/IETF_language_tag){target=_blank} code for the language in which the text is written. +You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the [IETF Language tag](https://en.wikipedia.org/wiki/IETF_language_tag) code for the language in which the text is written.  @@ -132,7 +132,7 @@ When you input a value for a property associated for a resource, you are making - Certainty: What is the confidence of this fact? - Type: What type of concept/thing is this fact? -In the world of linked data, this process is know as [reification](https://www.w3.org/wiki/RdfReification){target=_blank}. Each value can have any number of annotations. +In the world of linked data, this process is know as [reification](https://www.w3.org/wiki/RdfReification). Each value can have any number of annotations. To create an annotation, click on the ellipsis on the right side of the value input interface, and then click on the annotation icon (a dialogue bubble). @@ -149,7 +149,7 @@ Input the annotation, and click Set Annotations to finalize the process. Sites include a setting to indicate whether or not value annotations are visible to the public. #### Language -You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the [IETF Language tag](https://en.wikipedia.org/wiki/IETF_language_tag){target=_blank} for the language in which the text is written. +You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the [IETF Language tag](https://en.wikipedia.org/wiki/IETF_language_tag) for the language in which the text is written.  @@ -170,7 +170,7 @@ Using the buttons on the **Add New Media** menu on the right side of the screen, - **URL**: import media via a URI. - **HTML**: add html content as a media resource for your item. - **IIIF**: Add an IIIF image via URL. -- **oEmbed**: insert an embedded representation of an external URL. Note that this will only work with content from [existing oEmbed implementations](http://oembed.com/#section7){target=_blank} - use the URL in your browser’s location bar. +- **oEmbed**: insert an embedded representation of an external URL. Note that this will only work with content from [existing oEmbed implementations](http://oembed.com/#section7) - use the URL in your browser’s location bar. - **YouTube**: add a link to embed a YouTube video. Use the URL from your browser’s location bar (with `/watch/` in it) rather than the `youtu.be` link. You can edit media later by going by editing an item, navigating to the **Media** tab, and clicking the edit button (pencil) for a media when editing the item. @@ -214,7 +214,7 @@ By default, Omeka S will use the topmost media to generate a thumbnail for the i When you use an asset thumbnail instead of uploading media, the asset thumbnail does not display on the item's public show page. This makes such thumbnails useful for items which have no media but which would benefit from a thumbnail for the browse view, or for items whose media does not render an elegant thumbnail, such as audio or video files. -The assets you select from and upload as thumbnails in this tab are the same as those created for [site logos](../../sites/site_theme/#settings-options). +The assets you select from and upload as thumbnails in this tab are the same as those created for [site logos](../sites/site_theme.md#settings-options). To assign an asset as a thumbnail, click on the Select button in the main work area of the tab. This will open a drawer on the right side. diff --git a/docs/content/media.md b/docs/content/media.md index 68f39905..0b8668f2 100644 --- a/docs/content/media.md +++ b/docs/content/media.md @@ -27,7 +27,7 @@ Media are displayed in a table. Each media is a row, with columns for: Options for navigating and creating items display above the table of items: - On the left side is a display for the number of pages of media, with forward and back arrows. The current page number is an editable field - enter any valid page number and hit return/enter on your keyboard to go to that page. -- In the center top is a button for [Advanced Search](../../search#media-advanced-search). +- In the center top is a button for [Advanced Search](../search.md#media-advanced-search). - Just above the table on the right are options for sorting media, with two dropdown menus. The first lets you select between **Title**, **Class**, **Owner**, **(date) Created**, and **Size**; the second allows you to sort ascending or descending. To apply, click the "Sort" button. Clicking on the title of any media will take you to its metadata page. This page displays any metadata in the main work area, with a sidebar on the right listing the visibility, associated item (an active link), date created, MIME type, Size, Ingester, Source, and links to the file derivatives. @@ -57,7 +57,7 @@ To edit existing media, you can: - Go to the Media browse page, click on the title to view the media's metadata and then click the "Edit media" button in the upper right hand corner - Click on the media's name in the right-hand sidebar of an item's page to go to the media's metadata, and then click on "Edit media" from there. -Editing media is very similar to editing [items](../../content/items) or [item sets](../../content/item-sets). +Editing media is very similar to editing [items](../content/items) or [item sets](../content/item-sets).  @@ -78,7 +78,7 @@ Note that if you add the property `dcterms:title`, its contents will replace the  -You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe icon to activate a text field, then enter the [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes){target=_blank} code for the language in which the text is written. +You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe icon to activate a text field, then enter the [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) code for the language in which the text is written.  @@ -118,7 +118,7 @@ When you input a value for a property associated for a resource, you are making - Certainty: What is the confidence of this fact? - Type: What type of concept/thing is this fact? -In the world of linked data, this process is know as [reification](https://www.w3.org/wiki/RdfReification){target=_blank}. Each value can have any number of annotations. +In the world of linked data, this process is know as [reification](https://www.w3.org/wiki/RdfReification). Each value can have any number of annotations. To create an annotation, click on the ellipsis on the right side of the value input interface, and then click on the annotation icon (a dialogue bubble). @@ -134,7 +134,7 @@ Input the annotation, and click "Set Annotations" to finalize the process. Sites include a setting to indicate whether or not value annotations are visible to the public. -**Language**: You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes){target=_blank} code for the language in which the text is written. +**Language**: You can indicate the language for the content of an input using the globe symbol above the input (see the red arrow in the image below). Click on the globe to activate a text field, then enter the [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) code for the language in which the text is written.  diff --git a/docs/content/resource-template.md b/docs/content/resource-template.md index 48656ee0..fce6406d 100644 --- a/docs/content/resource-template.md +++ b/docs/content/resource-template.md @@ -12,13 +12,13 @@ On the right side above the table are two drop-down menus which let you sort res You can use the icons in each template’s row to: **edit** (pencil), **delete** (trash can), or **view details** (ellipsis). If you click on the number of items listed for a template, it will take you to a list of all those items. -[This screencast](https://vimeo.com/290924872){target=_blank} gives an overview of creating and applying resource templates: +[This screencast](https://vimeo.com/290924872) gives an overview of creating and applying resource templates:Omeka S Resource Templates from Omeka on Vimeo.
## Base Resource -All Omeka S installations include a "Base Resource" template which maps to the metadata fields required by the [Digital Public Library of America (DPLA)](https://dp.la/){target=_blank}. It will display in the table of resource templates as "Base Resource" with no owner. +All Omeka S installations include a "Base Resource" template which maps to the metadata fields required by the [Digital Public Library of America (DPLA)](https://dp.la/). It will display in the table of resource templates as "Base Resource" with no owner.  diff --git a/docs/content/vocabularies.md b/docs/content/vocabularies.md index 639ab38a..a8705ae0 100644 --- a/docs/content/vocabularies.md +++ b/docs/content/vocabularies.md @@ -6,16 +6,16 @@ For example, you can find ontologies for describing [audio signals](https://lov. > *"A vocabulary in LOV gathers definitions of a set of classes and properties (together simply called terms of the vocabulary), useful to describe specific types of things, or things in a given domain or industry, or things at large but for a specific usage." (Source:Omeka S Vocabularies from Omeka on Vimeo.
@@ -36,7 +36,7 @@ New vocabularies must be imported from an existing metadata standard source. In The New vocabulary page has three sections: Basic Info, File, and Advanced. -Note that you may have to research in order to find the prefix, namespace URI, and label for the vocabulary, as these are not standardized. In addition to the vocabulary's website, you might consultOmeka S Tour from Omeka on Vimeo.
diff --git a/docs/install.md b/docs/install.md index 78c363e6..692cf131 100644 --- a/docs/install.md +++ b/docs/install.md @@ -4,12 +4,12 @@ In order to install Omeka S, you will need a server running the following: - Linux -- Apache (with [AllowOverride](https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride){target=_blank} set to "All" and [mod_rewrite](http://httpd.apache.org/docs/current/mod/mod_rewrite.html){target=_blank} enabled) +- Apache (with [AllowOverride](https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride) set to "All" and [mod_rewrite](http://httpd.apache.org/docs/current/mod/mod_rewrite.html) enabled) - MySQL, minimum version 5.6.4 (or MariaDB, minimum version 10.0.5) -- PHP, minumum version 7.2, with [PDO](http://php.net/manual/en/intro.pdo.php){target=_blank}, [pdo_mysql](http://php.net/manual/en/ref.pdo-mysql.php){target=_blank}, and [xml](http://php.net/manual/en/intro.xml.php){target=_blank} extensions installed +- PHP, minumum version 7.2, with [PDO](http://php.net/manual/en/intro.pdo.php), [pdo_mysql](http://php.net/manual/en/ref.pdo-mysql.php), and [xml](http://php.net/manual/en/intro.xml.php) extensions installed - Optional, to create thumbnails: ImageMagick version 6.7.5 or greater, the PHP `imagick` extension, or the PHP `gd` extension. -[GD](https://secure.php.net/manual/en/intro.image.php){target=_blank} is a basic graphic library installed by default with PHP. It can create thumbnails for common image formats only (jpeg, gif, png). [Imagick and ImageMagick](https://www.imagemagick.org){target=_blank} are the same library and can create thumbnails for more than 200 formats. For more information, see the [Configuration page](configuration.md#thumbnails). +[GD](https://secure.php.net/manual/en/intro.image.php) is a basic graphic library installed by default with PHP. It can create thumbnails for common image formats only (jpeg, gif, png). [Imagick and ImageMagick](https://www.imagemagick.org) are the same library and can create thumbnails for more than 200 formats. For more information, see the [Configuration page](configuration.md#thumbnails). ## Installation methods @@ -18,7 +18,7 @@ In order to install Omeka S, you will need a server running the following: !!! note Before you install Omeka S, you need to create a MySQL database and user. Omeka S must have a dedicated database; you cannot use a prefix for a database used by another system or Omeka S or Classic installation. For more information on creating a database and user, please see your hosting's support documentation or talk to your system administrator. -1. [Download the latest release from the release page](https://omeka.org/s/download/){target=_blank}. +1. [Download the latest release from the release page](https://omeka.org/s/download/). 1. Extract this downloaded zip file to your computer. 1. Inside the directory, open the `config/database.ini` file and add your MySQL username, password, database name, and host name. The user and database must be created before this step. 1. Upload this entire directory to your server, into the folder of your choice. For example, if your server is `https://yourwebsite.org/`, you may wish to install Omeka S into a folder located at `https://yourwebsite.org/myomekas/`. Make sure it has your updated `database.ini` file (do not upload the original zip file you downloaded). @@ -27,21 +27,21 @@ In order to install Omeka S, you will need a server running the following: ### Installing from GitHub -Basic instructions for installing and updating from GitHub can be found in the [ReadMe](https://github.com/omeka/omeka-s/blob/develop/README.md){target=_blank} of the Omeka S GitHub repository. +Basic instructions for installing and updating from GitHub can be found in the [ReadMe](https://github.com/omeka/omeka-s/blob/develop/README.md) of the Omeka S GitHub repository. Then, in your web browser, navigate to the admin page for your Omeka S installation (`https://yourwebsite.org/myomekas/admin`), where you can complete the installation. ### One-click installation -Hosting companies that use [Softaculous](https://softaculous.com/){target=_blank} should offer a one-click install of [Omeka Classic](https://www.softaculous.com/softaculous/apps/educational/Omeka){target=_blank} and [Omeka S](https://www.softaculous.com/softaculous/apps/others/Omeka_S){target=_blank}. The one-click installation process through Softaculous may allow you to create a database and user at the same time, and will edit the `config/database.ini` file for you. +Hosting companies that use [Softaculous](https://softaculous.com/) should offer a one-click install of [Omeka Classic](https://www.softaculous.com/softaculous/apps/educational/Omeka) and [Omeka S](https://www.softaculous.com/softaculous/apps/others/Omeka_S). The one-click installation process through Softaculous may allow you to create a database and user at the same time, and will edit the `config/database.ini` file for you. Suggestions from our users include: -- [Reclaim Hosting](https://reclaimhosting.com/){target=_blank} - offers [simple Omeka S installations](https://support.reclaimhosting.com/hc/en-us/sections/204007617-Omeka){target=_blank} with some steps (including [manually setting the PHP path](#test-and-set-the-php-path)), and support for other open-source software platforms -- [Dotblock](http://www.dotblock.com){target=_blank} - uses Softaculous -- [HostGator](http://hostgator.com){target=_blank} - uses Softaculous -- [TMD Hosting](https://www.tmdhosting.com){target=_blank} - uses Softaculous -- [Webuzo](http://webuzo.com){target=_blank} - uses Softaculous. +- [Reclaim Hosting](https://reclaimhosting.com/) - offers [simple Omeka S installations](https://support.reclaimhosting.com/hc/en-us/sections/204007617-Omeka) with some steps (including [manually setting the PHP path](#test-and-set-the-php-path)), and support for other open-source software platforms +- [Dotblock](http://www.dotblock.com) - uses Softaculous +- [HostGator](http://hostgator.com) - uses Softaculous +- [TMD Hosting](https://www.tmdhosting.com) - uses Softaculous +- [Webuzo](http://webuzo.com) - uses Softaculous. ## Initial setup @@ -75,7 +75,7 @@ Omeka S uses background jobs for some long-running tasks that operate on many it Omeka S by default will try to automatically detect the path to the PHP CLI on the server, but for some servers this detection doesn't work, or there are multiple different `php` commands to choose from. -If you are [using Reclaim Hosting](#one-click-installation), you will have to manually set the PHP path when you install. See [their instructions here](https://support.reclaimhosting.com/hc/en-us/articles/1500005620481#omeka-s){target=_blank}. +If you are [using Reclaim Hosting](#one-click-installation), you will have to manually set the PHP path when you install. See [their instructions here](https://support.reclaimhosting.com/hc/en-us/articles/1500005620481#omeka-s). If you begin to see errors once you start working with Omeka, particularly errors with something like "PHP-CLI error: invalid PHP path", you will need to manually set the PHP path. See [Configuration Options](configuration.md) to learn about modifying thumbnail generation, setting the PHP path manually, and more. @@ -97,10 +97,10 @@ If you begin to see errors once you start working with Omeka, particularly error ### Updating from GitHub -Basic instructions for installing and updating from GitHub can be found in the [ReadMe](https://github.com/omeka/omeka-s/blob/develop/README.md){target=_blank} of the Omeka S GitHub repository. +Basic instructions for installing and updating from GitHub can be found in the [ReadMe](https://github.com/omeka/omeka-s/blob/develop/README.md) of the Omeka S GitHub repository. ## Install on Windows or Mac OS (development only) -Omeka S does not support proprietary or closed-source operating systems. However, for **basic development purposes** or for quick training, Omeka can run with [WAMP](http://www.wampserver.com){target=_blank}, [MAMP](https://www.mamp.info){target=_blank}, or similar tools. +Omeka S does not support proprietary or closed-source operating systems. However, for **basic development purposes** or for quick training, Omeka can run with [WAMP](http://www.wampserver.com), [MAMP](https://www.mamp.info), or similar tools. Follow the standard installation instructions. You will need to make the following [configuration](configuration.md) changes to the file `config/local.config.php` to work. diff --git a/docs/modules/collecting.md b/docs/modules/collecting.md index 31b8bf84..fe16d17a 100644 --- a/docs/modules/collecting.md +++ b/docs/modules/collecting.md @@ -1,6 +1,6 @@ # Collecting -The [Collecting module](https://omeka.org/s/modules/Collecting/){target=_blank} allows you to gather public contributions through your sites. Users can upload files or submit textual entries along with some identifying metadata, which your site administrators can then moderate and approve for inclusion. +The [Collecting module](https://omeka.org/s/modules/Collecting/) allows you to gather public contributions through your sites. Users can upload files or submit textual entries along with some identifying metadata, which your site administrators can then moderate and approve for inclusion. Once activated on the [modules](index.md) tab of the admin dashboard, Collecting is configured on a site-by-site basis. It adds a section to your Site Settings page, and adds a link under each Site for Collecting forms. Forms are added to site pages by way of [page blocks](../sites/site_pages.md#page-blocks). diff --git a/docs/modules/csseditor.md b/docs/modules/csseditor.md index 16ba54b6..9679b184 100644 --- a/docs/modules/csseditor.md +++ b/docs/modules/csseditor.md @@ -1,14 +1,14 @@ # CSS Editor -The [CSS Editor module](https://omeka.org/s/modules/CSSEditor){target=_blank} allows you to write CSS from the Omeka S admin interface. +The [CSS Editor module](https://omeka.org/s/modules/CSSEditor) allows you to write CSS from the Omeka S admin interface. -Once activated on the [modules](https://omeka.org/s/docs/user-manual/modules/){target=_blank} section of the admin dashboard, CSS Editor is used on a site-by-site basis. +Once activated on the [modules](https://omeka.org/s/docs/user-manual/modules/) section of the admin dashboard, CSS Editor is used on a site-by-site basis. If you are new to working with CSS, we recommend the following free resources for getting started: -* [Mozilla's "Learn CSS"](https://developer.mozilla.org/en-US/docs/Web/CSS){target=_blank} -* [Codecademy's "Learn CSS" course](https://www.codecademy.com/learn/learn-css){target=_blank} -* [Marksheet's "CSS Basics"](https://marksheet.io/css-basics.html){target=_blank} +* [Mozilla's "Learn CSS"](https://developer.mozilla.org/en-US/docs/Web/CSS) +* [Codecademy's "Learn CSS" course](https://www.codecademy.com/learn/learn-css) +* [Marksheet's "CSS Basics"](https://marksheet.io/css-basics.html) The easiest way to learn Omeka S page components for the sake of CSS editing is to use your browser's Inspect tool when looking at your chosen theme. @@ -34,7 +34,7 @@ To remove external stylesheets, either clear the text inputs, or click on the tr ## Tutorial: Using a Google webfont -You can make your Omeka S site more distinct by using a custom font. [Google provides a free library of webfonts](https://fonts.google.com/){target=_blank}, and this tutorial will demonstrate how to apply a webfont to an Omeka S site using the "Default" theme through the CSS Editor interface. +You can make your Omeka S site more distinct by using a custom font. [Google provides a free library of webfonts](https://fonts.google.com/), and this tutorial will demonstrate how to apply a webfont to an Omeka S site using the "Default" theme through the CSS Editor interface. For reference, the "Default" theme begins looking like this, using the "Open Sans" font. @@ -42,7 +42,7 @@ For reference, the "Default" theme begins looking like this, using the "Open San This tutorial will override "Open Sans" with the "Lato" font family. -1. Navigate to [Google Fonts](https://fonts.google.com/){target=_blank}. Find the "Lato" font family and click on the orange "+" button to select it. +1. Navigate to [Google Fonts](https://fonts.google.com/). Find the "Lato" font family and click on the orange "+" button to select it. Creating a Scripto project from Omeka on Vimeo.
@@ -81,7 +81,7 @@ If you select Media, the content created in Scripto will appear in the media met - Translation ### Reviewers -Add [Omeka S users](../../../admin/users/) to your Scripto project as reviewers, who can can access private projects, and mark media as approved and unapproved. You can manage users after adding a project (see below). +Add [Omeka S users](../../admin/users) to your Scripto project as reviewers, who can can access private projects, and mark media as approved and unapproved. You can manage users after adding a project (see below). Only Omeka users with **site administrator** and g**lobal administrator** roles can sync and import projects, due to the destructive potential of those actions. @@ -157,7 +157,7 @@ To find items which have been edited and are ready for review, filter all items You can edit your project using the Actions dropdown in the upper right hand corner of the screen. It offers the same two tabs you used when [creating your project](#create-a-project) - [Configuration](#configuration-options) and [Reviewers](#reviewers). ## Admin Item Review -[This screencast](https://vimeo.com/431828023){target=_blank} shows the process of reviewing an item and its media: +[This screencast](https://vimeo.com/431828023) shows the process of reviewing an item and its media:Reviewing Scripto Content from Omeka on Vimeo.
@@ -258,11 +258,11 @@ The next section is **Review status**. You can toggle the drawer open and closed using the open arrow `>` button in the middle of the divider between the drawer and the main work area. -#### Media status: +### Media status: * **Complete**: Community users have the ability to mark a media they are working on as "complete." This serves as a flag to notify the project team that the media is ready for review. If a media is not completely transcribed/translated/described, adminstrators can reverse the Complete status. * **Approved**: Approval is granted by administrators and indicates that every media is complete and satisfactory. Items can only be considered approved when all child media are approved. -* **Protected**: Protection is a [MediaWiki function](https://www.mediawiki.org/wiki/Manual:Administrators#Protection){target=_blank}. In the context of Scripto, it is a way for project owners to close editing on a media or item at a certain point, either because it is complete or because of a need to deal with that particular media or item (bad scan, for example). +* **Protected**: Protection is a [MediaWiki function](https://www.mediawiki.org/wiki/Manual:Administrators#Protection). In the context of Scripto, it is a way for project owners to close editing on a media or item at a certain point, either because it is complete or because of a need to deal with that particular media or item (bad scan, for example). * Protection can be limited to users, confirmed users, or administrators. In addition, you can choose to protect the media infinitely or for a set amount of time: 1 hour; 1 day; 1 week; 2 weeks; 1 month; 3 months; 6 months; or 1 year. ### Revision History diff --git a/docs/modules/scripto/troubleshootingScripto.md b/docs/modules/scripto/troubleshootingScripto.md index 41f8476f..434d7fb8 100644 --- a/docs/modules/scripto/troubleshootingScripto.md +++ b/docs/modules/scripto/troubleshootingScripto.md @@ -13,7 +13,7 @@ $wgGroupPermissions['*']['edit'] = false; to the file `LocalSettings.php`. -For more information, see the [MediaWiki manual on preventing access](https://www.mediawiki.org/wiki/Manual:Preventing_access){target=_blank}. +For more information, see the [MediaWiki manual on preventing access](https://www.mediawiki.org/wiki/Manual:Preventing_access). ## Troubleshooting ### Project sync stuck diff --git a/docs/modules/sharing.md b/docs/modules/sharing.md index c8b680b0..0538cf8c 100644 --- a/docs/modules/sharing.md +++ b/docs/modules/sharing.md @@ -1,6 +1,6 @@ # Sharing -The [Sharing module](https://omeka.org/s/modules/Sharing){target=_blank} allows you to add buttons to site pages which visitors can use to share and embed content from your site on social media or via email. +The [Sharing module](https://omeka.org/s/modules/Sharing) allows you to add buttons to site pages which visitors can use to share and embed content from your site on social media or via email. Currently, Sharing supports the following options: diff --git a/docs/modules/valuesuggest.md b/docs/modules/valuesuggest.md index adfd337c..7487c80b 100644 --- a/docs/modules/valuesuggest.md +++ b/docs/modules/valuesuggest.md @@ -1,6 +1,6 @@ # Value Suggest -The [Value Suggest module](https://omeka.org/s/modules/ValueSuggest){target=_blank} adds an auto-complete feature to specific properties in a resource template, and draws on controlled vocabularies (see the end of this page for a complete list) to help users fill them out. Value Suggest appears when a user is editing the metadata of a resource (an item, a piece of media, or an item set) that uses the enabled resource template. +The [Value Suggest module](https://omeka.org/s/modules/ValueSuggest) adds an auto-complete feature to specific properties in a resource template, and draws on controlled vocabularies (see the end of this page for a complete list) to help users fill them out. Value Suggest appears when a user is editing the metadata of a resource (an item, a piece of media, or an item set) that uses the enabled resource template. This functionality helps those building an Omeka site encourage consistent metadata input and data compatibility with other databases of records. Note that Value Suggest offers, but cannot require, that users select values from the autosuggest feature. Users will always have the option of creating their own value instead. @@ -58,40 +58,40 @@ This module includes the following vocabularies: - UNESCO - Les vocabulaires du Ministère de la Culture. -### [Dublin Core (DCMI Metadata Terms)](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/){target=_blank} +### [Dublin Core (DCMI Metadata Terms)](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/) - Classes - Elements - Terms - Types. -### [Gemeinsame Normdatei (GND)](http://lobid.org/gnd){target=_blank} +### [Gemeinsame Normdatei (GND)](http://lobid.org/gnd) - The GND contains standardized entries for persons, corporations, congresses, geographical areas, key words and work titles. -### [GeoNames](http://www.geonames.org/){target=_blank} +### [GeoNames](http://www.geonames.org/) - The GeoNames geographical database. -### [The Getty Vocabularies](http://vocab.getty.edu/){target=_blank} +### [The Getty Vocabularies](http://vocab.getty.edu/) - The Art & Architecture Thesaurus (AAT) - The Getty Thesaurus of Geographic Names (TGN) - The Union List of Artist Names (ULAN). -### [Homosaurus](http://homosaurus.org/){target=_blank} +### [Homosaurus](http://homosaurus.org/) - Homosaurus.org linked data vocabulary. -### [IdRef](https://www.idref.fr/){target=_blank} +### [IdRef](https://www.idref.fr/) - The French national database of identifiers for research (all repositories) - Person names - Corporations - Conferences - Subject headings (all) -- Subject headings [RAMEAU](https://rameau.bnf.fr){target=_blank} (Répertoire d’autorité-matière encyclopédique et alphabétique unifié, or Unified encyclopaedic and alphabetical list of subject authorities) -- Subject headings [F-MeSH](http://mesh.inserm.fr/FrenchMesh){target=_blank} (French version of the medical subject headings) +- Subject headings [RAMEAU](https://rameau.bnf.fr) (Répertoire d’autorité-matière encyclopédique et alphabétique unifié, or Unified encyclopaedic and alphabetical list of subject authorities) +- Subject headings [F-MeSH](http://mesh.inserm.fr/FrenchMesh) (French version of the medical subject headings) - Geographic names - Family names - Titles @@ -100,7 +100,7 @@ This module includes the following vocabularies: - PPN (unique identifier used for any item in all the database) - Libraries (RCR: Répertoire des centres de ressources). -### [Library of Congress Linked Data Service](http://id.loc.gov/){target=_blank} +### [Library of Congress Linked Data Service](http://id.loc.gov/) - AFS Ethnographic Thesaurus - All @@ -121,7 +121,7 @@ This module includes the following vocabularies: - Subject Headings - Thesaurus for Graphic Materials. -### [Nuovo Soggettario](https://thes.bncf.firenze.sbn.it/){target=_blank} +### [Nuovo Soggettario](https://thes.bncf.firenze.sbn.it/) - Agenti: Organismi - Agenti: Organizzazioni @@ -137,21 +137,21 @@ This module includes the following vocabularies: - Cose: Strutture - Tempo. -### [OCLC Metadata Services](https://www.oclc.org/en/services/a-z.html/:F2664:/){target=_blank} +### [OCLC Metadata Services](https://www.oclc.org/en/services/a-z.html/:F2664:/) - Faceted Application of Subject Terminologies (FAST) - The Virtual International Authority File (VIAF). -### [PACTOLS of Frantiq](https://pactols.frantiq.fr/){target=_blank} +### [PACTOLS of Frantiq](https://pactols.frantiq.fr/) - The entire PACTOLS thesaurus - The subject group only. -### [PeriodO](http://perio.do/en/){target=_blank} +### [PeriodO](http://perio.do/en/) - A gazetteer of period definitions for linking and visualizing data. -### [RDA Value Vocabularies](http://www.rdaregistry.info/termList/){target=_blank} +### [RDA Value Vocabularies](http://www.rdaregistry.info/termList/) #### RDA Reference value vocabularies @@ -216,11 +216,11 @@ This module includes the following vocabularies: - Sensory Mode - Storage Medium Format. -### [RightsStatements.org](https://rightsstatements.org/){target=_blank} +### [RightsStatements.org](https://rightsstatements.org/) - Provides a set of standardized rights statements for cultural heritage institutions that can be used to communicate the copyright and re-use status of digital objects to the public. -### [Tesauros del patrimonio cultural de España](http://tesauros.mecd.es/tesauros){target=_blank} +### [Tesauros del patrimonio cultural de España](http://tesauros.mecd.es/tesauros) - Diccionario de Bienes Culturales - Diccionario de Materias @@ -232,13 +232,13 @@ This module includes the following vocabularies: - Diccionario de Numismática - Diccionario de Mobiliario. -### [UNESCO](http://skos.um.es/){target=_blank} +### [UNESCO](http://skos.um.es/) - Tesauro - Nomenclatura de Ciencia y Tecnología - Biblioteca Digital Floridablanca. -### [Les vocabulaires du Ministère de la Culture](http://data.culture.fr/thesaurus/){target=_blank} +### [Les vocabulaires du Ministère de la Culture](http://data.culture.fr/thesaurus/) - Catégories techniques et domaines - Inventaire/MH - Domaines archivistiques pour l'indexation des circulaires diff --git a/docs/modules/zoteroimport.md b/docs/modules/zoteroimport.md index 67d054a5..ec21244e 100644 --- a/docs/modules/zoteroimport.md +++ b/docs/modules/zoteroimport.md @@ -1,6 +1,6 @@ # Zotero Import -The [Zotero Import module](https://omeka.org/s/modules/ZoteroImport){target=_blank} allows you to connect an Omeka S instance to a Zotero library and import items from that library. +The [Zotero Import module](https://omeka.org/s/modules/ZoteroImport) allows you to connect an Omeka S instance to a Zotero library and import items from that library. ## Prepare your Zotero Library In order to import from a Zotero library, you must have API access to the library. To use Zotero Import, you will need the ID for the group or user: diff --git a/docs/s-planning-tips.md b/docs/s-planning-tips.md index 03b0b64b..5814623b 100644 --- a/docs/s-planning-tips.md +++ b/docs/s-planning-tips.md @@ -1,6 +1,6 @@ # Planning Tips -In Omeka S, you build your [sites](../sites) page by page, using already existing resources on your installation. While it is best to have some resources before you start building out the pages, you can begin planning your site before you create the first item or item set. +In Omeka S, you build your [sites](sites/index) page by page, using already existing resources on your installation. While it is best to have some resources before you start building out the pages, you can begin planning your site before you create the first item or item set. What follows are some questions and ideas to help guide you as you plan your sites in Omeka S. @@ -13,27 +13,27 @@ What follows are some questions and ideas to help guide you as you plan your sit ## Resources **What will you do with items in this website?** -[Items](../content/items/) are the building blocks of Omeka S. What sort of [resource templates](../content/resource-template/) will you want to create and use to fully describe your items? Any item you include on an Omeka S will have a public item show page, so try to ensure that the information in an item's metadata can stand on its own. +[Items](content/items) are the building blocks of Omeka S. What sort of [resource templates](content/resource-template) will you want to create and use to fully describe your items? Any item you include on an Omeka S will have a public item show page, so try to ensure that the information in an item's metadata can stand on its own. **What will you do with item sets?** -You can use [item sets](../content/item-sets) to group items to be included on a [site](../sites), and they can be a way to guide visitors' browsing on your sites. For some sites, item sets are robust resources themselves. +You can use [item sets](content/item-sets) to group items to be included on a [site](sites/index), and they can be a way to guide visitors' browsing on your sites. For some sites, item sets are robust resources themselves. How do you want to group items into sets? What metadata fields will your item sets use? Do your item sets have relations to each other or to items? **What do you want your data to do?** -What properties are you going to want to consistently describe in your site? Do you want some of these to display with a different label - for example 'author' instead of 'creator' for books? Use a [resource template](../content/resource-template/) and change the label of the property. +What properties are you going to want to consistently describe in your site? Do you want some of these to display with a different label - for example 'author' instead of 'creator' for books? Use a [resource template](content/resource-template) and change the label of the property. In Omeka S, items and item sets can use other resources - items, item sets, and media - as properties; for example, you can make an item for William Shakespeare and have that item fill the 'creator' property for a 'Hamlet' item. How can your resources use this functionality? -Do you want to use a set of terms (controlled vocabulary) for certain items? You might want to use [Custom Vocab](../modules/customvocab/). Or do you want to use a terms list created by the Library of Congress or the Getty? Then you might use [Vocab Suggest](../modules/valuesuggest/). +Do you want to use a set of terms (controlled vocabulary) for certain items? You might want to use [Custom Vocab](modules/customvocab). Or do you want to use a terms list created by the Library of Congress or the Getty? Then you might use [Vocab Suggest](modules/valuesuggest). ## Building a site With Omeka S you will build your site from the ground up, which means you need to give some thought to how you want to organize your site. **What pages do you want to include?** What kind of content do you want on these pages? How do you want to arrange them? Try sketching out a sample menu or wireframes for the site. Use that as a guide as you build your pages. -Pages are made up of [blocks](../sites/site_pages/#page-blocks), which can include text, images, and much more. What kind of content do you want on the pages you build? Bear in mind that you can rearrange page blocks as you build, so you can play around with the order of the content on your pages if you need to. +Pages are made up of [blocks](sites/site_pages.md#page-blocks), which can include text, images, and much more. What kind of content do you want on the pages you build? Bear in mind that you can rearrange page blocks as you build, so you can play around with the order of the content on your pages if you need to. -**How do you want to interact with your visitors on your site?** Do you want to [collect](../modules/collecting/) resources from your visitors? Allow them to [share](../modules/sharing/) your content on social media? +**How do you want to interact with your visitors on your site?** Do you want to [collect](modules/collecting) resources from your visitors? Allow them to [share](modules/sharing) your content on social media? Will you require users to create accounts on your site? Familiarize yourself with [user roles and permissions](admin/users.md). diff --git a/docs/sites/index.md b/docs/sites/index.md index 607634b0..4493ba21 100644 --- a/docs/sites/index.md +++ b/docs/sites/index.md @@ -29,7 +29,7 @@ The "New site" page has two tabs: **Info** and **Theme**. * Give your site a **title** (required). * Create a **slug** for the site’s url. The url will be `youromekainstall.org/s/slug`. This is optional - if you leave this field blank, Omeka S will create a slug based on the site title. -* Create a **summary** for your site: a brief description of what it is about. The summary text will appear on your installation's landing page and on the [list of sites](../sites/site_pages#list-of-sites) page block. +* Create a **summary** for your site: a brief description of what it is about. The summary text will appear on your installation's landing page and on the [list of sites](site_pages.md#list-of-sites) page block. * Upload a **thumbnail** for your site, which will replace the summary text on the landing page or in the list of sites block.  @@ -70,4 +70,4 @@ Site admin left hand navigation options are: - [Resources](../sites/site_resources.md), - [User permissions](../sites/site_users.md), - [Theme](../sites/site_theme.md), and -- Settings added by modules, if installed. \ No newline at end of file +- Settings added by modules, if installed. diff --git a/docs/sites/site_theme.md b/docs/sites/site_theme.md index 69eddfd2..6672d16b 100644 --- a/docs/sites/site_theme.md +++ b/docs/sites/site_theme.md @@ -113,12 +113,12 @@ Select how to display items within their browse views. #### Foundation theme settings -Foundation is a theme that comes with a few default stylesheets for fast prototyping or getting started with modifying themes. As a result, it has some unique settings. For more information on using Foundation, including working with Sass, see the [theme ReadMe file](https://github.com/omeka-s-themes/foundation-s/blob/master/README.md){target=_blank}. +Foundation is a theme that comes with a few default stylesheets for fast prototyping or getting started with modifying themes. As a result, it has some unique settings. For more information on using Foundation, including working with Sass, see the [theme ReadMe file](https://github.com/omeka-s-themes/foundation-s/blob/master/README.md). Settings not described above: * **Stylesheet:** The theme provides 4 style options. - * **Default** uses ZURB Foundation's default styles for prototyping, which are all viewable in their documentation under the [Kitchen Sink](https://get.foundation/sites/docs/kitchen-sink.html){target=_blank}. + * **Default** uses ZURB Foundation's default styles for prototyping, which are all viewable in their documentation under the [Kitchen Sink](https://get.foundation/sites/docs/kitchen-sink.html). * **Revolution** aims to capture the feel of old documents and juxtaposes it with a bright red accent. It includes a textured paper background image. * **Sea Foam** offers a clean, friendly look with a teal palette. * **Inkwell** features a high contrast serif family for its typography, as well as sunny yellow accents. diff --git a/docs/translateOmekaS.md b/docs/translateOmekaS.md index f31ded1a..a169cb23 100644 --- a/docs/translateOmekaS.md +++ b/docs/translateOmekaS.md @@ -5,10 +5,10 @@ We need the community's help translating English text in Omeka S into new langua ## Getting started ### Sign up on Transifex.com -Omeka S uses [Transifex.com](https://www.transifex.com){target=_blank} to manage translations. To start helping to translate Omeka into other languages, you will first need to [sign up for an account](https://www.transifex.com/signup/){target=_blank}. Transifex.net offers several plans, but since Omeka is an open-source project, you can use the Free plan. +Omeka S uses [Transifex.com](https://www.transifex.com) to manage translations. To start helping to translate Omeka into other languages, you will first need to [sign up for an account](https://www.transifex.com/signup/). Transifex.net offers several plans, but since Omeka is an open-source project, you can use the Free plan. ### Join or start a language team -Once you have registered for an account, visit the [Omeka S project page](https://www.transifex.com/omeka/omeka-s/){target=_blank} and click on the "Help Translate Omeka S" or "Join Team" button. +Once you have registered for an account, visit the [Omeka S project page](https://www.transifex.com/omeka/omeka-s/) and click on the "Help Translate Omeka S" or "Join Team" button. Here, you can choose among all the languages that are already being worked on. If you want to start work on a translation into a new language which isn't listed, you need to request that language first. Click "cancel" and scroll down to the bottom of the page and click the "request language" link, and select the language that you want to work on. @@ -16,9 +16,9 @@ On the other hand, if someone has already created a team for the language you wa Once a coordinator has approved you to the team, you can go to the Omeka S dashboard and click on the "Translate" button to begin translating. -If you want to check your translation or anything else you need to make an mo file from your po file, you can do it with msgfmt from the [GNU gettext package](http://www.gnu.org/software/gettext/){target=_blank}. +If you want to check your translation or anything else you need to make an mo file from your po file, you can do it with msgfmt from the [GNU gettext package](http://www.gnu.org/software/gettext/). -For Transifex-specific issues, please see their [documentation](http://docs.transifex.com/){target=_blank}. +For Transifex-specific issues, please see their [documentation](http://docs.transifex.com/). ## Translation guidelines diff --git a/index.rst b/index.rst new file mode 100644 index 00000000..6dd5c218 --- /dev/null +++ b/index.rst @@ -0,0 +1,101 @@ +===================== + Omeka S User Manual +===================== + +Omeka S is a web publication system for universities, galleries, libraries, +archives, and museums. It creates a local network of independently curated +exhibits sharing a collaboratively built pool of items and their metadata. + +The sections of this manual correspond to the navigation sections on the +left-hand side of the :doc:`administrative dashboard