sermon-notes/README.md

Sermon Notes

A program to take notes during a sermon. The web app was built with PHP and Symfony.

ATTN: !!!!BREAKING CHANGE!!!! v1.0 -> v1.1

This was my first publicly available docker container so I did not realize what some decisions would do. If you are upgrading from v1 you first need to save your database OR you will lose all your current notes!! Follow the steps below to do that

1. You need to make sure that you have a running SSH server on your host computer
2. On your host computer, docker exec -it sermon-notes bash
3. cd var/
4. scp data.db {user}@{host computer IP}:{path}
5. Authenticate with the password
6. This will copy the file over SFTP to the host computer
7. After this then you run the docker run... command in Step 1 of the Installation instructions below, once the container is running you need to copy the data.db file into the working directory of the docker container.
   • For example, if you have ~/docker/sermon-notes as the path for the container on the host computer, you'll copy the data.db to ~/docker/sermon-notes/data

Installation

1. Make a directory in your desired docker storage folder (e.g. ~/docker/sermon-notes), then cd into it.
2. Create a file called .env in that folder, no need to add anything to it right now.
3. Run docker run -d --name sermon-notes -p 80:80 -v $PWD/data:/data -v $PWD/.env:/var/www/html/.env ryanprather/sermon-notes:latest, this will download and start the container and keep it running in the background. If you already have something on port 80 change the first 80 to whatever open port you'd like.
4. Run docker exec -it sermon-notes bash install.sh This will run an install script to create an .env file specific to your install, populate with the beginning factors, and then run a composer command to download the necessary package dependancies.
5. Once complete you have a running system that you can navigate to in your browser with http://{ip}:{port}|http://{hostname}:{port}. Then you just need to register for an account. The first account that is created is made an admin so that you can access the Reference Editor and update any reference material if necessary.

Operation

This is the home page you're first presented with.

Create an account with "Register".

Once you create an account you'll need to login

Once you get logged in you'll be presented with the main home page

If you are accessing on a regular iPad the menu should be collapsed, if not, you may need to do that. I built this with a iPad 9th Gen in mind so visibility on another device may vary.

Across the top you will see a "plus" and "minus" buttons that will increase and decrease the size of font for the reference content. The 3rd button is to open the Reference opener box. On the right side you will see the "table" that will open the sermon details portion. The next button is a preview button to preview the notes you have typed. The final dropdown is to quickly apply a template for you to start taking notes.

These fields are meant to hide because you only need to fill them out once and they are the specifics of the sermon itself (e.g. title, date, speaker, series, and passage)

The notes you take are done in Markdown. In the above example, there is an introduction and 3 bullet points. Each has a sub-bullet unordered list. Review the Markdown link above for more tips on how to write Markdown.

When you are done with your Notes it will look something like the following.

The tool is built that it will auto-save every 10 seconds and have a 5 second timeout should you be in a place where you don't have good internet service. When the tool starts to save you will see an orange checkmark appear next to the "Notes" header above where your typing. When it is done saving it will turn green and fade away.

I built this tool because I needed a way to take notes and have reference material open next to me. So I built a reference opener to do just that

I have added many reference options (Bible, various creeds, Belgic Confession, Heidelberg Catechism, Canons of Dort, Westminster Confession of Faith, Westminster Larger Catechism, or Westminster Short Catechism). I plan to add others in the future. Simply select the type then filter to the book/chapter/week of the referenced work and hit "Search". This will open the reference on the left side of the page.

You can switch between the references by clicking the button on the left side. You can double-tap one of the buttons to remove that reference from the list.

Once a note has been saved, it can be retrieved in two different ways. You can open the open page (by clicking on the Menu (hamburger) then "Open Notes")

or if the note was recently made you will see the most recent 4 notes listed under the menu

By clicking either of the title links it will open the note and display it for you to edit or read. I can add "Notes" as future reference content.