Sunstreet is a minimalistic blog template, specially made for Github pages and can be statically/dynamically served anywhere else too. You can view the demo from here which is my personal blog.
- Responsive --- Try screenify to see how it looks on different devices.
- Single Page App --- Using Routie we have hash based navigation, that is compatible with github pages, and older browsers.
- Minimalistic -- The design was inspired by Medium, and Slidebars demo website.
- Dynamic TOC --- A dynamic table of contents found in the right sidebar Inspired by stackeditor.
- Markdown --- Content written in Markdown format, and compiled on the fly, instead of compiling them into html files then having to upload them.
- Code Hilighting -- HighlightJS is included.
- Github API --- Since contents compiled on the fly this made it possible to also load any document found on github, such as projects' README.md, examples are in demo version.
- Disqus --- Disqus comments plugin, wish SPA hash support.
- Analytics --- Google Analytics with SPA hash support.
- CMS check http://project/cms.html
- Architecture --- We try to follow 12Factor app guidlines.
- Build --- We use Gulp to build, compile and optimize artifacts the project, using
- Serve --- Site can be simply served with
main.jsthe code is is compatible with jshint.
- CSS --- Built by Less for maximum maintability, simplicity, and productivity.
You just download the Demo source (which is latest version) and edit the
content.json to fit your needs.
npm install jshint -gyou'll need this if you're using emacs jshint adhook.
- You clone this repo.
- cd to the project and
- build using
gulp, and run test server using
Contribution and Future features
Small Pull Requrests are much welcome, just don't forget to comment them, as for bigger PRs they might take longer time since I might not have time reviewing them all.
As for future plan here's a humble brain storm:
- JS code modularity and pluggability.
More reliance onDone
content.jsonfile instead of hardcoding any content, e.g disqus configurations
- More improvements on tests
Continuous integration if necessary.Done Done
Copyright (c) 2015 Ismail Marmoush and other contributors. Licensed under the Affero GPL V3. See License