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


Download files

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

Source Distribution

concorde-0.1.2.tar.gz (4.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page