Skip to content

contagon/handbook

Repository files navigation

General Handbook Tracker

A simple scraper for tracking changes of the General Handbook of the Church of Jesus Christ of Latter-Day Saints using git diff.

For those not familiar with the Church of Jesus Christ, I recommend you check out the church's website for more information about our beliefs. It is a worldwide church, with volunteer-based clergy that follow the instructions put out by the General Handbook.

The easiest way to visualize changes is via the links below. Removed text from previous editions will be shown in red on the left, and the new version with changes in green on the right.

Edition Compare to Previous Compare to Current
2024-08 Link NA
2024-05 Link Link
2023-08 Link Link
2022-08 Link Link
2021-12 Link Link
2021-07 Link Link
2021-03 Link Link
2020-12 Link Link
2020-07 Link Link
2020-03 NA Link

I hope you enjoy! I've enjoyed having an easy visualization of changes to see how the church is continuing to focus on Christ, His work, and bringing others unto Him.

Note, I am not doing this in any official capacity with the church, just on my own accord.

Technical Info

All the versions are stored in the editions folder, with working hyperlinks both to churchofjesuschrist.org and relative links to other chapters. Additionally, in the diff branch, each edition is stored with a tag and a separate commit in the handbook folder. Links comparing different editions are found in the table above.

Editions were found via Church Newsroom and checking the "Summary of Recent Changes" page on the wayback machine.

I began this project when the 2024-05 edition came out - all previous editions are also from the wayback machine. Unfortunately, about 15% of edition chapters weren't saved - for these chapters I used the previous edition version, and if it didn't exist, the newer edition version. Missing pages can be found in missing.txt.

Please feel free to open an issue/pull request/etc if you have any questions or find some inconsistencies.

Running the Scraper

If you feel like running this yourself, python package requirements are found in requirements.txt - additionally I ran it all with python 3.10. Getting all the editions can be done via running run.sh, individual downloading/sanitizing/copying missing can be done via the cli interface in run.py. Making the diff branch is done via branch.sh.

About

Change Tracker of the Church of Jesus Christ General Handbook

Resources

Stars

Watchers

Forks