From ecdb02d7ad94da4a57b008dd0df176cbf0ec9aed Mon Sep 17 00:00:00 2001 From: Alex Ball Date: Mon, 14 Jul 2025 10:18:09 +0100 Subject: [PATCH 1/3] Add subtitle from Opening Science for clarity Relates to #187. --- learners/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learners/reference.md b/learners/reference.md index d1809f34..b98ce3ae 100644 --- a/learners/reference.md +++ b/learners/reference.md @@ -91,7 +91,7 @@ Git cheat sheet handouts: - [JiscMonitor/allapc](https://github.com/JiscMonitor/allapc) - [Python Programming for Humanities](https://www.karsdorp.io/python-course/) - [Code4Lib 2008 lightning talk – Git and distributed cataloging](https://galencharlton.com/blog/2008/03/code4lib-2008-lightning-talk-git-and-distributed-cataloging/) -- [Opening Science](https://www.openingscience.org/get-the-book/) +- [Opening Science](https://www.openingscience.org/get-the-book/): 'The evolving guide on how the Web is changing research, collaboration and scholarly publishing' ## Further reading From c5c56c2f3110b54924600b96b4346e504c50b2b7 Mon Sep 17 00:00:00 2001 From: Alex Ball Date: Tue, 18 Nov 2025 17:56:05 +0000 Subject: [PATCH 2/3] Add detail and structure to list of Git repositories All entries now consist of a link to the repository, a description, and where applicable a list of related non-Git links (usually a rendering of the source code). This should make it easier to compare the Git-controlled source with the end product in each case. Relates to #187. --- learners/reference.md | 45 +++++++++++++++++++++++++------------------ 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/learners/reference.md b/learners/reference.md index b98ce3ae..153f89fb 100644 --- a/learners/reference.md +++ b/learners/reference.md @@ -78,25 +78,32 @@ Git cheat sheet handouts: `git remote add origin` : add a remote repository named 'origin', to upload changes to or download changes from -## Useful library GitHub repositories - -- [DavidChouinard/mrc\_to\_csv](https://github.com/DavidChouinard/mrc_to_csv): 'Python script for converting MARC21 files to a saner format (CSV), originally designed for the Harvard Libraries MARC21 records' -- [Process MARC records from Python](https://gitlab.com/pymarc/pymarc) - - [https://pypi.org/project/pymarc/](https://pypi.org/project/pymarc/) -- [umd-mith/git-intro](https://umd-mith.github.io/git-intro/): high level intro to git -- [edsu/mirador](https://github.com/edsu/mirador) -- [edsu/microdata](https://github.com/edsu/microdata) -- [dhtaxonomy/TaDiRAH](https://github.com/dhtaxonomy/TaDiRAH) -- [OpenAPC/openapc-de](https://github.com/OpenAPC/openapc-de) -- [JiscMonitor/allapc](https://github.com/JiscMonitor/allapc) -- [Python Programming for Humanities](https://www.karsdorp.io/python-course/) -- [Code4Lib 2008 lightning talk – Git and distributed cataloging](https://galencharlton.com/blog/2008/03/code4lib-2008-lightning-talk-git-and-distributed-cataloging/) -- [Opening Science](https://www.openingscience.org/get-the-book/): 'The evolving guide on how the Web is changing research, collaboration and scholarly publishing' +## Useful library-related Git repositories + +- [DavidChouinard/mrc\_to\_csv](https://github.com/DavidChouinard/mrc_to_csv): Python script for converting MARC21 files to CSV, originally designed for the Harvard Libraries MARC21 records. +- [pymarc/pymarc](https://gitlab.com/pymarc/pymarc): Python package for reading, modifying, and writing records in MARC21 format. + - Package description: [Pymarc](https://pypi.org/project/pymarc/) +- [umd-mith/git-intro](https://umd-mith.github.io/git-intro/): Slides introducing Git, aimed at Digital Humanities students, hosted on GitHub pages. + - Rendered slides: [High level intro to Git](https://umd-mith.github.io/git-intro/) +- [ProjectMirador/mirador](https://github.com/ProjectMirador/mirador): NodeJS package providing an interactive image viewer for cultural heritage websites. + - Package website: [Mirador](https://projectmirador.org/) +- [edsu/microdata](https://github.com/edsu/microdata): Python package for extracting microdata (text given a machine-readable label) from HTML5. +- [dhtaxonomy/TaDiRAH](https://github.com/dhtaxonomy/TaDiRAH): Taxonomy of Digital Research Activities in the Humanities. + - As rendered by the Dariah Vocabs Service: [TaDiRAH](https://vocabs.dariah.eu/tadirah/en/) +- [OpenAPC/openapc-de](https://github.com/OpenAPC/openapc-de): Dataset of information on fee-based open access publishing. + - Viewer for the dataset: [OpenAPC](https://treemaps.openapc.net) +- [JiscMonitor/allapc](https://github.com/JiscMonitor/allapc): Python package providing an API and reporting system for aggregated APC (article publication charge) data. +- [fbkarsdorp/python-course](https://github.com/fbkarsdorp/python-course): Tutorial and introduction to programming with Python, aimed at students/researchers in the humanities and social sciences, maintained as a set of Jupyter Notebooks. + - Rendered version: [Python Programming for the Humanities](https://www.karsdorp.io/python-course/) +- [openingscience/book](https://github.com/openingscience/book): The evolving guide on how the Web is changing research, collaboration and scholarly publishing, maintained as Markdown files and rendered using Jekyll (also used by GitHub Pages). + - Rendered book: [Opening Science](https://www.openingscience.org/get-the-book/) +- [programminghistorian/jekyll](https://github.com/programminghistorian/jekyll): A collection of lessons useful to historians and people working in libraries, maintained as Markdown files and hosted by GitHub Pages. + - Rendered site: [Programming Historian](https://programminghistorian.org) ## Further reading -- The [help pages](https://help.github.com/) of GitHub are a good place to start -- GitHub has '[activities](https://guides.github.com/activities/hello-world/)' which aim to explain how git works -- GitHub also has interactive tutorials for their [online version (GitHub Skills)](https://skills.github.com/) and for [using Git offline (Git-It)](https://github.com/jlord/git-it-electron#git-it-desktop-app) -- Atlassian has in depth but clear [tutorials](https://www.atlassian.com/git/tutorials) on using git -- The [Programming Historian](https://programminghistorian.org) uses GitHub to manage lessons useful to historians and also people working in libraries. It is a useful resource for lessons but also to see GitHub in action. +- The [help pages](https://help.github.com/) of GitHub are a good place to start. +- GitHub has '[activities](https://guides.github.com/activities/hello-world/)' which aim to explain how git works. +- GitHub also has interactive tutorials for their [online version (GitHub Skills)](https://skills.github.com/) and for [using Git offline (Git-It)](https://github.com/jlord/git-it-electron#git-it-desktop-app). +- Atlassian has in-depth but clear [tutorials](https://www.atlassian.com/git/tutorials) on using git. +- [Code4Lib 2008 lightning talk – Git and distributed cataloging](https://galencharlton.com/blog/2008/03/code4lib-2008-lightning-talk-git-and-distributed-cataloging/): Slides by Galen Charlton drawing parallels between how git works and how cataloging should work. From 85f7e586b9c591e78ea486874d0b3496df02671e Mon Sep 17 00:00:00 2001 From: Alex Ball Date: Tue, 18 Nov 2025 18:01:02 +0000 Subject: [PATCH 3/3] Swap order of further reading and example repositories I think the progression from a quick reference for Git, to manuals and tutorials for Git, to examples of Git being used in the wild, is more logical: that way, the scope broadens out the further down the page you go. Relates to #187. --- learners/reference.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/learners/reference.md b/learners/reference.md index 153f89fb..808b683e 100644 --- a/learners/reference.md +++ b/learners/reference.md @@ -78,6 +78,14 @@ Git cheat sheet handouts: `git remote add origin` : add a remote repository named 'origin', to upload changes to or download changes from +## Further reading + +- The [help pages](https://help.github.com/) of GitHub are a good place to start. +- GitHub has '[activities](https://guides.github.com/activities/hello-world/)' which aim to explain how git works. +- GitHub also has interactive tutorials for their [online version (GitHub Skills)](https://skills.github.com/) and for [using Git offline (Git-It)](https://github.com/jlord/git-it-electron#git-it-desktop-app). +- Atlassian has in-depth but clear [tutorials](https://www.atlassian.com/git/tutorials) on using git. +- [Code4Lib 2008 lightning talk – Git and distributed cataloging](https://galencharlton.com/blog/2008/03/code4lib-2008-lightning-talk-git-and-distributed-cataloging/): Slides by Galen Charlton drawing parallels between how git works and how cataloging should work. + ## Useful library-related Git repositories - [DavidChouinard/mrc\_to\_csv](https://github.com/DavidChouinard/mrc_to_csv): Python script for converting MARC21 files to CSV, originally designed for the Harvard Libraries MARC21 records. @@ -99,11 +107,3 @@ Git cheat sheet handouts: - Rendered book: [Opening Science](https://www.openingscience.org/get-the-book/) - [programminghistorian/jekyll](https://github.com/programminghistorian/jekyll): A collection of lessons useful to historians and people working in libraries, maintained as Markdown files and hosted by GitHub Pages. - Rendered site: [Programming Historian](https://programminghistorian.org) - -## Further reading - -- The [help pages](https://help.github.com/) of GitHub are a good place to start. -- GitHub has '[activities](https://guides.github.com/activities/hello-world/)' which aim to explain how git works. -- GitHub also has interactive tutorials for their [online version (GitHub Skills)](https://skills.github.com/) and for [using Git offline (Git-It)](https://github.com/jlord/git-it-electron#git-it-desktop-app). -- Atlassian has in-depth but clear [tutorials](https://www.atlassian.com/git/tutorials) on using git. -- [Code4Lib 2008 lightning talk – Git and distributed cataloging](https://galencharlton.com/blog/2008/03/code4lib-2008-lightning-talk-git-and-distributed-cataloging/): Slides by Galen Charlton drawing parallels between how git works and how cataloging should work.