VLOCA-portal
Jekyll based web site for the Flemish government "Vlaamse Open City Architectuur" initiative. Refer to https://www.vlaanderen.be/vloca for more info on VLOCA itself..
Branches in this repo
Three branches are significant:
- dev: gathers commits from developers. Start your work here. Always unless you know your specific work should not start here.
- test: after checks by ABB this branch deploys to the test site URL.
- master: deploys to https://www.vlaanderen.be/vloca
Build the site
Download the repository.
- Install jekyll. See https://jekyllrb.com/docs/installation/ ; on Windows 10, see below.
- Run
jekyll build
in the repository root.
- Serve the files in
/_site
on a webserver or use jekyll s
and browse to https://localhost:4000 (unless you've changed that).
Building on Windows 10
Ruby and Windows are not the ideal combination. But :-)
Windows 10 now has the Windows Subsystem for Linux. See https://docs.microsoft.com/en-us/windows/wsl/wsl2-index and https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux to know more.
Installing Ruby and Jekyll becomes very easy using WSL!
- Install your favourite distro from the Microsoft Store.
- Install git and ruby-bundler.
- In Ubuntu:
sudo apt-get install git build-essential bundler
- Next clone the repository from WSL.
git clone https://github.com/Agentschap-Binnenlands-Bestuur/vloca-portal.git
- Install ruby requirements:
cd vloca-portal
bundle install
- Serve the site:
- As of Windows 10 1903 there is safe file sharing between W10 and running WSL environments.
- Explorer and your favourite editor can open files in your WSL environment via `\wsl$\Ubuntu\
- If you don't have a favourite editor yet, install Visual Studio Code, which doesn't need admin privileges: https://code.visualstudio.com/?wt.mc_id=vscom_downloads
- Pay attention to the branch you're working in! Don't work in test or master!