Skip to content
WKocur edited this page Jun 2, 2020 · 12 revisions

Identification Materials

Identification materials consist of ID Manual entries and Additional Materials. These are accessible via:

Site Section ID Manual Additional Materials
Species+ Species page yes yes
Species+ Document search no no
Checklist Taxon list item yes yes
Checklist Main download yes no
Checklist Volume downloads yes no

ID Materials have an event type of IdMaterials and document type of Document::VirtualCollege or Document::IdManual.

They have a boolean attribute generalSubType:

true = Whole animals/plants

false = Parts and derivatives.

Species+

Meeting is shown as blank and the date only shows a year (no day or month)

ID Materials are ordered with exact matches to the searched taxon (or selected if on a species page) first. Afterwards remaining entries are ordered from kingdom to to sub-species level tags.

Cascading

If you search for a taxon concept or are on a species page, the following cascading applies:

Show documents tagged with any search matches and their descendants Show documents tagged with ancestors only for exact matches (this prevents matches for Canis such as Aloe Canis cascading up to Plantae and showing Plantae docs for a Canis search, but a Canis Lupus search would cascade up to Animalia)

Checklist+

Links are provided to additional materials.

ID manual entries are stitched together (as pdfs) to produce a single download for a given taxon concept or search term. A cover page is added to a download based on the search term. This is written in css and html and converted to a pdf using pdfkit. The css is very limited and hard to use - be careful when editing.

The full ID Manual volumes can be downloaded via a modal accessed by a button on the right hand side of the page. These are stored in their entirety on the server. If multiple volumes are selected, these are zipped together. Stitching takes too long.

When stitching, the order of taxa matches the order show in the listing download. PDFs are selected for the current locale (language selected for the interface). If no locale ID Manual PDF is present, we fall back to an English version. If English is not present, the entry is omitted.

Cascading

For ID Manual entries downloaded via a specific taxon concept list item:

Show all documents tagged with the taxon concept or any of its descendants

For Additional Materials shown under a specific taxon concept list item: All materials tagged as the given taxon concept, one of its ancestors or one of its descendants will be shown

For ID Manual entries downloaded by the search-level download:

Show all documents tagged with any matches or any of their descendants