amsterdam.github.io

A showcase of Gemeente Amsterdam’s Open Source work, a comprehensive guide on how to contribute to our projects and our vision how we believe Open Source software should be built in Amsterdam.

Adding content

Feel free to make pull requests, we’ll review and merge them as soon as we can. Feel free to edit the MarkDown files, if you are unfamilliar with this, the Mastering MarkDown guide is pretty good

Be sure to read the CONTRIBUTING.md for more information on contributing.

Adding a Guide

We believe that sharing our knowledge will help the development of great Open Source software for Amsterdam and the world.

Our guides are for everyone, whatever their affiliation. They should be general, understandable for ‘beginners’ and not contain too much technical detail. The content of this website should be broadly applicable to every one of our projects, and thus not feature ‘style guides’ etc, those are better at home with projects in their repositories.

To add a guide just make a new markdown file in /guides/. In order to give your guide the right subtitle on the guides page you should add the explains in the Jekyll front matter. Keep the explains short and simple to understand.

---
explains: How to add guides, add pages and change this website
---

Adding a Project

To add a project just make a new markdown file in /projects/. Add an abstract in the front matter as a short description of what the product is.

You can either make a new Project page on this site or link directly to an external repo or product page by adding a link property to the front matter.

---
title: Catalog
abstract: A drop in replacement for CKAN
link: https://github.com/Amsterdam/datacatalog-core
---

Installing, running and building

This site and it’s contents are served over GitHub pages and redered in it’s native static site genrator Jekyll.

More on Jekyll as a static site generator with GitHub.

Installing locally

Install Ruby and it’s package manager Bundler with

gem install bundler

Install the dependencies and Jekyll using

bundle install

Running and serving locally

Run Jekyll, generate the site, watch for changes and serve over a local webserver with

jekyll serve --livereload