Bash Bible 🐚📖

{reference,survival} guide to scripting in the bash shell

Read

• https://xero.github.io/bash-bible
• raw github formatting

History

The original Pure Bash Bible 🪦 is sadly a defunt project. When citing it to novice bash scripting colleagues, I found they often lacked the necessary fundamental context to understand it. I wished the guide itself had more beginner level information, general reference materials, & maybe more flair ;D

When the project {author,maintainer} rage quit the internet, I was worried he might delete the original repo. Instead of forking, I cloned and continued committing to the existing repo history to retain credit to all the original authors.

Hacking

Install with bundle, then run jekyll build

bundle install
bundle exec jekyll build

Files

• site content: ./_pages/bible.md
• theme css: ./_sass/bible.scss
• dom skeleton: ./_layouts/bible.html
• favicons & images: ./assets

Goals

• Content ideas:
  • Script setup (shebang, chmod +x, etc)
  • Tools including linters, formatters, and bash langugage server
  • Bestow the power of BASHOPTS
  • tests [[ ]]
  • echo vs printf
  • redirections >, >>, < and std{out,in}
  • Immutable global variables readonly
  • Scripting style formatting (expression breaks with \)
  • Closing File Descriptors

n<&- Close input file descriptor n.
0<&- or <&- Close stdin.

• Combine the pure sh bible into this project:
  • the Bash Bible & Posix Psalms

License

The original project was MIT, and I'm sticking with that.

I've kept Dylan, added my name, and a link to the full contributors list.