-
Notifications
You must be signed in to change notification settings - Fork 9
Thoth_Works
A Work is a unit of publication with at least one unique identifier.
The Works page will display the Works the current user has access to. The following information is displayed:
Column Name | Content |
---|---|
ID | Unique primary key (UUID) |
Title | Title |
Type | Type |
Contributors | List of comma-separated contributors |
DOI | DOI |
Publisher | Publisher |
UpdatedAt | Date/time of most recent update |
Clicking on any record allows you to edit it. Save the record by clicking Save.
Mandatory
Select the type of the work from the dropdown list:
Not all fields are available for all Work Types. Non-available fields are greyed out.
Mandatory
- Forthcoming: The work is in progress and is expected to be published. This is the typical status for a work that has not yet been released but is planned for publication.
- Active: The work is published and currently available. This status indicates that the work is officially released.
- Withdrawn: The work has been withdrawn from publication and will be removed from all distribution channels. This status indicates that the work is no longer available for sale or distribution and will no longer be accessible.
-
Superseded: The work has been replaced by a new edition, with the previous edition now considered outdated. The two editions should be linked using a WorkRelation of type
REPLACES
/IS_REPLACED_BY
. - Postponed Indefinitely: The work’s release has been delayed indefinitely. It may be resumed at a later time, but currently, no publication date is set.
- Cancelled: The work has been permanently cancelled and will not be published.
graph TD;
FORTHCOMING -->|Postponed Indefinitely| POSTPONED_INDEFINITELY;
POSTPONED_INDEFINITELY -.->|Resumed| FORTHCOMING;
FORTHCOMING -->|Cancelled| CANCELLED;
FORTHCOMING -->|Published| ACTIVE;
ACTIVE -.->|Require removal| WITHDRAWN;
ACTIVE -.->|New edition| SUPERSEDED;
Mandatory
Select the Imprint from the dropdown list.
Mandatory
The title of the Work.
The subtitle of the Work.
An edition of a particular work usually encompasses all copies of the work that contain the same content, and (most often) which have been produced by the same publisher. Publisher identification of a specified or distinct edition may be due to changes in content (addition, revision, or removal of content) or may identify products produced for a specific market. It is important to note that some editions, such as second, abridged, or annotated editions, may be new works entirely; others may contain the same content but be classified as a different edition, such as a large print edition.
(BISG, Revised Best Practices for Book Metadata, 93)
👀 Numbered editions: Please use "1" for the initial edition of a Work, even if subsequent editions are not planned.
[>>> REVISIT] Named editions: [ONIX list 21?]
Recommended
The date of publication in the format dd/mm/yyyy
.
recommended
The place of publication.
Recommended
URL of the cover image.
Recommended
Caption referring to the cover image.
Recommended if available
Digital Object Identifier of the Work. In case no DOI is available, we recommend provision of the work's URL via the Landing Page field (see below).
Optional
The Library of Congress Control Number of the Work. Only provide this if you already happen to have the information at hand. Not a requirement. Relevant primarily for US publishers.
Optional
The OCLC Number of the Work. Only provide this if you already happen to have the information at hand. Not a requirement. Relevant primarily for US publishers.
Optional
A reference to the Work used by the Publisher internally.
Recommended
Total number of pages. In most cases, unnumbered pages (e.g., endpapers) should be omitted from this count. (Unnumbered pages that are part of plate sections/inserts are part of the book’s content and should be counted.) Books that have pages numbered in both roman and Arabic numerals (and no inserts) should have a Page Count that reflects the sum of the highest number of the roman-numbered pages plus the highest number of the Arabic-numbered pages. This value is therefore not necessarily the total number of pages bound into the book – there may for example be blank leaves at the back_. The sole exception to this is the case of a book with no numbered pages; in such a case the value given for Page Count should be the total number of all pages in the book.
For multi-volume books sold under a single Product Identifier, enter the total for all the volumes combined in the product record for the multi-volume product. If the individual volumes are sold separately, each of their product records should carry a Page Count for only the volume in question.
Example
Using The Chicago Manual of Style, 14th edition as an example, one sees that the front matter is numbered in roman numerals up to page ix. The main body of the work has pages numbered in Arabic numerals up to page 921. The book also contains five unnumbered pages at its end and both a front and a back flyleaf. For the purposes of these best practices guidelines, the Page Count sent out for this book should be 930 (the sum of the highest number of the roman-numbered pages, 9, plus the highest number of the Arabic-numbered pages, 921).
(BISG, Revised Best Practices for Book Metadata, 104)
Optional
Breakdown of Total number of pages in frontmatter, main, and backmatter.
Recommended for Chapters
Only relevant for the Work type Book Chapter: First page of the chapter.
Recommended for Chapters
Only relevant for the Work type Book Chapter: Last page of the chapter.
Optional
Total number of images.
Optional
Total number of tables.
Optional
Total number of audio fragments.
Optional
Total number of video fragments.
Mandatory
URL of the license which applies to this work (frequently a Creative Commons license for open-access works).
Mandatory
Copyright holder of the work.
Recommended
URL of the web page of the work.
Recommended
Abstract of the work. Where a work has only one abstract, it should be entered here, and Short Abstract
can be left blank. Long Abstract is output in metadata formats, and Short Abstract is not.
Optional
Short abstract of the work. Where a work has two different versions of the abstract, the truncated version should be entered here. Otherwise, it can be left blank. This field is not output in metadata formats; where relevant, Long Abstract
is used instead.
Optional
A general-purpose field used to include information that does not have a specific designated field. In MARC records, it corresponds to field 500.
Examples of general notes: "Previous edition: 2017.", "Links to additional resources are available from the publisher's website.", "Please note that in this book the mathematical formulas are encoded in MathML.".
Optional
Indicates that the work contains a bibliography or other similar information. In MARC records, it corresponds to field 504.
An example of a bibliography note is: "Includes bibliography (pages 289-321) and index.".
Optional
Table of content of the work.
Optional
This section allows the addition of a related Work, such as a Book Chapter to an Edited book. Start by searching for an existing Related Work, and if it does not exist in that list, create a new entry.
Recommended
Select the Relation Type from the dropdown list:
- Replaces
- Has Translation
- Has Part
- Has Child
- Is Replaced By
- Is Translation Of
- Is Part Of
- Is Child Of
Relation Types are symmetrical. The converse Relation Type is added to the selected Related Work.
Required if Related Work has been added
Integer determining the order in which Related Works are listed, start with 1
. For Relation Types which have explicit numbering systems (e.g. "chapter number" for Is Child), the Relation Ordinals used here do not need to correspond to them.
Recommended if Related Work has been added
Contributors need to first be recorded in a dedicated Contributor record. Once this has been done, come back to this view and use the searchbar to find a Contributor. The Contributor's Given Name, Contributor's Family Name, and Contributor's Full Name are bein pulled from the Contributor record.
👀 Note: Once the Contributor record has been loaded, it is possible to edit this entry to reflect the contributor's choice of name at the point of publication. To provide an example, a Contributor with full name of John W. H. Smith could choose to be credited as John Smith. The Thoth database will store this variation together with a link to the central Contributor record.
Required if Contribution has been added
Select the contribution type from the dropdown list:
- Author
- Editor
- Translator
- Photographer
- Illustrator
- Music Editor
- Foreword by
- Introduction by
- Afterword by
- Preface by
- Software by
- Research by
- Contributions by
- Indexer
In case the Work
is an Edited Book
, do not add chapter contributors as Authors. Chapter contributors are to be recorded on the individual chapter level via the chapters listed under Related Works.
Recommended
The biography of the contributor at the time of contribution.
Recommended
Select Yes
or No
from the dropdown list to indicate whether the contribution is a main contribution to the Work. Main contributions are listed as such on the Catalogue page.
To provide good practice examples, in the case of a Monograph
, one would mark the Main Author(s) of that monograph with Yes
, while contributions such as prefaces, forewords, introductions, would be marked with No
.
With Edited Collections, the Editors of said collection would be listed on the book-level entry and marked with Yes
, while contributions such as prefaces, introductions, concludions would be recorded on the chapter level via Related Works, and marked with No
. Contributions by authors of full chapters will be recorded on the chapter level via Related Works, and marked with Yes
.
Required if Contribution has been added
Integer determining the order in which contributions are listed, start with 1
.
Once a Contribution has been entered, you can also add one or more Institutional Affiliations per Contribution. As with Funders (see below) Affiliations are drawn from the Institutions table. Search for the Institution affiliated with the Contribution, to which you can also add a Position and Affiliation Ordinal, which determines the order in which the affiliations are listed.
Recommended
The Institution affiliated with the contributor at the moment of contribution. Search for the institution in the search bar and select it. In the rare case of an institution not being listed, it is best to keep the field empty (no additional free text input available). Optional: Check with the Thoth development team (via info@thoth.pub) to see if an update of the underlying ROR database might be necessary, or if there are other ways for them to include the missing institution in the list.
Optional
Optionally, add the position of the Contributor at the Institution at the moment of contribution (free-text input). Examples: "Associate Professor", "Researcher in the Social Systems department", etc.
Required if Institution has been added
Integer determining the order in which affiliations are listed, start with 1
.
By cicking Edit
, contributor details can be edited.
By clicking Remove
, contributions can be removed.
Optional; recommended for book-level entries
Publications are separate instances of a single work. Click Add Publication to add a new publication. Click View to view any Publication record, and add a price.
Select the publication type from the dropdown list:
- Paperback
- Hardback
- HTML
- XML
- Epub
- Mobi
- AZW3
- DOCX
- FictionBook
Recommended
The ISBN of the publication. Only ISBN-13s are accepted.
recommended, only applicable in case of Paperback and Hardback publication type
Measurement perpendicular to the spine of the book. Automatically converted from in to mm or vice versa if the conversion box is ticked.
recommended, only applicable in case of Paperback and Hardback publication type
Measurement along the spine of the book. Automatically converted from in to mm or vice versa if the conversion box is ticked.
recommended, only applicable in case of Paperback and Hardback publication type
Measurement of the thickness of the spine of the book. Automatically converted from in to mm or vice versa if the conversion box is ticked.
recommended, only applicable in case of Paperback and Hardback publication type
Weight of the book. Automatically converted from oz to g or vice versa if the conversion box is ticked.
By cicking Edit
, publication details can be edited.
By clicking View
, Locations and Prices can be added via the Publications page.
By clicking Remove
, publications can be removed.
Recommended
Click Add Language
to add a new language.
Select the language code from a dropdown list. See ISO 639-3 for full list of language codes.
Select the language relation from a dropdown list.
- Original
- Translated from
- Translated into
Select whether the language is the main language of the work from a dropdown list.
Recommended on book-level entries, Optional for chapter-level
Click Add Subject to add a new subject.
Select the subject type from a dropdown list:
In case of BIC, BISAC, Thema, LCC, and Custom, add the appropriate subject code.
Keywords are words or phrases that describe content. In the context of structured metadata, keywords are not necessarily part of a controlled vocabulary of subject terms (such as BISAC Subject Headings, Thema or BIC Subject Classifications, or Library of Congress Subject Headings); instead, they are words or phrases assigned by the metadata creator in anticipation of ways in which the end user might search for content.
Although optional, and not a substitute for a controlled subject schema such as the BISAC and Thema systems, keywords can be transmitted in ONIX and provide an additional data point for search results and for data analysis via search engine algorithms.
For fiction, important keywords might include character names, locations, genre words. For non-fiction, key personal names and terms of art from the subject matter. You need not include words already used within the BISAC, BIC or Thema subject schemes.
Additional information about keywords can be found in the BISG Best Practices for Keywords in Metadata. [BISG, Revised Best Practices for Book Metadata, 110]
👀 Note: BIC, BISAC, and LCC are all legacy classifications that are no longer properly maintained and are copyright-protected. Only Thema is consistently maintained, has the widest collection of categories, and is open. Hence, Thoth recommends focusing on Thema and BISAC classifications.
LCC will be generated by the Library of Congress, and BIC has become obsolete as of Feb 2024. For BISAC, there is a BISAC-to-Thema translator available (email registration required), courtesy to the Booknet Canada. To map back from Thema to BISAC (which is a required classification by e.g. JSTOR), the official reverse Mapping from BISAC 2022 to Thema v.1.5 XLS might be useful, as provided by EDItEUR.
Required if Subject has been added
Integer determining the order codes or keywords. Ordinals increase per Subject Code type.
Optional, relevant to Series
Use the searchbar to find a Series belonging to the Imprint under which the Work is published.
Integer determining the order in which Works in the same Series are listed. If the Series has explicit "issue numbers", the Issue Ordinals used here do not need to correspond to those.
Optional, recommended where available
Use the searchbar to find a funding Institution
The name of the funding program.
The name of the project.
The short name of the project.
The grant number of the project.
The jurisdiction of the project.
The Thoth Wiki has been developed in the context of the COPIM (Community-led Open Publication Infrastructures for Monographs) project. Individual contributions to the wiki have been made by Tim Elfenbein, Joanne Fitzpatrick, Rupert Gatti, Ross Higman, Hannah Hillen, Brendan O'Connell, Tobias Steiner, and Vincent W.J. van Gerven Oei under the general editorship of Van Gerven Oei. All data are available under a CC-BY 4.0 license.