66 lines
2.3 KiB
Markdown
66 lines
2.3 KiB
Markdown
# Public library data map
|
|
|
|
This project collects and maps data from public libraries across the Australia and the external Territories of Christmas Island and the Cocos (Keeling) Islands.
|
|
|
|
You should be able to find the location of every public library in Australia territory, plus the standard loan period for each libary service, and whether they charge overdue fines (if known, in both cases).
|
|
|
|
Check out the map at [librarymap.hugh.run](https://librarymap.hugh.run).
|
|
|
|
Find more on this project at [about](https://librarymap.hugh.run/about).
|
|
|
|
## Attributions
|
|
|
|
See [sources](https://librarymap.hugh.run/sources).
|
|
|
|
## Want to help?
|
|
|
|
See [contributing](https://librarymap.hugh.run/contributing/), especially *[which files to update](https://librarymap.hugh.run/contributing/#which-files-to-update)*.
|
|
|
|
<<<<<<< HEAD
|
|
## Deployment
|
|
|
|
The website for this project uses [git-webhooks](https://git.suboptimal.solutions/hugh/git-webhooks) with a customisation to run the `process.js` file that is found in this repository on each pull. The file is stored with the webhooks files so that everything can be `npm install`ed together.
|
|
|
|
This `process.js` file syncs any changes from the csv files into the topojson attributes (e.g. when a library changes their ILS).
|
|
|
|
## Updating the topojson
|
|
|
|
### Update boundaries
|
|
|
|
* make a copy of `/public_library_map/boundaries.geo.json`
|
|
* update in `qgis`
|
|
* save the copied file
|
|
|
|
### Simplify to reduce the file size
|
|
|
|
#### Option 1
|
|
|
|
* upload to https://mapshaper.org/ and 'simplify' the boundaries
|
|
* download the simplified version
|
|
* replace `/public_library_map/boundaries.geo.json`
|
|
|
|
#### Option 2
|
|
|
|
```bash
|
|
sudo npm install -g mapshaper
|
|
mapshaper boundaries.geo.json snap -clean -o force precision=0.0001 format=geojson boundaries.geo.json
|
|
```
|
|
### Turn it into `topojson`:
|
|
|
|
```bash
|
|
sudo npm install -g topojson-server
|
|
geo2topo boundaries.geo.json -q 50000 > website/data/boundaries.topo.json
|
|
```
|
|
|
|
## Contributing
|
|
|
|
To contribute to the map data you can contact Hugh at librarymap [at] hugh.run. If necessary, I will add an account for you on `git.suboptimal.solutions` if you want to contribute to the code.
|
|
|
|
Contributors are listed at [contributors.txt](contributors.txt).
|
|
|
|
## Licenses
|
|
|
|
**/website/data**: [CC-BY-SA](https://creativecommons.org/licenses/by-sa/4.0/)
|
|
|
|
**everything else**: [GPL-3.0-or-later](https://www.gnu.org/licenses/gpl-3.0.txt)
|