Reorder Images

Introduction
The plugin allows automatic sorting of image files that were not created continuously during creation and instead were saved separately for left and right pages. This is useful if, for example, an opening angle of a book that is too small prohibits the scanning of left and right pages simultaneously.
Overview
Details
​
Identifier
intranda_step_reorder_images
Source code
​https://github.com/intranda/goobi-plugin-step-reorder-images​
Licence
GPL 2.0 or newer
Compatibility
Goobi workflow 2020.09
Documentation date
04.10.2020
Installation
To install the plugin, the following file must be installed:
1
/opt/digiverso/goobi/plugins/step/plugin_intranda_step_reorder_images.jar
Copied!
To configure how the plugin should behave, various values can be adjusted in the configuration file. The configuration file is usually located here:
1
/opt/digiverso/goobi/config/plugin_intranda_step_reorder_images.xml
Copied!
Configuration of the plugin
The configuration of the plugin is structured as follows:
1
<config_plugin>
2
​
3
    <config>
4
        <!-- which projects to use for (can be more then one, otherwise use *) -->
5
        <project>*</project>
6
        <step>*</step>
7
​
8
        <!-- which folder to use as source (master|media|jpeg|source|...) -->
9
        <sourceFolder>master</sourceFolder>
10
​
11
    <!-- which folder to use as target (master|media|jpeg|source|...) -->
12
        <targetFolder>media</targetFolder>
13
​
14
    <!-- use prefix from previous file name separated by following underscore -->
15
        <usePrefix>true</usePrefix>
16
​
17
    <!-- define if the first page is right or left -->
18
        <firstFileIsRight>true</firstFileIsRight>
19
​
20
    <!-- define which naming format shall be used; default is %04d -->
21
        <namingFormat>%04d</namingFormat>
22
​
23
    <!-- files to be ignored and moved to the end, can be multiple ones, used
24
            in the order as defined here, the string mentioned here has to be contained
25
            in file name -->
26
        <blacklist>_Spine_2</blacklist>
27
        <blacklist>_Spine_1</blacklist>
28
        <blacklist>_Colourchart</blacklist>
29
    </config>
30
​
31
</config_plugin>
Copied!
The block <config> can occur repeatedly for different projects or workflow steps in order to be able to carry out different actions within different workflows. The other parameters within this configuration file have the following meanings:
Value
Description
project
This parameter determines the project for which the current block <config> is to apply. The name of the project is used here. This parameter can occur several times per <config> block.
step
This parameter controls for which workflow steps the block <config> is to apply. The name of the step is used here. This parameter can occur several times per <config> block.
sourceFolder
This parameter specifies the directory from which the files are to be read. This is usually the master directory (master).
targetFolder
Here you can specify the folder to which the reordered files are saved. This is usually the directory media.
usePrefix
If a prefix is to be taken into account for the conversion, which precedes the file name and ends with an underscore, this can be defined here.
firstFileIsRight
Since the plugin proceeds differently whether the first file is a right or left page, this can be specified here.
namingFormat
The files are given new file names after they are re-sorted. How these should look like can be defined with a regular expression. The default value for this is %04d, which generates 4-digit numbers for the file names.
blacklist
If selected files within the sorting are to be ignored and placed at the end of the previously sorted files, they can be named here. The files will be placed at the end of the list in the order in which they are listed here. They will then also receive a new file name that counts upwards.
Integration of the plugin into the workflow
To use the plugin, it must be activated for one or more desired tasks in the workflow. This is done as shown in the following screenshot by selecting the plugin intranda_step_reorder_images from the list of installed plugins.
Assigning the plugin to a specific task
Since this plugin is usually to be executed automatically, the step in the workflow should be configured as automatic.
How the plugin works
Once the plugin is fully installed and set up, it is usually executed automatically within the workflow, so there is no manual interaction with the user. Instead, the plugin is called by the workflow in the background and starts the re-sorting and renaming of the files depending on the selected configuration.

Step Plugins - Previous

Generate Identifier

Next - Step Plugins

Transcription of image content

Last modified 1yr ago

Copy link

Contents

Introduction

Overview

Installation

Configuration of the plugin

Integration of the plugin into the workflow

How the plugin works