Goobi viewer (English)
Documentation homeGoobi viewer Digests
  • Goobi viewer manual
  • Documentation overview
  • What is the Goobi viewer?
  • Configuration
    • 1. Goobi viewer Core
      • 1.1 Local settings
      • 1.2 Translations
      • 1.3 Folder configuration
      • 1.4 URL configuration
      • 1.5 User accounts
        • 1.5.1 Authentication Provider
        • 1.5.2 Sending e-mails
        • 1.5.3 Further settings
      • 1.6 Performance
      • 1.7 Access conditions and images
      • 1.8 Captcha
      • 1.9 PDF download
        • 1.9.1 Variants
        • 1.9.2 Download Links
        • 1.9.3 Individual PDF title page
      • 1.10 ePub download
      • 1.11 Image options
        • 1.11.1 Extended scrolling in the image view
        • 1.11.2 Navigation between structure types
        • 1.11.3 Image view configuration
        • 1.11.4 Maintaining zoom and rotation while browsing in the image view
        • 1.11.5 External images
        • 1.11.6 Restriction of image scaling
        • 1.11.7 Thumbnail settings
        • 1.11.8 Image Footer
      • 1.12 Individual page types
      • 1.13 Opening certain document types in alternative page views
      • 1.14 Full text hints
      • 1.15. Language settings
      • 1.16 Theme
        • 1.16.1 External themes
      • 1.17 Search
        • 1.17.1 Sorting
        • 1.17.2 Faceting
        • 1.17.3 Advanced search
        • 1.17.4 Timeline
        • 1.17.5 Calendar
        • 1.17.6 Save search
        • 1.17.7 Expand query for search sub-results
        • 1.17.8 Aggregated search hit display
        • 1.17.9 Versioning of records
        • 1.17.10 Exporting search results
        • 1.17.11 Search hit metadata
      • 1.18 Digital collections
        • 1.18.1 Collection hierarchy
        • 1.18.2 Sorting of records
        • 1.18.3 Sorting of collections
        • 1.18.4 Blacklist
        • 1.18.5 Collection size
        • 1.18.6 Further settings
        • 1.18.7 Structure element whitelist
      • 1.19 Metadata
        • 1.19.1 Main metadata
        • 1.19.2 Sidebar metadata
        • 1.19.3 Search hit metadata
        • 1.19.4 Archive metadata
        • 1.19.5 Image metadata
        • 1.19.6 Display of authority data
        • 1.19.7 Calendar structure elements
        • 1.19.8 Browsing
        • 1.19.9 Multilingual metadata
        • 1.19.10 Licenses
      • 1.20 Tables of contents
        • 1.20.1 Main table of contents
        • 1.20.2 Sidebar table of contents
        • 1.20.3 Download tables of content as PDF file
      • 1.21 Tag clouds
      • 1.22 Resolver
      • 1.23 Sidebar
      • 1.24 Navigation and display
      • 1.25 RSS feed
      • 1.26 Reading lists
      • 1.27 User comments
      • 1.28 CMS
      • 1.29 Transkribus
      • 1.30 Original content
      • 1.31 Piwik/Matomo
      • 1.32 Sitelinks
      • 1.33 API
        • 1.33.1 JSON
        • 1.33.2 IIIF
        • 1.33.3 Authentication
        • 1.33.4 CORS
      • 1.34 OpenSearch
      • 1.35 Embedding
      • 1.36 Maps
      • 1.37 Translations
      • 1.38 Archive
      • 1.39 Campaigns
      • 1.40 Add content
      • 1.41 Usage figures
      • 1.42 Config Editor
      • 1.43 Proxy
      • 1.44 ActiveMQ
      • 1.45 Developer
      • 1.46 External Ressources
    • 2. Goobi viewer Indexer
      • 2.1 Main configuration
      • 2.2 Directories
      • 2.3 Proxy
      • 2.4 Performance
      • 2.5 Structure types
      • 2.6 Metadata
      • 2.7 Starting and Exiting
      • 2.8 Indexing records
      • 2.9 Updating individual page documents
      • 2.10 Deleting records
      • 2.11 Solr scheme
      • 2.12 Further settings
    • 3. Goobi viewer Connector
      • 3.1 OAI interface
        • 3.1.1 Main Configuration
        • 3.1.2 Dublin Core
        • 3.1.3 Europeana
        • 3.1.4 METS
        • 3.1.5 LIDO
        • 3.1.6 MARCXML
        • 3.1.7 Xepicur
        • 3.1.8 Goobi viewer overview pages
        • 3.1.9 Goobi viewer crowdsourcing
        • 3.1.10 TEI
        • 3.1.11 CMDI
        • 3.1.12 Sets
      • 3.2 SRU interface
  • User interface
    • 1. Frontend
    • 2. Backend
      • 2.1 Dashboard
      • 2.2 Administration
        • 2.2.1 User
        • 2.2.2 Groups
        • 2.2.3 IP-Ranges
        • 2.2.4 Access licenses
        • 2.2.5 Rights
        • 2.2.6 Comments
        • 2.2.7 Terms of use
        • 2.2.8 New record
      • 2.3 Crowdsourcing
        • 2.3.1 Campaigns
        • 2.3.2 Annotations
      • 2.4 CMS
        • 2.4.1 Pages
        • 2.4.2 Categories
        • 2.4.3 Static pages
        • 2.4.4 Media
        • 5.4.5 Menus
        • 5.4.6 Collections
        • 5.4.7 Maps
  • Misc
    • 1. Use cases
      • 1.1 Series and convolutes
      • 1.2 Access restrictions
      • 1.3 Subthemes
      • 1.4 Authority data
      • 1.5 Multilingualism
      • 1.6 Maps
      • 1.7 Sub collections
      • 1.8 Multiple Goobi viewer
      • 1.9 Crowdsourcing module
      • 1.10 Archival documents
      • 1.11 Solr Queries
      • 1.12 Linking from METS file groups
      • 1.13 Add content
      • 1.14 Shibboleth
      • 1.15 Access restricted metadata
    • 2. FAQ
    • 3. Glossary
  • Devs & Ops
    • 1. Core Changelog
    • 2. Theme Changelog
    • 3. Installation guide
      • 3.1 Classical
      • 3.2 Docker
    • 4. Development environment
    • 5. API
    • 6. Explained!
