kidwellj/hacking_religion_textbook
1
0
Fork 0
mirror of https://github.com/kidwellj/hacking_religion_textbook.git synced 2024-11-01 01:12:20 +00:00
Code Issues Packages Projects Releases Wiki Activity
42 commits 1 branch 0 tags 94 MiB
R 96.7%
TeX 3.3%
Find a file
Jeremy Kidwell d99cbac7d0 Merge branch 'master' of https://github.com/kidwellj/hacking_religion_textbook
2024-02-13 12:43:20 +00:00
docs updated ch2 2023-10-13 07:04:52 +01:00
hacking_religion Merge branch 'master' of https://github.com/kidwellj/hacking_religion_textbook 2024-02-13 12:43:20 +00:00
.gitignore initial repo 2023-09-29 15:00:15 +01:00
functions_reference.R added dangling files 2024-02-13 10:29:15 +00:00
README.md small updates and corrections 2024-02-13 10:59:42 +00:00

README.md

Hacking Religion

An open textbook introducing data science to religious studies (or vice versa)

You can view a live demo of the book here: [https://kidwellj.github.io/hacking_religion_textbook/intro.html]

The course here has been compiled with quarto, and so the live instance of the course is compiled from openly accessible resources located in this repository. If you're interested in doing something similar, there are a number of other options, some of which have lamentably turned commercial, including: bookdown, gitbook, mkdocs, readthedocs which technically uses Sphinx or daux.

Top level files and directories in this repository are:

  • README.md this README file displayed on Github
  • hacking_religion a folder containing the quarto code and accompanying files which are used to render the book in html and .pdf formats
  • docs a rendered sample version of the most recent version of the book (used for )

Directory structure includes:

  • _book a folder containing the compiled book in html and .pdf formats
  • references.bib a bibliography of items used for the course in BibTeX format
  • preface.qmd Preface
  • intro.qmd Introduction and overview to book
  • chapter_1.qmd Chapter 1: working with UK Census religion data
  • chapter_2.qmd Chapter 2: survey data
  • chapter_3.qmd Chapter 3: geospatial data"
  • chapter_4.qmd Chapter 4: data scraping, corpus analysis and wordclouds
  • chapter_5.qmd What's next?

How to produce books from this repository:

  1. clone this repository using git clone https://github.com/kidwellj/hacking_religion_textbook.git (install git if you haven't already)
  2. install quarto
  3. install the necessary pre-requisite R libraries, including knitr and rmarkdown. This can be done by running the following commands in an RStudio console: 
    install.packages("knitr")
install.packages("rmarkdown")
  4. change to the hacking_religion subdirectory and run quarto preview to get a temporary preview of the book as a website running on your local PC.
  5. alternatively you can render a copy of the book using quarto render.

Cookbook

There is a companion repository which contains recipes which will replicate the example data used in the book. This can be found here: [https://github.com/kidwellj/hacking_religion_cookbook]

Copyright

Content here, unless otherwise indicated are copyright by Jeremy H. Kidwell. Please re-use them as they are covered by Creative Commons Attribution 4.0 International Licence (CC BY 4.0).