wkd2beacons - A Generator for BEACON files: Gemeinsame Normdatei (GND) ↔ Wikidata
- Maven documentation: https://mbuechner.github.io/wkd2beacons/
- Version: 1.2 (21-01-2019)
> mvn clean package> mvn clean sitehttps://github.com/mbuechner/wkd2beacons/raw/master/downloads/wkd2beacons.jar.gz
Start immediately with default configuration:
> java -Dlog.file=wkd2beacons.log -jar wkd2beacons.jarThe parameter -Dlog.file=... defines the filename for the logging. Possible is just a file name -Dlog.file=wkd2beacons.log or (better) a path with filename -Dlog.file=/home/user/logs/20190121-wkd2beacons.log. If there's no file defined, logging output will be in a file called log.file_IS_UNDEFINED.
Print help text:
> java -Dlog.file=wkd2beacons.log -jar wkd2beacons.jar -husage: java -Dlog.file=wkd2beacons.log -jar wkd2beacons.jar [-d <arg>] [-h] [-o <arg>] [-v]
-d <arg> Folder to stored all downloaded Wikidata dumps and entity type database (default: data/)
-h Print help text
-o <arg> Destination folder (default: beacons/)
-v Print version
- Wikidata dump: wkd2beacons will automatically download the newest Wikidata dumps
- Entity Facts: Internet connection and access to the Entity Facts data service
- Entity type database: see below
wkd2beacons needs to know the entity type (e.g. person, place, family, organization, event) of a GND entity to decide which depiction is useful for the BEACON file.
| GND entity type | Preferred Wikidata property | Second-possible Wikidata property |
|---|---|---|
| Organization | Logo (P154) | Image (P18) |
| Person | Image (P18) | -- |
| Family | Crest (P94) | Image (P18) |
| Event | Logo (P154) | Image (P18) |
| Place | Image (P18) | -- |
| n/a | Logo (P154) | Image (P18) |
The tool will create a local database (File name schama: data/entities-{YYYYMMDD}.db) with its first run (That will take much longer time!). For the next runtime wkd2beacons will reuse this database and not ask Entity Facts service again (That's much faster!).
| Download of Wikidata dumps | Runtime | |
|---|---|---|
| First run(s) (using local entity type database) | 0 days 5 hours 23 min. 51 sec. | 2 days 13 hours 12 min. 12 sec. |
| Next run(s) (using local entity type database) | approx. same | 0 days 2 hours 17 min. 20 sec. |
Caution: It's recommended to rebuild the local Entity type database regularly. Data will become obsolete and have negative affects.
File name schema: <dateOfDump>-beacon-<kindOfData>.txt
| File name | Example | Desciption |
|---|---|---|
20190114-beacon_dewiki.txt |
Link | Concordance GND to German Wikipedia |
20190114-beacon_dewikisource.txt |
Link | Concordance GND to German Wikisource |
20190114-beacon_enwiki.txt |
Link | Concordance GND to English Wikipedia |
20190114-beacon_enwikisource.txt |
Link | Concordance GND to English Wikisource |
20190114-beacon_gndimages.txt |
Link | Concordance GND to Images of (GND-) Persons, Families and Corporate Bodies |
20190114-beacon_wikidata.txt |
Link | Concordance GND to Wikidata |
20190114-beacon_gndimages.csv |
- | CSV-Data for analysis of Wikidata images |