Added better documentation for ref

diff --git a/bash_it.sh b/bash_it.sh
index f0c850c..fef8584 100644 (file)
--- a/bash_it.sh
+++ b/bash_it.sh
@@ -69,5 +69,6 @@ function bash-it() {
   echo "  todo-help                   This will list out all the aliases you can use with todo.txt-cli"
   echo "  aliases-help                Generic list of aliases."
   echo "  plugins-help                This will list out all the plugins and functions you can use with bash-it"
+  echo "  ref-help                                       Get help for the ref plugin."
   echo
 }

diff --git a/plugins/ref.plugin.bash b/plugins/ref.plugin.bash
index ed6329a..1c4deb0 100644 (file)
--- a/plugins/ref.plugin.bash
+++ b/plugins/ref.plugin.bash
@@ -85,3 +85,25 @@ ref() {
                gnome-open index.html
        fi
 }
+
+ref-help() {
+       echo
+       echo "Help for the ref plugin"
+       echo "-----------------------"
+       echo
+       echo "Setting up: "
+       echo
+       echo "First, set the REF_DIR variable in you ~/.bash_profile to the directory you want to store your references in."
+       echo "You don't even have to create this directory if you don't want to, ref will make it for you if it doesn't exist."
+       echo
+       echo "Then, you can start adding some refs. You can do so with this command: "
+       echo "  ref new topic subtopic"
+       echo "Where topic is the general topic, such as ruby. And subtopic is a more exact topic, like array."
+       echo "This will create a directory for the topic, and a subdirectory for the subtopic. You can then move a file of your desired format into the subtopic's directory."
+       echo
+       echo "To access your ref, you would do the following command: "
+       echo "  ref topic subtopic"
+       echo "Where topic and subtopic are the same as before, but ref will open the file under your topic/subtopic directory. Unless it is a full website."
+       echo
+       echo "You can also download full websites as a ref, as long as it has an index.html file, it will work."
+}