New versions of this module and support for Omeka S version 3.0 and above are available on GitLab, which seems to respect users and privacy better than the previous repository.
Bibliography is a module for Omeka S that adds features to manage a bibliography with standard citations, reference lists, suggested values, and collected records from doi, isbn and other identifiers.
The module adds basic output for some bibliographic formats for the module Bulk Export too.
The doi and the issn are retrieved from the open service of crossref (a free registration allows to get a better performance for service). The isbn, the oclc, the lccn, and the olid are retrieved through the OpenLibrary api from Internet Archive.
This optional module Generic may be installed first.
To use suggesters, it is required to use this version of Value Suggest, that contains all patchs, not yet integrated upstream. For the same reason, it is required to use this version of Collecting to create a collecting form with suggesters. To output resources in admin or public side, the module Bulk Export should be installed.
The module uses external libraries, so use the release zip to install it, or use and init the source.
See general end user documentation for installing a module.
Download the last release Bibliography.zip from the list of releases (the
master does not contain the dependency), and uncompress it in the modules
directory.
If the module was installed from the source, rename the name of the folder of
the module to Bibliography, go to the root of the module, and run:
composer install --no-devIf you used the module Citation, it is automatically uninstalled: its features are the same and improved in this module.
The ontology FaBiO uses external ontologies for some classes and properties, mainly the Dublin Core and Prism, and some others like FRBR. For easier management, these related ontologies are not installed automatically, because generally, the elements they uses are rare or can be replaced by the bibo ones.
Once the specific version of Value Suggest is installed, the following identifiers can be requested:
In the config of the resource template or the collecting form, some items above can be requested with different values. It allows to choose between a large query with keywords, or a strict query with the id. It allows to set the label too, that can be a name or an id according to properties, for example the title or the article for dcterms:title, but the id for bibo:doi, or even the full reference for dcterms:bibliographicCitation, or even the full record as a resource.
The citation can be displayed with any managed citation style, in any of the managed languages.
Remarks on the metadata:
The citation is automatically added to the item/show page. You can have a better control on the display with module Blocks Disposition or direct edition of the theme.
To insert a citation in the theme, add this anywhere in any partial:
echo $this->citation($resource, $options);Default options are:
style (string): the citation style (default to "chicago-fullnote-bibliography").locale (string): the locale for the citation (default to "en-US"). The
language and the country are separated with "-", not "_".defaults (array): The default values to use when a property is not set. It
is mainly used for own specific items to set the creator, the date, and the
publisher of own specific records.append_site (boolean): to append the site or not.append_date (boolean): to append the access date.bibliographic (boolean): if true, set append_site and append_date false.mode (string): how to display the citation (option used to display it
differently in various contexts). Default managed values are "list" and
"single" (default). It may avoid to use a specific partial.template (string): partial to use for display, default is common/citation.
currently).The default options are used for Omeka resources. You may unset options to append the site and the access date for real bibliographic resources. Any other option is passed to template.
The result can be customized via the template common/citation in view/.
Use it at your own risk.
It’s always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed.
See online issues on the module issues page on GitLab.
This module is published under the CeCILL v2.1 license, compatible with GNU/GPL and approved by FSF and OSI.
In consideration of access to the source code and the rights to copy, modify and redistribute granted by the license, users are provided only with a limited warranty and the software’s author, the holder of the economic rights, and the successive licensors only have limited liability.
In this respect, the risks associated with loading, using, modifying and/or developing or reproducing the software by the user are brought to the user’s attention, given its Free Software status, which may make it complicated to use, with the result that its use is reserved for developers and experienced professionals having in-depth computer knowledge. Users are therefore encouraged to load and test the suitability of the software as regards their requirements in conditions enabling the security of their systems and/or data to be ensured and, more generally, to use and operate it in the same conditions of security. This Agreement may be freely reproduced and published, provided it is not altered, and that no provisions are either added or removed herefrom.
First version of this module was built for Daniel Berthereau for Collegium Musicæ, of Sorbonne Université.