Fleshed out the README.
authorsabadev <dev@sabadev.xyz>
Sat, 3 Jul 2021 16:16:59 +0000 (12:16 -0400)
committersabadev <dev@sabadev.xyz>
Sat, 3 Jul 2021 16:16:59 +0000 (12:16 -0400)
README.md

index 1fd62cb..e90422c 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1 +1,22 @@
 # website
+
+## Build and run instructions
+
+Install Vagrant and VirtualBox.
+After running `vagrant up`, run `vagrant rsync-auto` in the background so that file changes on your host machine can be propagated to the virtual machine.
+Use the following git aliases to make it easier to run the custom provision commands:
+
+    [alias]
+        build = !vagrant provision --provision-with build
+        deploy = !vagrant provision --provision-with deploy && sftp -P 2822 -b getTarBz.sh root@localhost && sftp -b putTarBz.sh root@example.com
+        run = !vagrant provision --provision-with run
+        runconf = !vagrant provision --provision-with runconf
+        test = !vagrant provision --provision-with test
+
+## Serving files
+
+Create a directory called `static`, and place some markdown files with the `.md` file extension.
+One of these files must be called `index.md` as it serves as the main page of the website.
+
+To host images, create a directory in `static` called `img` (i.e. `static/img`).
+Place some image files in `img`, and refer to these images in the markdown files using `image/file.png`.