Powered by GitBook
On this page

Was this helpful?

  1. Configuration
  2. 1. Goobi viewer Core

1.23 Sidebar

The following elements switch links in the sidebar to the different types of record view on or off :

<sidebar>
    <page enabled="true" />
    <toc enabled="true" />
    <thumbs enabled="true" />
    <searchInItem enabled="true" />
    <metadata enabled="true" />
    <fulltext enabled="true" />
    <opac enabled="false" />
    <sidebarBrowsingTerms enabled="true" />
    <sidebarRssFeed enabled="true" />
    <sidebarWidgetUsage enabled="true">
        <page>
            <downloadOptions enabled="true">
                <option label="label__download_option_preview_150" format="jpg" boxSizeInPixel="150" />
                <option label="label__download_option_small_1024" format="jpg" boxSizeInPixel="1024" />
                <option label="label__download_option_medium_2048" format="jpg" boxSizeInPixel="2048" />
                <option label="label__download_option_large_4096" format="jpg" boxSizeInPixel="4096" />
                <option label="Master" format="MASTER" boxSizeInPixel="max"/>
            </downloadOptions>
        </page>
        <citationLinks enabled="true">
            <links>
                <link type="URL" for="record" label="URN" field="URN" prefix="https://nbn-resolving.org/" />
                <link type="URL" for="record" label="Handle" field="MD_PI_HANDLE" prefix="https://hdl.handle.net/" />
                <link type="URL" for="record" label="DOI" field="MD_PI_DOI" prefix="https://doi.org/" />
                <link type="URL" for="record" label="PURL" field="MD_PURL_IAI" />
                <link type="URL" for="record" label="RIS" action="download" pattern="{rest-api-url}records/{PI}/ris/"/>
                <link type="URL" for="image"  label="DOI" field="MD_PI_DOI" prefix="https://doi.org/" suffix="#?page=" appendImageNumberToSuffix="true" />
                <link type="URL" for="image"  label="URN" field="IMAGEURN" prefix="https://nbn-resolving.org/" />
                <link type="URL" for="image"  label="URN" field="URN" prefix="https://nbn-resolving.org/" suffix="/fragment/page=" topstructValueFallback="true" appendImageNumberToSuffix="true" />
                <link type="INTERNAL" for="record" label="LABEL_VIEWER_PURL" />
                <link type="INTERNAL" for="docstruct" label="LABEL_VIEWER_PURL" />
                <link type="INTERNAL" for="image" label="LABEL_VIEWER_PURL" />
            </links>
        </citationLinks>
        <citationRecommendation enabled="true">
            <styles>
                <style>modern-language-association-7th-edition</style>
                <style>apa-6th-edition</style>
                <style>chicago-author-date-16th-edition</style>
                <style>harvard-cite-them-right-no-et-al</style>
                <style>oscola</style>
            </styles>
            <source>
                <metadata label="MD_CITATION" value="MASTERVALUE_CITATION">
                    <param type="citeproc" dest="title" key="MD_TITLE" />
                    <param type="citeproc" dest="author" key="MD_CREATOR" />
                    <param type="citeproc" dest="publisher" key="MD_PUBLISHER" />
                    <param type="citeproc" dest="placepublish" key="MD_PLACEPUBLISH"/>
                    <param type="citeproc" dest="issued" key="MD_YEARPUBLISH" />
                    <param type="citeproc" dest="isbn" key="MD_ISBN"/>
                </metadata>
            </source>
        </citationRecommendation>
    </sidebarWidgetUsage>
    <sidebarWidgetDownloads enabled="true">
        <hideFileRegex>(EXAMPLE_.*|HIDDEN_.*)</hideFileRegex>
    </sidebarWidgetDownloads>
    <copyrightIndicator enabled="true" style="widget">
        <status field="ACCESSCONDITION">
            <value content="OPENACCESS" status="OPEN" description="COPYRIGHT_DESCRIPTION_STATUS_OPEN" />
            <value content="PDFLOCKED" status="PARTIAL" description="COPYRIGHT_DESCRIPTION_STATUS_PDFLOCKED" />
        </status>
        <license field="MD_USEANDREPRODUCTIONLICENSE">
            <value content="CC0 1.0 Universal (CC0 1.0) Public Domain Dedication" description="COPYRIGHT_DESCRIPTION_LICENSE_CC010">
                <icon>cc.svg</icon>
                <icon>zero.svg</icon>
            </value>
            <value content="In Copyright 1.0" description="COPYRIGHT_DESCRIPTION_LICENSE_RSINC10">
                <icon>rs-inc.svg</icon>
            </value>
        </license>
    </copyrightIndicator>
