Ap1e26 at 13:49, 13 October 2026

2026-10-13T13:49:57Z

Ap1e26: Created page with "Category:Howto An '''Ingredient''' in EPrints is a modular package or extension (such as `image_tiles`) that adds specific functionality to an EPrints repository flavo..."

2026-10-13T13:49:18Z

Created page with "Category:Howto An '''Ingredient''' in EPrints is a modular package or extension (such as `image_tiles`) that adds specific functionality to an EPrints repository flavo..."

New page

[[Category:Howto]]
An '''Ingredient''' in [[EPrints]] is a modular package or extension (such as `image_tiles`) that adds specific functionality to an EPrints repository flavour.

This guide explains how to install an ingredient by cloning its source repository and registering it in your flavour's inclusion configuration file.

== Clone the Ingredient Repository ==
Navigate to your EPrints ingredients directory (`/opt/eprints3/ingredients/`) and clone the git repository.

For example, to install the '''image_tiles''' ingredient:

<syntaxhighlight lang="bash">
cd /opt/eprints3/ingredients/
git clone https://github.com/eprints/image_tiles
</syntaxhighlight>

''Note: Ensure the resulting destination directory path matches `/opt/eprints3/ingredients/image_tiles`.''

== Register the Ingredient in the Flavour Include File ==
To activate the ingredient, you must declare it in your flavour's `inc` configuration file located at:

`/opt/eprints3/flavours/<flavour_name>_lib/inc`
<i>the most common flavour name is pub_lib

# Open the `inc` file in a text editor (e.g., `nano` or `vim`):
#: <syntaxhighlight lang="bash">nano /opt/eprints3/flavours/<flavour_name>_lib/inc</syntaxhighlight>
# Add the ingredient path line above the site library inclusion line (typically `#site_lib` or `site_lib`):
#: <syntaxhighlight lang="text">
ingredients/image_tiles
</syntaxhighlight>

=== Configuration File Example ===
Your `inc` file structure should look similar to this:

<syntaxhighlight lang="text">
# Active ingredients
ingredients/image_tiles

# Site core library
site_lib
</syntaxhighlight>

== Step 3: Restart Apache ==
For EPrints to pick up the changes to the flavour configuration, restart the web server:

<syntaxhighlight lang="bash">
sudo systemctl restart apache2
</syntaxhighlight>

@@ Line 1: / Line 1: @@
 [[Category:Howto]]
-An '''Ingredient''' in [[EPrints]] is a modular package or extension (such as `image_tiles`) that adds specific functionality to an EPrints repository flavour.
+An '''Ingredient''' in EPrints is a modular package or extension (such as `image_tiles`) that adds specific functionality to an EPrints repository flavour.
 This guide explains how to install an ingredient by cloning its source repository and registering it in your flavour's inclusion configuration file.

Installing Ingredients - Revision history

Ap1e26 at 13:49, 13 October 2026

Ap1e26: Created page with "Category:Howto An '''Ingredient''' in EPrints is a modular package or extension (such as `image_tiles`) that adds specific functionality to an EPrints repository flavo..."