dmp-references

Documark References

Documark plugin for listing references.

Usage

1. Load the references plugin in your document configuration:

   plugins:
     - dmp-references

2. Add a reference-list element to your document:

   h1 References
   reference-list

3. Use references throughout your document as explained below.

   They will be collected and added as to a ordered list (ol) that is appended to the reference-list element.

NOTE: Jade allows for dot and pipe syntax. References do not render properly when using the Jade dot syntax. So instead of using the following syntax, which does not render properly:

p.
    hello world!
    reference(reference-type="internet", ...)

You should use:

p
    | hello world!
    reference(reference-type="internet", ...)

APA rules

You can find the rules of the apa style guide here: https://owl.english.purdue.edu/owl/resource/560/02/. If someone believes to have found a better one, feel free to contact me!

Clicking on a title of a reference type, will lead you to the online style guide about that kind of reference type.

Reference types

The following types of references are supported:

• Internet
• Book
• Magazine
• Newspaper article
• Not published reference
• Online image

Source

There are different types of references. As of now not all types of references are supported yet. Below there is a list with all the supported types and how they should be used.

General structure

First of all, the general structure of a reference. A reference to a source has the following structure:

reference(
    reference-type="[reference-type]"
    [optional attributes])

The "optional attributes" are relative to the specific reference types. These types are below. There is no specific sequence needed when defining the optional attributes. For some optional attributes, there are also shorthands available.

Internet

Full example

reference(
    reference-type="internet"
    date-of-consultancy="13 februari 2015"
    document-title="Aandachtsgebieden"
    date-of-publishment="2013, september"
    author="Kindermans, M."
    url="https://www.tno.nl/nl/aandachtsgebieden/")

Optional attributes

Element	Attribute	Short	Description
Author:	author	auth	Name of the person who wrote this reference.
Date of publishment:	date-of-publishment	dop	Date when this reference was published.
Document title:	document-title	title	The title of the reference.
Date of consultancy:	date-of-consultancy	doc	The date when you consulted this reference.
Location of the reference:	url		The url to the internet source.

Book

Full example

reference(
    reference-type="book"
    author="Adriaansen, M. & Caris, J."
    date-of-publishment="2011"
    document-title="Elementaire sociale vaardigheden"
    edition="3e druk"
    location="Houten"
    publisher="Bohn Stafleu Van Loghum")

Optional attributes

Element	Attribute	Short	Description
Author:	author	auth	Name of the person who wrote this reference.
When the author and the editor are the same:	author-is-editor	editor	When the author and the editor are the same person, add the title of an editor in the same language as the title of the book to the attributes:
Date of publishment:	date-of-publishment	dop	Date when this reference was published.
Document title:	document-title	title	The title of the reference.
Edition:	edition	ed	It is possible to add the used edition, this will be appended to the title within brackets.
Publisher:	publisher	pub	The name of the publisher of this reference.
Location of publishment:	location	loc	The location where the reference was published.

Magazine

Full example

reference(
    reference-type="magazine-article"
    author="Ouwekerk, D. van, & Grinten, J. van der."
    date-of-publishment="2014"
    article-title="De kracht van zacht: Wat mannen over vrouwelijke vergaderstijlen kunnen leren"
    document-title="Interne Communicatie"
    volume="3"
    edition="4"
    page-numbers="11-13")

Optional attributes

Element	Attribute	Short	Description
Author:	author	auth	Name of the person who wrote this reference.
Date of publishment:	date-of-publishment	dop	Year when this reference was published.
Name of the magazine:	document-title	doc-title	The title of the magazine itself.
Title of this specific article:	article-title	art-title	The title of the article that is used.
Volume:	volume	vol	Volume of the magazine. In general this is the number of the year it is published.
Edition:	edition	ed	The edition of the magazine. In general this is the number of the edition in this volume (this year).
Page numbers:	page-numbers	p	Generally you are not using the whole magazine. So use this attribute to tell which pages are used.

Newspaper article

Full example

reference(
    reference-type="newspaper-article"
    author="Havelaar, R."
    date-of-publishment="2006, 13 december"
    article-title="Student leert minder uren omdat hij werkt"
    document-title="De Volkskrant"
    page-numbers="13")

Optional attributes

Element	Attribute	Short	Description
Author:	author	auth	Name of the person who wrote this reference.
Date of publishment:	date-of-publishment	dop	Year when this reference was published.
Name of the newspaper:	document-title	doc-title	The title of the magazine itself.
Title of this specific article:	article-title	art-title	The title of the article that is used.
Page numbers:	page-numbers	p	Generally you are not using the whole magazine. So use this attribute to tell which pages are used.

Not published reference

Full example

reference(
        reference-type="not-published"
        author="Drogendijk, A. N., et al."
        date-of-publishment="2004"
        document-title="Leidende en misleidende verwachtingen: Een kwalitatief onderzoek onder Turkse getroffenen van de vuurwerkramp Enschede omtrent de psychosociale nazorg"
        publisher="Instituut voor Psychotrauma")

Optional attributes

Element	Attribute	Short	Description
Author:	author	auth	Name of the person who wrote this reference.
Date of publishment:	date-of-publishment	dop	Year when this reference was published.
Name of the document:	document-title	title	The title of the publication.
Publisher:	publisher	pub	The name of the publisher of this reference.
Location of publishment:	location	title	The location where the reference was published.
Description of the document:	description	descr	Provide a description of the reference.

Online image

Full example

reference(
        reference-type="online-image"
        author="HAN."
        date-of-publishment="2011, 24 februari"
        document-title="Studenten vragen Pieter van den Hoogenband hemd van het lijf bij Topsportuur"
        date-of-consultancy="25 februari 2011"
        url="http://www.han.nl/gebied/sport-beweging/nieuws/nieuws/studenten-vragen-pieter-v/_images/hoogenband.jpg/large")

Optional attributes

Element	Attribute	Short	Description
Author:	author	auth	Name of the person who wrote this reference.
Date of publishment:	date-of-publishment	dop	Date when this reference was published.
Document title:	document-title	title	The title of the reference.
Date of consultancy:	date-of-consultancy	doc	The date when you consulted this reference.
Location of the reference:	url	url	The url to the internet source.

Output

The final HTML structure will look something like this:

At the place where the reference was made, so in your text, the following will be placed:

<sup>
    <a href="#reference-entry-[index]">[index]</a>
</sup>

At the place of the [index], there will be the index. So when e.g. this is the reference for the second index, it will look like this:

<sup>
    <a href="#reference-entry-2">2</a>
</sup>

At the place with the list of references, the final html will look something like this:

<reference-list>
    <ol>
        <li>
            <a class="reference-entry-style" name="reference-entry-1">[Reference 1 text]</a>
        </li>
        <li>
            <a class="reference-entry-style" name="reference-entry-2">[Reference 2 text]</a>
        </li>
        <li>
            <a class="reference-entry-style" name="reference-entry-3">[Reference 3 text]</a>
        </li>
    </ol>
</reference-list>