</sidebar>

Setting

Description

page/@enabled

Image-/Video-/Audio

toc/@enabled

Visibility of the link to the table of contents in the factory navigation. Attention: this is not the sidebar table of contents, for this see sidebarToc.

thumbs/@enabled

Page preview (Thumbnails)

searchInItem/@enabled

Search in record

metadata/@enabled

Metadata / Bibliographic data

If this switch is deactivated, the entire widget is not rendered.

fulltext/@enabled

Fulltext

opac/@enabled

Displays an additional link to catalogue. The default value is false

sidebarBrowsingTerms/@enabled

Show or hide the browsing widget. The default value is true

sidebarRssFeed/@enabled

Show or hide the RSS feed widget. The default value is true

sidebarWidgetUsage/@enabled

Show or hide the widget. The default value is true

sidebarWidgetUsage/page/downloadOptions/@enabled

Shows or hides the download options. Default value is true.

sidebarWidgetUsage/page/downloadOptions/option

List of entries to be made available for download.

  • The label attribute contains a message key.

  • The format attribute specifies the file format. This must be a format supported by the IIIF Image API. The static string MASTER is automatically translated into the image format of the master image.

  • The attribute boxSizeInPixel contains a value in pixels. A square is created from this. The Goobi viewer then scales the image - keeping the aspect ratio - into the specified box and displays the real size in pixels in the download popover.

