Skip to content

tdwg/ac

Repository files navigation

Audiovisual Core (AC)

This is the main entry point to the work of the Audiovisual Core Maintenance Group. If you are looking for the landing page of the standard itself, go to https://www.tdwg.org/standards/ac/. To find the website containing the standards documents, go to https://ac.tdwg.org/.

The Audiovisual Core (AC), previously known as Audubon Core, is a set of vocabularies designed to represent metadata for biodiversity multimedia resources and collections. These vocabularies aim to represent information that will help to determine whether a particular resource or collection will be fit for some particular biodiversity science application before acquiring the media. Among others, the vocabularies address such concerns as the management of the media and collections, descriptions of their content, their taxonomic, geographic, and temporal coverage, and the appropriate ways to retrieve, attribute and reproduce them.

The current release (2022-02-23) is archived at DOI

The Audiovisual Core Maintenance Group

Audiovisual Core is maintained by a specialized Interest Group whose charter was approved in January 2018. The functions of the Audiovisual Core Maintenance Group are described in detail in Section 2 of the TDWG Vocabulary Maintenance Specification. In brief, the Maintenance Group manages vocabulary term additions and changes, and maintains the documentation that helps users to understand and apply the standard. As an Interest Group, it may establish Task Groups to accomplish broader changes to the standard. The Maintenance Group generally meets on the third Wednesday of the month.

Core Members of the AC Maintenance Group

Currently, core members of the group are:

Ed Baker - Natural History Museum, London, UK (Convener) - edward.baker@nhm.ac.uk

Vijay Barve - Natural History Museum of Los Angeles vbarve@nhm.org

Steve Baskauf - Vanderbilt University Jean & Alexander Heard Library (retired) - steve.baskauf@gmail.com

Douglas Boyer - Department of Evolutionary Anthropology, Duke University, Director of MorphoSource open access 3D repository - douglasmb@gmail.com

Niels Klazenga - Royal Botanic Gardens Victoria - Niels.Klazenga@rbg.vic.gov.au

Rebecca Snyder - Smithsonian Institution, National Museum of Natural History - SNYDERR@si.edu

Dan Stowell - Tilburg University and Naturalis Biodiversity Centre - dstowell@tilburguniversity.edu

Jocelyn Triplett - Duke University, MorphoSource.org - jocelyn.triplett@duke.edu

Kate Webbink - Field Museum of Natural History - kwebbink@fieldmuseum.org

To see all of the people who are paying attention to our work, see the list of "watchers". The people on this list are effectively the "regular members" of the group.

The Maintenance Group would like to recognize Robert A. Morris who passed away in 2021. Bob can be considered the "father of Audiovisual Core" and led the task group through the development and process of ratifying of the standard. Thanks, Bob, for your vision and leadership!

Task Groups

In the TDWG Process for creating and modifying standards, Task Groups are formed to create particular deliverables of interest to an Interest Group. As an Interest Group, the Audiovisual Core Maintenance Group periodically establishes Task Groups.

We have chartered a 3D Imagery and Data Task Group (3DTG) to look at possible additions to Audiovisual Core for describing 3D images. For more information, see the Task Group's home page. If you are interested in the work of this group, contact its convener, Doug Boyer.

We have also chartered a Views Controlled Vocabularies task group to create controlled vocabularies for ac:subjectPart and ac:subjectOrientation. For more information, see the Task Group's home page. If you are interested in the work of this group, contact its convener, Steve Baskauf.

Participating in the Maintenance Group

If you would like to participate in this group, contact the convener or one of the core members.

To participate in the communication system of the group, "watch" the group's Issues tracker. This issues tracker is the mechanism for suggesting specific changes to the standard as well as to raise issues for discussion by the group.

Maintenance Group Meetings

The Maintenance Group meets via Zoom, usually at 17:00 UTC, on the third Wednesday of the month. These meetings are open to anyone interested in joining; please contact the convenor for the Zoom link. Next meeting agenda.

Policies

Policies established by the Maintenance Group are listed here. Please note that the policy document is not included with the Audiovisual Core Standard and is therefore not subject to any standards-related processes requiring public comment, Executive Committee approval, etc. Rather, the policies are established through consensus of the Maintenance Group, in consultation (when necessary) with the Technical Architecture Group.

Documentation

Examples guide for Still Images

stub Examples guide for Sound

Regions of Interest (ROI) recipes document

To see what issues we are currently addressing, see our Issue Tracker.

