Implementing Visual-Meta

On Exported Documents

In principle implementing Visual-Meta into your document export system is simple: The Visual-Meta is appended to the document in a small font on a new page after the main contents, starting with: @{visual-meta-start} and ending with @{visual-meta-end}. In-between is a basic header and information to cite the document/what the document is.

Please have a look at the structure for further details:

Implementation notes are suggested reading. Also there are two additional optional aspects of valid Visual-Meta outside of the main tags:

  1. Optional Pre-Visual-Meta
  2. Optional Post-Visual-Meta

Please also note that you can use ¶ to indicate a line break for parsing.

   

On Clipboard

To enable augmented copy where the user can copy text from your environment (such as a PDF viewer like Reader or a web page) and paste it into a Visual-Met aware text editor, such as Author, the copied text needs to contain the following, which is 100% BibTeX, which is what Visual-meta ingests:

An example from a web page: https://jrnl.global/2019/01/30/three-things/

@article{sam-liu:three-things-jrnl:2019-01-30,
author = "Sam Liu",
title = "Three Things – jrnl",
year = "2019",
month = "jan",
day = "30",
url = "https://jrnl.global/2019/01/30/three-things/#;article=1;char=225-297"
}

Another example, from a web page: http://blog.soton.ac.uk/webteam/2021/02/12/love-data-week-covid-data/

@{visual-meta-start}
@misc{christophergutteridgelovedata,
author = {Christopher Gutteridge},
title = {Love data week: COVID Data – Southampton Web and Data Innovation Team},url = {http://blog.soton.ac.uk/webteam/2021/02/12/love-data-week-covid-data/},
year = {2021},month = {feb},
day = {12},
@{visual-meta-end}

You can try this yourself by visiting this sites, selecting text, pointing to the little liquid sphere and choosing ‘Copy BibTeX’.