Git Product home page Git Product logo

ssg's Introduction

Static Site Generator

Code Climate

Introduction

Static site generator is a toy of mine, since many python static blog generators are pretty large, and intimidating. This is an exercise to make a simple framework for static site generation. On top of this a blog engine has been written.

Static Site Generator basics

In its most basic form Static Site Generator (hereafter ssg), takes a bunch of files written in Markdown and converts them into HTML files.

There is more to it though. After converting the Markdown into HTML, the whole thing is processed by the Jinja2 template engine. A lot can be done solely in the Jinja2 templates, but some steps in the conversion can be hooked into, by extending ssg. I test ssg on my blog, the engine is made by extensions to ssg, and Jinja2 templates.

ssg

The main Static Site generator executable is called `ssg`. This is a Python command line program.

Command line options

-d, --debug Print debug information.
-s, --site_url Set the site URL.
--write-all Write all files, instead of updating.
-r, --root Set the root directory of the site. Default is current directory.
-c, --create-site
ย Create a directory skeleton and config file for a new site. Defaults to current directory.

ssg's People

Contributors

deadbok avatar

Stargazers

Cristian Iacobanu avatar

Watchers

 avatar James Cloos avatar

ssg's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.