This starter kit is designed to get you hands on with using Scripture in a connected way in your personal notes. It comes with the Bible in markdown, formatted to get you engaging with Scripture straight away.
I am considering turning the kit into a course. If that sounds interesting to you, let me know through this short form.
Wishing to reflect Godās grace, all resources are free without any obligation. When gratitude for Godās Word moves you to give, you can do so on Patreon or by buying me a coffee.
Acknowledgements
Thanks to @j.split, karlpalmer, @Lithou, @Mike and @nickmilo for their willingness to provide feedback. It made this kit a much better one.
A huge thank you also to all supporters on patreon.
I am looking forward to hearing thoughts and use cases below!
This is great!
Thanks for making this for free.
I was wondering how to replace the Bible translation with another one that I prefer to?
Is it challenging for someone like me who knows nothing about programming to do that?
Hey @Liong1976, you can find a program to do this on github. There I also provided detailed instructions to make it as easy as possible for people who arenāt familiar with programming.
Follow the steps and let me know if you need help!
This is good! Iāve been on the look out for something similar for a longwhile, and Iām so glad I found it. I hope to transform this vault into something which resembles this, as I get on with the different books!
Thank You!
I am using Windows instead of Mac. Do I need to install Ruby? If so, is this the correct link to install it?
I do not know how to use the commands in Terminal that stated in the gitbhub (in my case is Command Prompt) like pwd, ls, cd, and cd . . to navigate to the folder in which the scripts are located
How to run bash bg2obs.sh. just copy and paste the code in my folder in the Command Prompt?
Hey @Kuncy, glad itās of help! Iād love to have all of the crossreferences linked as well at some point to create a graph view similar to the picture.
Pleasure, glad itās helpful!
I canāt be of much help for Windows since I am on MacOS but I can point you towards some links. You will need to install both bash and ruby, two programming languages that come with MacOS but not Windows. Luckily, it seems fairly straightforward.
Once you habe installed bash, you can type in pwd to show you the current folder your command line is in, then navigate into folders like this cd Desktop and once you are in the folder run this command: bash bg2obs.sh. Make sure both bg2obs.sh and bg2md.rb are in the same folder.
Hey @Joschua, thank you for this enormous work and making it free. May God bless you for this. I downloaded and have been playing with this over the weekend. I also loved your āsplit thinkingā notes. Initially when I downloaded it, I was thinking of creating a separate vault, after reading āsplit thinkingā note, I decided to keep everything in a single vault.
@Joschua do you have a version of this that splits the text into individual verses per chance? Kind of stuck with Obsidianās inability to see block references. Ideally, Iād like to be able to embed verse references on my personal study notes pages (which are organized by date) and see the other notes Iāve taken that link to that specific verse (i.e. [[John 3:16]]).
A version of this doesnāt exist (yet). It would take me a bit of time and tinkering to create something that would accomplish this. Currently, Iām focusing on other things but that might change in some weeks. Meanwhile, I created a feature request to sort header links by order in backlinks panel which might solve some of your problems, if I understood them correctly.
As a workaround, embedding the verse works well, the only issue is that you have to comb through all of your backlinks to each verse in the chapter:
Yeah, thatās the problemā¦ I can get to the Genesis 1 page from the sermon notes page for a specific date, but once Iām there, there is no way to go to the other sermon notes pages that reference the same verse easily. In ~3 years of taking notes, I would have 100s of links to scroll through for the Linked Mentions on a Bible chapter page.
Thanks a lot for sharing youāre experience and thoughts with us @Joschua.
@jjude, you wrote, that you played over a weekend with the tool. I smiled and thought that the Bible Study in Obsidian Kit isnāt that voluminous. I was mistaken and will enjoy this Kit the next few evenings
@phlind you can copy the css snippet from here: CSS Snippet
In combination with the Minimal Theme in Obsidian itās beautiful to read.
I did some work on this in a fork, @Joschua. You likely donāt want to pull it in directly but I made some adjustments for my own purposes.
Instead of relying on the installation of the BG to MD dependency, I installed it as a submodule and then referenced the .rb executable directly in your script.
I removed a lot of the "00 - " numbering and such in your script so that it was cleaner on the output side.
I added a script versesplit.sh that can be run on a version directory and it will split out the chapter markdown files into individual verse markdown files.
I added another script masterfiles.sh that when run will create a file in each book and chapter folder that contains links to the downstream files. So Genesis.md has links to all the chapters. Genesis 1.md has links to all the verses. That way thereās a link between it all.
I then added a final script to add the sorting numbers back to the book folders for sorting them correctly.
Last note, the verse files take on the format Genesis 1.1.md. Colons are no fun in filenames.
Oh! I also changed the root folder name to be just the version text. In my scripts, I have ESV in there. So to use them on a different version, youāll need to change that bit or alter it to use a variable passed into the script.
Thanks @ChrisLi for sharing the link before I could You can also find the CSS snippet in the Bible Kit if you search for āTweaks, Queries and Pluginsā.
Wow, love all of the adjustments and I am happy there is a way to get each verse as a note. When it comes to installing the BG to MD dependency as a submodule, just be aware that the content that is scraped from BibleGateway often changes and the author of the bg2md script updates is frequently accordingly. So if some ugly html rendering comes through, just pull the script again.
Itās amazing what you can do just with a simple bash script Thanks for sharing!
Makes sense. It would just be a matter of running the update submodule command each time. But that would also mean that you could control when itās updated or not.
So true! I have so many one-off scripts like this. I donāt normally share them, but this time it seemed appropriate.