All Versions


DSpace Documentation


Page tree

Old Release

This documentation relates to an old version of DSpace, version 5.x. Looking for another version? See all documentation.

Skip to end of metadata
Go to start of metadata

Enabling PDF Cover Pages may affect your site's visibility in Google Scholar (and similar search engines)

Google Scholar specifically warns against automatically generating PDF Cover Pages, as they can break the metadata extraction techniques used by their search engine.  Be aware that enabling PDF Cover Pages may also cause those items to no longer be indexed by Google Scholar.  For more information, please see the "Indexing Repositories: Pitfalls and Best Practices" talk from Anurag Acharya (co-creator of Google Scholar) presented at the Open Repositories 2015 conference.

Adding a cover page to retrieved documents from DSpace that include additional citation information has been sought, as documents uploaded to the repository might have had their context stripped from them, when they are just a PDF. Context that might have surrounded the document would be the journal, publisher, edition, and more. Without that information, the document might just be a few pages of text, with no way to piece it together. Since repository policy might be to include this information as metadata to the Item, this metadata can be added to the citation cover page, so that the derivative PDF includes all of this information.

The citation cover page works by only storing the original PDF in DSpace, and then generating the citation-cover-page PDF on-the-fly. An alternative set up would be to run the PDF Citation Coverpage Curation Task on the DSpace repository contents, and then disseminate the pre-generated citation-version instead of generating it on the fly.

Screenshot of generated citation cover page

 

Configuration settings for Citation Cover Page

In the {dspace.dir}/config/modules/disseminate-citation.cfg file review the following fields to make sure they are uncommented:

Property:

enable_globally

Example Values:

enable_globally = true

Informational Note:

Boolean to determine is citation-functionality is enabled globally for entire site. This will enable the citation cover page generator for all PDFs.

Default: disabled


Property:

enabled_collections

Example Values:

enabled_collections = 1811/123, 1811/234

Informational Note:

List of collection handles to enable the cover page generator for bitstreams within.

Default: blank

Property:

enabled_communities

Example Values:

enabled_communities = 1811/222, 1811/333

Informational Note:

List of community handles to enable the cover page generator for bitstreams within.

Default: blank

Property:

citation_as_first_page

Example Values:

citation_as_first_page = true

Informational Note:

Should the citation page be the first page cover (true), or the last page (false).

Default: true, (first page)

Property:

header1

Example Values:

header1 = University of Higher Education

Informational Note:

First row of header, perhaps for institution / university name

Default: DSpace Institution

Property:

header2

Example Values:

header2 = Scholar Archive, http://archive.example.com

Informational Note:

Second row of header, perhaps put your DSpace instance branded name, and url to your DSpace. A comma is used to separate instance name, and the URL

Default: DSpace Repository, http://dspace.org

Property:

fields

Example Values:

fields = dc.date.issued, dc.title, dc.creator, dc.contributor.author, dc.publisher, _line_, dc.identifier.citation, dc.identifier.uri

Informational Note:

Metadata fields to display on the citation PDF. Specify in schema.element.qualifier form, and separate fields by a comma. If you want to have a horizontal line break, use _line_
Default: dc.date.issued,dc.title,dc.creator,dc.contributor.author,dc.publisher,_line_,dc.identifier.citation,dc.identifier.uri

Property:

footer

Example Values:

footer = Downloaded from Scholar Archive at University of Higher Education, an open access institutional repository. All Rights Reserved.

Informational Note:

Footer text at the bottom of the citation page. It might be some type of license or copyright information, or just letting the recipient know where they downloaded the file from.
Default: Downloaded from DSpace Repository, DSpace Institution's institutional repository

 

A known issue with the current implementation of the PDF Citation Cover Page is that primarily only English/Roman characters are supported. This is due to a limitation in the tool used to generate PDFs.

 

 

 

  • No labels

2 Comments

  1. Would it be possible to add that this feature is only available in XMLUI? (as per 5.0 release notes)

  2. I suspect if you put the cover page last (i.e., citation_as_first_page = false), it will avoid the problems with Google Scholar indexing.