An open API service indexing awesome lists of open source software.

https://github.com/nikolas/oblique

An indirect static site generator
https://github.com/nikolas/oblique

Last synced: 6 months ago
JSON representation

An indirect static site generator

Awesome Lists containing this project

README

          

# Oblique

[![Build Status](https://img.shields.io/travis/nikolas/oblique/master.svg)](https://travis-ci.org/nikolas/oblique)

## ¿ ?

An indirect static site generator: it compiles your entries from an
`index.html` file into a full site. By using HTML as the authoring medium,
Oblique removes the markup layer of abstraction, while retaining the
organizational convenience of static site templates. This approach could
be thought of as "static site assembly".

When you make a site with Oblique, the build step is optional. You
can author the content in HTML and have a site that will render just
fine in the web browser. Then, you can use Oblique on whatever
aggregate files you want to create the archived, "detail" pages for
each entry in the aggregate.

For example:

```html

Notes from another time




Today I learned something weird





Well, I never thought I would learn that, but I did.






A note from the roaring 20s





Dear diary, I'd like to tell you everything, but
I can't say it all at once.



```
$ python3 oblique/oblique.py index.html

Given this index page, Oblique's simple job is to archive
the posts into `/-/today-i-learned-something-weird.html` and
`/-/a-note-from-the-roaring-20s.html`.

## Testing

$ source env/bin/activate
$ python setup.py test