Those guidelines for The City of Malmö’s web applications are available for reading at http://malmostad.github.io/wag-v4/. An overview of all available versions of the WAG for our external and intranet web service is available at http://malmostad.github.io/wag/.
Content is written in markdown using the kramdown dialect and the pages are found in the pages
directory in the gh-pages
branch. You can edit the pages in your web browser. Changes and new pages are queued for publishing when you save them and will most often be published immediately.
The publishing is using GitHub Pages witch is a hook that publish a Jekyll site when something in the gh-pages
branch is saved.
You need Ruby 2.x with bundler on your machine.
Checkout the gh-pages
. To install Jekyll and the dependencies, run:
bundle install
Create a feature branch you can work in without triggering immediate publishing. Merge the changes into the gh-pages
branch and push to GitHub to publish your work.
The content pages are found in the pages
directory.
When editing, run Jekyll and tell it to generate pages and assets when they are changed:
jekyll serve --baseurl ""
Go to http://localhost:4000/
The output is generated as a static site in the _site
directory.
The main template is found in _layouts
. All includes including the navigation is in the _includes
directory.
There are a few asset files used for the WAG itself. The source is available in the stylesheets
, _sass
and javascripts
directories. The files are compiled during editing if you have Jekyll running. Otherwise, run jekyll build
.
Push the gh-pages branch to Github and the site will automatically be deployed to http://malmostad.github.io/wag-v4/
See the instructions in our shared assets repository.
Released under AGPL version 3.