@ -16,44 +16,7 @@ See [sources](https://librarymap.hugh.run/sources).
See [contributing](https://librarymap.hugh.run/contributing/), especially *[which files to update](https://librarymap.hugh.run/contributing/#which-files-to-update)*.
## 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
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
Contributors are listed at [contributors.txt](contributors.txt).
<p>I’d love your help to make <em>Library Map</em> as accurate and useful as possible.</p>
<h3id="how-to-contribute-your-idea-bug-report-or-improvement">How to contribute your idea, bug report or improvement</h3>
<oltype="1">
<li>Look at the <ahref="https://git.suboptimal.solutions/hugh/public_library_map/issues?q=&type=all&state=open&labels=9&milestone=0&assignee=0&poster=0">current issues tagged <code>help wanted</code></a> to see if you can help. Most of these will be to do with updating data, like finding street addresses or other information.</li>
<li>Email <code>librarymap</code>@<code>hugh</code>.<code>run</code> and ask me to open a <code>git.suboptimal.solutions</code> account for you, or just request that I fix/add something.</li>
<li>Look at the <ahref="https://github.com/hughrun/public_library_map/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22">current GitHub issues tagged <code>help wanted</code></a> to see if you can help. Most of these will be to do with updating data, like finding street addresses or other information.</li>
<li>You can <ahref="https://github.com/hughrun/public_library_map/issues">create a new issue</a> on GitHub.</li>
<li>You can <ahref="https://docs.github.com/en/github/.collaborating-with-issues-and-pull-requests/about-pull-requests">send a pull request</a> — though it is <em>strongly preferred</em> that you either ask to be assigned to an existing issue (so everyone knows you’re working on it), or create a new issue, first.</li>
<li>You can just send an email to <code>librarymap</code>@<code>hugh</code>.<code>run</code> and ask me to fix/add something.</li>
</ol>
<h3id="if-you-have-not-used-git-before">If you have not used Git before</h3>
<p>There is a class outline for an <ahref="https://librarycarpentry.org/lc-git/">introduction to Git and GitHub aimed at librarians</a> at <code>librarycarpentry.org</code>. This assumes you are using the command line.
<h3id="if-you-have-not-used-git-or-github-before">If you have not used Git or GitHub before</h3>
<p>There is a class outline for an <ahref="https://librarycarpentry.org/lc-git/">introduction to Git and GitHub aimed at librarians</a> at <code>librarycarpentry.org</code>. This assumes you are using the command line. If you create or already have a GitHub account, you can also <ahref="https://docs.github.com/en/github/managing-files-in-a-repository/editing-files-in-another-users-repository">edit files directly in the browser</a>, or use <ahref="https://desktop.github.com/">GitHub Desktop</a> - both of which are probably less intimidating options if you don’t have any desire to learn how to use a command line/shell interface, or just want to make a single minor update.</p>
<h3id="which-files-to-update">Which files to update</h3>
<p>To update information about library <em>services</em> (e.g.fines info, loan period etc) you should edit <code>website/data/library_services_information.csv</code>.</p>
<p>To update information about library <em>locations</em> (e.g.street address, phone number, coordinates) you should edit the relevant csv location file:</p>
<p>To update information about library <em>services</em> (e.g.fines info, loan period etc) you should edit <code>website/data/library_services_information.csv</code>.</p>
<p>To update information about library <em>locations</em> (e.g.street address, phone number, coordinates) you should edit the relevant csv location file:</p>
<h3id="missing-or-inaccurate-data">Missing or inaccurate data</h3>
<p>Currently we’re missing data for some library services in relation to <strong>standard loan periods</strong> and <strong>fines for overdue items</strong>. Any acurate and specific information about fines for South and Western Australia would be particularly helpful.</p>
<p>It’s likely that some <strong>library location data</strong> is inaccurate — especially for New South Wales. It’s also possible that the address data is wrong (even though the location shown may be correct), and in some cases it is missing.</p>
<p>It’s possible that some of the <strong>fines data for Queensland</strong> is a little off. This came from the State Library of Queensland but some of the data was wrong (e.g.Gold Coast Libraries does not charge overdue fines, but the SLQ report says it does).</p>
<p>It’s possible that some of the <strong>fines data for Queensland</strong> is a little off. This came from the State Library of Queensland but some of the data was wrong (e.g.Gold Coast Libraries does not charge overdue fines, but the SLQ report says it does).</p>
<p>I am particularly interested if you know of data sources for entire regions, states, or Australia — especially if they’re reliably kept up to date.</p>
<p>If you can fill in any of these blanks, please update the relevant CSV file and send a pull request. If your data is coming from somewhere in particular, you should also add that to <code>sources.md</code> in the relevant table.</p>
<h3id="ideas-for-additional-data">Ideas for additional data</h3>
Cobar Shire and TAFE Library,Cobar,nsw,?,4,Libero,https://www.cobar.nsw.gov.au/community-services/library,
Coffs Harbour City Library and Information Service,Coffs Harbour,nsw,no,4,Civica Spydus,https://libraries.coffsharbour.nsw.gov.au/About-Us/Pages/Location-and-Hours.aspx,
@ -38,7 +40,6 @@ Hilltops Council Library,Hilltops,nsw,yes,3,Libero,http://www.swrls.nsw.gov.au/s
Mid Western Regional Council Library Service,Mid-Western Regional,nsw,yes,3,Civica Spydus,https://midwestern.spydus.com/cgi-bin/spydus.exe/ENQ/OPAC/LOCENQ?TYP=BR&NRECS=1000,
Strathfield Library and Information Centre,Strathfield,nsw,yes,3,Civica Spydus,https://www.strathfield.nsw.gov.au/play/strathfield-council-library/,
Sutherland Shire Libraries and Information Service,Sutherland Shire,nsw,yes,3,Innovative Sierra,https://www.sutherlandshire.nsw.gov.au/Community/Library,
City of Sydney Library,Sydney,nsw,yes,3,AIT Aurora,https://www.cityofsydney.nsw.gov.au/libraries,
Tenterfield Public Library,Tenterfield,nsw,yes,4,Libero,https://www.tenterfield.nsw.gov.au/community/library,
The Hills Shire Library Service,The Hills Shire,nsw,?,3,Civica Spydus,https://www.thehills.nsw.gov.au/Library,
Campbelltown Public Library Service,Campbelltown (SA),sa,?,4,SirsiDynix Symphony,http://www.campbelltown.sa.gov.au/library,
District Council of Ceduna ,Ceduna,sa,?,4,SirsiDynix Symphony,http://www.cedunaas.sa.edu.au/library.html,
Charles Sturt Library Service ,Charles Sturt,sa,no,4,SirsiDynix Symphony,http://www.charlessturt.sa.gov.au/page.aspx?u=788,
Clare and Gilbert Valleys Council ,Clare and Gilbert Valleys,sa,?,4,SirsiDynix Symphony,https://www.claregilbertvalleys.sa.gov.au/page.aspx?u=335,
District Council of Cleve ,Cleve,sa,?,4,SirsiDynix Symphony,https://www.cleve.sa.gov.au/page.aspx?u=441,
District Council of Coober Pedy ,Coober Pedy,sa,?,4,SirsiDynix Symphony,http://www.cooberpedy.sa.gov.au/page.aspx?c=1741&u=,
Coorong District Council ,Coorong,sa,?,4,SirsiDynix Symphony,https://www.coorong.sa.gov.au/libraries,
Copper Coast Council ,Copper Coast,sa,?,4,SirsiDynix Symphony,http://www.coppercoast.sa.gov.au/page.aspx?u=1621,
District Council of Ceduna ,Ceduna,sa,?,4,SirsiDynix Symphony,http://www.cedunaas.sa.edu.au/library.html,
District Council of Cleve ,Cleve,sa,?,4,SirsiDynix Symphony,https://www.cleve.sa.gov.au/page.aspx?u=441,
District Council of Coober Pedy ,Coober Pedy,sa,?,4,SirsiDynix Symphony,http://www.cooberpedy.sa.gov.au/page.aspx?c=1741&u=,
District Council of Elliston ,Elliston,sa,?,4,SirsiDynix Symphony,http://www.elliston.sa.gov.au/Libraries,
The Flinders Ranges Council ,Flinders Ranges,sa,?,4,SirsiDynix Symphony,http://www.frc.sa.gov.au/page.aspx?c=793&u=,
District Council of Franklin Harbour ,Franklin Harbour,sa,?,4,SirsiDynix Symphony,http://acacia.cowellas.sa.edu.au/cms/?q=node/13,
Gawler Public Library Service ,Gawler,sa,no_unconfirmed,4,SirsiDynix Symphony,http://www.gawler.sa.gov.au/page.aspx?u=530,
Regional Council of Goyder ,Goyder,sa,no,4,SirsiDynix Symphony,https://onecard.network/burra,
District Council of Grant ,Grant,sa,?,4,SirsiDynix Symphony,https://www.dcgrant.sa.gov.au/community/pmcc/library,
Holdfast Bay Library Service ,Holdfast Bay,sa,?,4,SirsiDynix Symphony,https://www.holdfast.sa.gov.au/page.aspx?u=3809,
Kangaroo Island Library Service ,Kangaroo Island,sa,yes,4,SirsiDynix Symphony,http://www.kangarooisland.sa.gov.au/library,
District Council of Karoonda East Murray ,Karoonda East Murray,sa,?,4,SirsiDynix Symphony,https://www.dckem.sa.gov.au/page.aspx?u=485,
District Council of Kimba ,Kimba,sa,?,4,SirsiDynix Symphony,https://www.kimba.sa.gov.au/community/community-library,
District Council of Lower Eyre Peninsula ,Lower Eyre Peninsula,sa,?,4,SirsiDynix Symphony,https://onecard.network/cummins,
District Council of Orroroo Carrieton ,Orroroo/Carrieton,sa,?,4,SirsiDynix Symphony,http://www.orroroo.sa.gov.au/page.aspx?c=7146&u=,
District Council of Streaky Bay ,Streaky Bay,sa,?,4,SirsiDynix Symphony,https://www.streakybay.sa.gov.au/page.aspx?u=491,
District Council of Tumby Bay ,Tumby Bay,sa,?,4,SirsiDynix Symphony,http://www.tumbybay.sa.gov.au/page.aspx?u=110,
Gawler Public Library Service ,Gawler,sa,no_unconfirmed,4,SirsiDynix Symphony,http://www.gawler.sa.gov.au/page.aspx?u=530,
Holdfast Bay Library Service ,Holdfast Bay,sa,?,4,SirsiDynix Symphony,https://www.holdfast.sa.gov.au/page.aspx?u=3809,
Kangaroo Island Library Service ,Kangaroo Island,sa,yes,4,SirsiDynix Symphony,http://www.kangarooisland.sa.gov.au/library,
Kingston District Council ,Kingston Sa,sa,no_unconfirmed,4,SirsiDynix Symphony,http://www.kingstonlibrary.com.au/,
Light Regional Public Library Service ,Light,sa,?,4,SirsiDynix Symphony,http://www.light.sa.gov.au/library,
District Council of Lower Eyre Peninsula ,Lower Eyre Peninsula,sa,?,4,SirsiDynix Symphony,https://onecard.network/cummins,
Loxton Waikerie Library Service ,Loxton Waikerie,sa,?,4,SirsiDynix Symphony,http://www.loxtonwaikerie.sa.gov.au,
Marion Library Service ,Marion,sa,no,4,SirsiDynix Symphony,http://www.marion.sa.gov.au/library-contact-and-opening-hours,
Mid Murray Council ,Mid Murray,sa,?,4,SirsiDynix Symphony,https://www.mid-murray.sa.gov.au/page.aspx?u=783,
@ -219,7 +220,6 @@ Naracoorte Lucindale Council ,Naracoorte Lucindale,sa,?,4,SirsiDynix Symphony,ht
Northern Areas Council ,Northern Areas,sa,?,4,SirsiDynix Symphony,http://www.jamestnr12.sa.edu.au/library.html,
Norwood Payneham & St Peters Library Service ,Norwood Payneham and St Peters,sa,?,4,SirsiDynix Symphony,http://www.npsp.sa.gov.au/culture_and_lifestyle/libraries,
Onkaparinga Library Service ,Onkaparinga,sa,?,4,SirsiDynix Symphony,http://onkaparingacity.com/onka/living_here/libraries.jsp,
District Council of Orroroo Carrieton ,Orroroo/Carrieton,sa,?,4,SirsiDynix Symphony,http://www.orroroo.sa.gov.au/page.aspx?c=7146&u=,
<p>The library service boundaries are derived from local government boundary data care of PSMA and accessed from <ahref="https://data.gov.au">data.gov.au</a>.</p>
<p>Data about fines and lending periods is a mix of original research, plus data provided by State Libraries and Public Libraries Victoria.</p>
<p>Data about language holdings (TODO) provided by various sources.</p>
<p>Data about Integrated Library Systems (ILS) is mostly original research, with some data from State Library of Queensland, and some checked at Marshall Breeding’s <ahref="http://librarytechnology.org">librarytechnology.org</a> site.</p>
<p>Data about Integrated Library Systems (ILS) (TODO - almost done) is mostly original research, with some data from State Library of Queensland, and some checked at Marshall Breeding’s <ahref="http://librarytechnology.org">librarytechnology.org</a> site.</p>