sidebarWidgetUsage/citationLinks/@enabled

Shows or hides the area. The default value is true.

sidebarWidgetUsage/citationLinks/links/link

List of entries to be displayed as citation links.

  • type: can take the value URL if a link is to be built, or INTERNAL to use the internal URL built by the Goobi viewer.

  • for: can contain the values record, docstruct or image and defines for which range the citation link is valid.

  • label: contains the message key for the name of the displayed citation link.

  • field: defines the solr field from which the value for the citation link should come. It is only evaluated for type="URL".

  • prefix: contains the part of the URL that comes before the value from the solr field. It is only evaluated for type="URL".

  • suffix: contains the part of the URL that comes after the value from the solr field. It is only evaluated for type="URL".

  • topstructValueFallback: if true the value of the main element is taken from the Solr index even if for="docstruct" or for="image" is set. Default value is false.

  • appendImageNumberToSuffix: If true the image number will be appended to the suffix. Default value is false.

sidebarWidgetUsage/citationRecommendation/@enabled

Shows or hides the area. The default value is true.

sidebarWidgetUsage/citationRecommendation/styles

Contains the list of Citeproc citation styles to be offered in the dropdown menu.

sidebarWidgetUsage/citationRecommendation/source/metadata

Contains the mapping from the Solr fields to the Citeproc values.

sidebarWidgetDownloads/@enabled

Show or hide the widget. The default value is true

sidebarWidgetDownlads/hideFileRegex

If a regular expression is defined, files that match it are hidden in the widget. This is a purely visual option, the download of the files is still possible.

copyrightIndicator/@enabled

Enables or disables the display of the functionality. Default value is true.

copyrightIndicator/@style

Defines the places where the information is displayed. Possible values are widget and trafficlight. The widget is displayed in the sidebar. The traffic light is displayed next to the title of the record. The default value is widget.

copyrightIndicator/status/@field

Defines the Solr field containing the access restriction information. Default value is ACCESSCONDITION

copyrightIndicator/status/value/@content

Specifies the content of the defined field for which the setting is to apply.

copyrightIndicator/status/value/@status

Sets the status for the content. Possible values are OPEN, PARTIAL and LOCKED. If the widget is displayed, the status OPEN is visualised as an open lock and PARTIAL and LOCKED as a closed lock. Otherwise the status is displayed in the traffic light colours OPEN=green, PARTIAL=yellow and LOCKED=red.

copyrightIndicator/status/value/@description

Sets the message key by further describing the access restriction.

copyrightIndicator/license/@field

Defines the Solr field in which the information about the usage licence is located. The default value is MD_USEANDREPRODUCTIONLICENSE.

copyrightIndicator/license/value/@content

Specifies the content of the defined field for which the setting is to apply.

copyrightIndicator/license/value/@description

Sets the message key by further describing the licence of use.

copyrightIndicator/license/value/icon

Repeatable entry that lists the names of the files that are to be used to represent the licence of use. The files are located in the theme or core in the images/licence/ folder.

Previous1.22 ResolverNext1.24 Navigation and display

Last updated 3 months ago

Was this helpful?

Within this section, the sidebar table of contents is also configured in the configuration file. Due to its thematic proximity, it is described in .

The download for original content is also described here. Historically, this is still described in c.

chapter 1.20.2
hapter 2.30