概要
I looked into how to use “Peripleo,” so here are my notes. “Peripleo” is described as follows.
Peripleo is a browser-based tool for the mapping of things related to place.
https://github.com/britishlibrary/peripleo
This time, I will introduce how to use it in combination with “Rekichizu” (historical maps) introduced in the following article.
Output
You can try it at the following URL.
https://nakamura196.github.io/peripleo/
The repository is as follows.
https://github.com/nakamura196/peripleo
In this blog post, I will use the following “Bird’s-eye View of Buildings in the Main Campus and Faculty of Agriculture of Tokyo Imperial University” (held by the University of Tokyo Agricultural and Life Sciences Library) as sample data.
https://iiif.dl.itc.u-tokyo.ac.jp/repo/s/agriculture/document/187cc82d-11e6-9912-9dd4-b4cca9b10970
Background
I participated in the following conference and learned about “Peripleo.” I would like to thank all those involved in developing “Peripleo,” those who organized the conference, and Gethin Rees who taught me how to use it.
http://codh.rois.ac.jp/conference/linked-pasts-10/
Basic Usage
Details are described at the following link.
https://github.com/britishlibrary/peripleo?tab=readme-ov-file#installation-guide
This time, I will introduce the customizations made when using the data from “Bird’s-eye View of Buildings in the Main Campus and Faculty of Agriculture of Tokyo Imperial University.”
Preparing the Data
Prepare a spreadsheet like the following.
https://docs.google.com/spreadsheets/d/1ZZJZL0K4cBOc0EgMHNV9NQ56C_fcZm0eceBg_OPmxe4/edit?usp=sharing
Gray cells are unnecessary columns.
Once the data is ready, download it in CSV format.
Converting to JSON Format
Use a tool called Locolligo to convert the CSV data to JSON format.
https://github.com/docuracy/Locolligo
First, access the following.
https://docuracy.github.io/Locolligo/
After uploading the CSV file, pressing “Assign CSV Columns” displays the following.
It seemed that using reserved words in the CSV headers eliminates the need for manual mapping. If mapping doesn’t work properly, configure it manually.
The reserved words could be confirmed at the following link.
https://github.com/docuracy/Locolligo/blob/main/js/data-converter.js
When you download the results, you can obtain data with items like the following stored in features.
Starting the Viewer
!
Below, I introduce how to work by downloading the source code locally, but as described in the peripleo README.md introduced at the beginning, you can also update files through the GitHub GUI.
Then, accessing the following allows you to check the default display content.
If running locally and git or python -m http.server doesn’t work properly, please refer to other articles on the internet.
Changing Viewer Settings
Updating Data
First, copy the contents of the JSON downloaded earlier and overwrite the following file.
docs/data/VisitPlus-UK.lp.json
After reloading the browser and navigating toward Tokyo, you can confirm that the custom data is displayed as shown below.
Updating Settings
The viewer settings are in the following file.
docs/peripleo.config.json
Make changes as follows.
First, change initial_bounds to the area around the University of Tokyo.
Also, change map_style to “Rekichizu.”
Furthermore, change the attribution as well.
As a result, custom data is displayed on “Rekichizu” as shown below.
Feature Introduction
By setting depictions[0].@id, thumbnail images are displayed. The link destination uses the value set in identifier.
When enlarged, the string set in depictions[0].title is displayed.
Also, Related Web Resources are displayed based on the dbpedia link set in links[0].identifier.
Furthermore, filtered search is possible based on the value of types[0].label.
まとめ
There may be some inaccurate or incomplete explanations, but I hope this serves as a useful reference.
I found it very convenient that by conforming to the Linked Places Format (LPF), such applications become available.
https://github.com/LinkedPasts/linked-places-format/blob/master/README.md