For notes of Maintenance group meetings and other historical documents, see this page. To see what we've been working on in the past, see the list of closed issues

For the details of most of the documents in this repo, see the diagram below.

Term and website translation

For users

The Audiovisual Core website is available in multiple languages, see the "文A" menu.

Translations in machine-readable format are in the rs.tdwg.org repository, you will need several files:

For translators

Translations are managed within Crowdin, which makes it easy to keep up with any changes to Darwin Core. If you wish to contribute please go to the Crowdin project and request to join, then email the Audiovisual Core Maintenance Group.

The Crowdin project has two sections:

  • [tdwg.rs.tdwg.org] translations – this contains term definitions for several standards. Audiovisual Core's definitions are labelled "Audiovisual Core", corresponding to the list of files just above.
  • [tdwg.ac] master — this contains the website, such as the home page, navigation menu, and the text surrounding the lists of terms.

Translating navigation.json first is recommended, as you will then be able to browse the preview site at https://ac-translation-preview.tdwg.org/.

To avoid conflicts, edits to translations should only be made in Crowdin.

For developers of this website

Translations of term data (labels, definitions, examples, comments) are retrieved from the rs.tdwg.org repository, see rs.tdwg.org/TRANSLATIONS.md for details on that process.

Translations of the rest of the Audiovisual Core website (guides, prose sections, navigation menu etc) is managed here. crowdin.yml configures files required for translation, and as content is translated Crowdin will create pull requests. The only manual edits required are for building a new language (configured at the top of build/build-website.py and, once the translation is ready, adding it to the end of the navigation menu.

GitHub Actions are configured to rebuild the website automatically as website/prose translations are created and updated. Changes are automatically deployed to https://ac-translation-preview.tdwg.org/, when the pull request is approved they will appear on https://ac.tdwg.org/. (Note if the navigation menu hasn't been translated it will be necessary to edit the URL to get to each page.)

Repo structure

The repository structure is described below.

├── README.md             : Description of this repository
├── license.md            : Repository license
├── policies.md           : Audiovisual Core maintenance policies
│
├── docs                  : Standards documents live here.  However, do not hyperlink to them here because they are rendered as HTML at https://tdwg.github.io/ac/.
│   ├── _config.yml       : Jekyll configuration file
│   ├── introduction.md   : Brief introduction to the standard
│   ├── structure.md      : Describes the structure of Audiovisual Core
│   ├── termlist.md       : AC Term List, including normative definitions. DO NOT EDIT MANUALLY!
│   ├── guide.md          : More detailed user guide
│   ├── 04_AudubonCore1.0NonNormative_docV1.95.doc     : version 1.95 of the reference guide
│   └── assets            : subdirectories contain stuff for Jekyll operation
│       └── images        : directory for images used in the documents
│
├── code
│   ├── build_page.py               : Build script to generate termlist.md
│   ├── http_library.py             : Function library used by build_page.py
│   ├── termlist-header.md          : Manually-edited header section to which the generated term list is appended
│   ├── termlist-footer.md          : Manually-edited footer section (currently empty) to be appended to the generated term list
│   └── pandoc-conversion-notes.txt : Notes on conversion from mediawiki
│
├── historical                         : Documents of historical interest
│   ├── README.md                      : Contents of this directory
│   ├── RecordOfPublicReview.md        : Summary of public comment period during the adoption of the standard
│   ├── ac-20yy-annual-report.md       : 20yy report to the Executive Committee
│   └── [yyyy-mm-dd]-hangout-notes.pdf : Series of downloaded Google Docs notes from online Maintenance Group meetings
│
├── 3D                                 : Directory to store documents related to proposed 3D task group
│   ├── README.md                      : Homepage of the 3D Imagery and Data Task Group (3DTG)
│   ├── charter_3d_task_group_of_audubon_core_2019-06-11.docx   : Word version of submitted charter
│   ├── charter_3d_task_group_of_audubon_core_2019-06-11.pdf    : PDF version of submitted charter
│   └── proposed-3d-metadata-terms-from-dwc-hour.csv            : notes from Darwin Core hour
│
├── views                              : Directory to store documents related to proposed 3D task group
│   ├── README.md                      : Homepage of the Views Controlled Vocabularies Task Group
│   ├── views-tg-draft-charter-2019-06-25.docx                  : Word version of submitted charter
│   ├── views-tg-draft-charter-2019-06-25.docx.pdf              : PDF version of submitted charter
│   └── background.md                  : background notes
│
└── .gitignore                : Files and directories to be ignored by git

Revised 2022-05-28