Skip to main content

Static site generator using Markdown and Jinja

Project description

Simple static site generator built from Markdown and Jinja

Three commands to produce three things:

concorde pages  renders Markdown files through a template, producing new pages
concorde index  takes a list of Markdown files that you presumably just rendered
                with pages, orders them by date, and renders them through a
                template to produce an index file
concorde rss    similar to concorde index, but produces an RSS feed instead

Run concorde <command> help for more details.

One distinguishing feature of Concorde is that the templates and the rendered pages do not necessarily have to be HTML. In fact, Concorde was created because of the need to quickly tack on a static blog generator to a site written in PHP.

Concorde is designed to be easily paired with a Makefile to generate a site. For example, given a site laid out like so:

my-example-site
    site
        a-post.md
        another-post.md
    templates
        index.html
        blog-post.html

A Makefile to build the HTML pages, index page, and RSS feed would look like

posts := $(patsubst %.md,%.html,$(wildcard site/*.md))

.PHONY : all clean

all: site/index.html site/rss.xml $(posts)

clean:
    -rm site/index.html
    -rm site/rss.xml
    -rm $(posts)

site/index.html: $(posts) templates/index.html
    concorde index --template=templates/index.html --output=$@ --output-extension=.html site/

site/blog/rss.xml : $(posts)
    concorde rss --output=$@ --title="My Example Blog" --url="http://example.com/rss.xml" site/

$(posts): site/*.md templates/blog-post.html
    concorde pages --template=templates/blog-post.html site/

Project details


Release history Release notifications

History Node

0.1.2

History Node

0.1.1

This version
History Node

0.1

History Node

0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
concorde-0.1.tar.gz (4.0 kB) Copy SHA256 hash SHA256 Source None Mar 10, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page