Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
blocks
htdocs
layout
pages
.gitignore
.travis.yml
Makefile
README.md
deploy_rsa.enc
deploy_rsa.pub
requirements.txt
taxonomies.yaml

README.md

This is the source of sapienshabitat.com.

Build Status

Information architecture and URL design

Rowan has decided against using any type of namespaces in the URL structure. What kind of content you're looking at should become obvious from looking at it. Even though the site is technically a blog, publication dates are not exposed in the URLs.

As an example, here follows the URL of what will be the first article on this site:

http://sapienshabitat.com/wallflower-refuge/

Yes, there will be a ending slash, because that makes working with the source files easier.

There won't be separate taxonomy pages, like /tag/permaculture or /scope/garden. Instead, taxonomies will be revealed on the home page:

http://sapienshabitat.com/

This will basically be a sitemap with various visual areas with the different taxonomic categories.

Additionally, all/some taxonomically related pages will be revealed in the navigation area of each page.

Source format and transformation

Page content is written in Markdown. Each page has its own subdirectory in /pages/. The Markdown files have a YAML header. The YAML metadata includes a taxonomy part with is combined with the project-wide taxonomy.yaml file.

The global taxonomy.yaml file

If we take a Markdown source file with the following YAML header:

---
title: A wallflower refuge
date: 2017-04-30
keywords:
  - wallflower
  - “Erysimum cheiri”
  - “muurbloem”
  - “The problem is the solution.”
  - Bill Mollison
taxonomy:
  author: bigsmoke
  project: schuilplaats
  theme: [low-frequency-gardening]
  scope: garden
---

The meta data will be combined with the meta data defined for each of the taxonomy terms in taxonomy.yaml:

project:
    schuilplaats:
        insert: schuilplaats
        keywords:
            - “De Schuilplaats”
            - Norg
            - Drenthe
            - vakantiehuis
            - vakantiehuisje
        page: schuilplaats-norg
        scope: [landscape, garden]
author:
    bigsmoke:
        author: Rowan Rodrik van der Molen
        insert: bigsmoke
theme:
    low-frequency-gardening:
        keywords:
            - propagule pressure
    forest-gardening:
        keywords:
            - forest gardening
    agroecology:
        keywords:
            - agroecology
            - permaculture