BEACON link dump format
This repository contains drafts of the BEACON link dump format specification. BEACON is a data interchange format for large numbers of uniform links.
The format was developed to exchange mappings between authority files and resources incultural institutions but it can also serve as serialization format for RDF graphs with uniform triples.
Specification
Specification drafts are managed and published in a GitHub repository:
- latest version
- draft-003 (December 2017)
- draft-002 (November 2017)
- draft-001 (July 2014)
Earlier drafts had been developed in Wikipedia starting in February 2010:
- BEACON format (German Wikipedia)
Use cases
- BEACON files used in/by Wikipedia (most comprehensive list)
- BEACON exported by Wikidata tool
- findbuch.de link aggregator
- Link shorteners archived by http://urlte.am/ are BEACON without meta fields (see helper script to add metadata)
- wdmapper uses BEACON as output format for mappings extracted from Wikidata, see BEACON files at project coli-conc
- wikidata-taxonomy contains the script
wdmappings
to extract ontology mappings in BEACON format - ...
Implementations
The implementations are not fully aligned with the current state of specification. Most applications don't use dedicated implementations because the format is simple enough to create/parse "by hand".
- JavaScript implementation (reference implementation)
- Java implementation
- Perl implementation (slightly outdated)
- ...
How to modify this specification
The specification of BEACON link dump format is being prepared in a public git repository, located at https://github.com/gbv/beaconspec. It uses the technique described in RFC 7328.
The specification is written in Pandoc Markdown syntax in the file beacon.md
.
Additional parts are included in the file appendices.md
, rfctemplate.xml
,
and bibliographic references in the directory ref
. To compile the
specification in RFC style there is a Makefile
. To create a snapshot in HTML
and TXT format you need:
To install at Ubuntu Linux with Python, call:
sudo apt-get install pandoc xsltproc xml2rfc
sudo pip install xml2rfc
To further install pandoc2rfc
after cloning the repository you must call:
git submodule update --init
You can then modify beacon.md
, appendices.md
, rfctemplate.xml
and create
a nice HTML version by simply invoking make
.