Skip to content

Latest commit

 

History

History
97 lines (62 loc) · 2.95 KB

readme.md

File metadata and controls

97 lines (62 loc) · 2.95 KB
Raw

Verse/Selector

Select a bible verse (or something similar) at random! This code uses the German Elberfelder Bibel from 1905.

Why would I want this?

Be greeted with a Bible verse when you log in to your shell.

Dependencies

  • sh (i.e. bash
  • awk (i.e. gawk)
  • make (i.e. gmake)
  • tar (i.e. GNU tar)
  • sed
  • wc
  • cat (usually included in your shell)
  • chmod (usually a system utility)

If you follow every step of the following guide, you should also check whether you have git installed.

Build

Default Build

The default build uses the German Elberfelder Bibel as its source.

  1. Get this repository: git clone https://www.github.com/nmke-de/vs.git
  2. Do this: cd vs
  3. Make. make vs
  4. Put your executable wherever you want. mv vs /path/to/wherever/you/want

Using a custom .tsv

You might want something else than the German Elberfelder Bibel. The file to use needs to be of the same format as elb.tsv in the repository, that is

  1. the bookname,
  2. short cut name of the book,
  3. book number,
  4. chapter number,
  5. verse number,
  6. verse content

in each line, tab-separated. If you use anthing comparable in scale to a bible, for example a bible, I advise you to use a script to generate the file.

Then, proceed with the following steps:

  1. Get this repository: git clone https://www.github.com/nmke-de/vs.git
  2. Do this: cd vs
  3. Make. make gen – Note that you make the correct file, as vs will be useless for using a custom .tsv at this point.
  4. Copy your custom .tsv-file into this directory (or copy gen to the directory with your custom .tsv-file and go there).
  5. Do this: ./gen yourcustomfile.tsv, but replace yourcustomfile.tsv with the name of your custom .tsv-file.
  6. Put your executable wherever you want. mv vs /path/to/wherever/you/want

Generating that custom .tsv

To create a tsv file with the correct format, I added a python helper script to help with the conversion from bibles of the Zefanja project to the needed format.

Download the XML-file from the provided link that corresponds to the bible you wish to use and move it to the directory where your helper script is located. Then type python3 zef2tsv.py [your-xml-file] > [your-bible].tsv, but replace [your-xml-file] and [your-bible] with the real name of the XML-file and the name of your bible translation.

Usage

gen

gen --help

	or:

gen -h
	or:

gen [-o <Outputfile>] <Inputfile>

vs

vs

But I am not greeted by a bible verse when I log in to my shell!!!

To be greeted by a bible verse on login, you need to write the following line in to your profile file:

path/to/your/vs

where path/to/your/vs is the path to your compiled file.

If you use bash, your profile file is ~/.bashrc. Its zsh equivalent is ~/.config/zshrc. On other shells, your profile file is usually ~/.profile.

This did not work!

Open an issue on this repository.