ORKZ website

This is the website of the Oude RKZ, on www.orkz.net.

Grav

This website is made with Grav. Grav is written in PHP and is a file-based website. It means that it uses only files on your computer, and does not need a database like MySQL. This allows us to place the full website (layout and content) in Github and track changes. It also means that when you download the files to your computer, you have an exact copy of the website, the way that it is online.

Downloading the website to your computer

Windows

1. Install WAMP or XAMP
2. Find the Web folder (eg. c:\wamp64\www)
3. Start WAMP and go to http://localhost to see if it's working
4. Install Git for Windows
5. Start Git Bash
6. cd /c/wamp64/www
7. git clone https://github.com/orxnet/orkz-website
8. Go to http://localhost/orkz-website. You should see 'Run bin/grav install'
9. Go back to Git Bash
10. cd /c/wamp64/www/orkz-website
11. Run /c/wamp64/bin/php/php5.6.35/php bin/grav install
12. Run /c/wamp64/bin/php/php5.6.35/php bin/grav self-upgrade

Linux

1. Install apache: sudo apt install apache2
2. Find the Web folder (eg. /var/www/html)
3. Go to http://localhost to see if it's working
4. Install Git: sudo apt install git
5. cd /var/www/html
6. git clone https://github.com/orxnet/orkz-website
7. Go to http://localhost/orkz-website. You should see 'Run bin/grav install'
8. cd /var/www/html/orkz-website
9. Run bin/grav install
10. Run bin/gpm self-upgrade
11. Run bin/gpm install shortcode-core
12. Run bin/gpm install admin

Pushing your work

1. git status: check which files you changed
2. git diff: check what you actually changed
3. git stash: undo what you changed
4. git pull: pull latest work from online
5. git stash pop: reapply your changes on latest work
6. git commit: commit your work (think of a nice commit message)
7. git push or git push origin master: push your work

Pulling new work

1. git status: check if you dont have any stray changes
2. git stash: undo your stray changes if they are there
3. git log: check which is the most recent commit you have locally
4. Compare with latest commits online.
5. If you are behind: git pull or git pull origin master
6. git log: check if successfully pulled
7. bin/gpm install: install new plugins if the .dependencies file was updated

Getting Started with Grav

• What is Grav?
• Install Grav in few seconds
• Understand the Configuration
• Take a peek at our available free Skeletons
• If you have questions, jump on our Slack Room!
• Have fun!

Exploring More

• Have a look at our Basic Tutorial
• Dive into more advanced functions
• Learn about the Grav CLI
• Review examples in the Grav Cookbook