Introduction

Visual-Meta is an approach to add information about a document to the document on the same level of the content, same as would be necessary on a physically printed page, as opposed to as a data layer since this data layer can be lost and it makes it harder for a user to take advantage of this data.

The core data is information about the document to allow users to cite the document. This is based on the academic BibTex citation information format.

The only required fields are Description, Start, Introduction, Citing and End. Not all documents will have all the fields for every section and not all reader software will make use of all the information. This is simply our best effort to attach as much useful metadata in the most robust manner for future use.

Citing: The formatting of the BibTeX fields are described right after this section, in the @{citation-format-description-for-this-document} section. A key use of the citation information is when a user copies text from a PDF with Visual-Meta this citation information is included on the clipboard payload so that when the user pastes into a Visual-Meta aware program, such as a word processor, the text is pasted as a full citation which will automatically be included in the References on export. This is how the fields should be filled in:

• Required:

author = last name, followed by first name, followed by middle names; delimited by , and delimited by . between author names
title = plain text 
year = year of publication with 4 digits

• Optional:

date = ISO 8601 compliant. Date and time values are ordered from the largest to smallest unit of time: YYYY-MM-DD
location = city name followed by country name
location-city = city name
location-state = state name
location-county = county name
location-country = country name
keywords = plain text

The (optional) responseto is intended to specify what document this is in response to, as opposed to just citing, to help thread a dialogue.

The (optional) structural section is in JSON and describes what text is heading and who wrote what heading.

The way reader software looks for Visual-Meta in a PDF is to parse it from the end of the document and look for @visual-meta-end}. If this is found, the software then looks for @ { visual – meta – start }and uses the data found between these marker tags.

It is very important to make clear that Visual-Meta is an approach more than a specific format and that it is based on wrappers: Anyone can make a custom wrapper for custom metadata and append it by specifying what it is. For example @dublin-core or @rdfs.

@glossary{ This sections lists what terms are in the glossary.
Feel free to add your own tags but please describe them in this introduction section in order for others to derive value from them now and in the future.

This was written Sumer 2021. More information is available from https://visual-meta.info or from emailing frode@hegland.com for as long as we can maintain these domains