Skip to content

Commit 96294f8

Browse files
committed
recap post
1 parent c264ac8 commit 96294f8

File tree

6 files changed

+128
-0
lines changed

6 files changed

+128
-0
lines changed
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
layout: post
3+
permalink: /pretzel-review.html
4+
date: 2012-02-06 23:59
5+
title: "Pretzel: Recap"
6+
author: "@aeoth, @shiftkey and @tobin"
7+
comments: true
8+
---
9+
10+
Things were a bit quiet in the chatroom with [@tobin](http://twitter.com/tobin) taking a well-deserved holiday, but we've made a lot of progress on Pretzel - our site generation tool using .NET.
11+
12+
## Current Features
13+
14+
How far did we get this week?
15+
16+
You can setup a new website using these three steps.
17+
18+
![](/img/pretzel-console.png)
19+
20+
This provides the demo site we've configured to help get people started experimenting - including images, styles and a sample post.
21+
22+
![](/img/pretzel-demosite.png)
23+
24+
You can then edit the files in the folder and see the site regenerate
25+
26+
![](/img/pretzel-console-2.png)
27+
28+
![](/img/pretzel-edit.png)
29+
30+
If you want to understand more of how this tool works, have a read of the [Jekyll wiki](https://github.com/mojombo/jekyll/wiki) - this will help understand the concepts that Jekyll uses to differentiate between pages and posts, and how to configure your sites - this should help answer any initial questions users have about getting started with your own websites.
31+
32+
Some other features on top of the site generation underway:
33+
34+
* Wordpress Importing has begun - we'll update the documentation as soon as that is officially ready
35+
* LESS compilation and JS minification within the 'bake' step.
36+
* Razor template support - this is not as far along as our Liquid support, but is an excellent experiment with plugging in other templating engines.
37+
38+
## More Features
39+
40+
As we get time, these features are also planned:
41+
42+
* Liquid extensions - including a decent set of extensions for users to integrate into their themes
43+
* Refining the default project site to be a bit more featureful
44+
* The ideas around mixing static and dynamic content (one big idea was to leverage AppHarbor to support this) didn't get off the ground.
45+
46+
## - Weekly Fun stats
47+
48+
There were 13 contributors this week - some new faces and some familiar ones.
49+
50+
The [punch card graph](https://github.com/Code52/pretzel/graphs/punch_card) from GitHub shows how busy we were across the week.
51+
52+
<img src="https://chart.googleapis.com/chart?chs=800x300&amp;chds=-1,24,-1,7,0,9&amp;chf=bg,s,efefef&amp;chd=t:0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23|0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,4,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,6,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7|0,0,0,0,0,0,0,0,0,0,1,1,2,1,2,0,0,0,1,0,0,1,0,0,0,0,0,0,4,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,5,5,9,1,0,1,1,0,0,0,1,0,0,0,0,1,1,2,3,0,1,3,1,1,3,5,2,0,2,1,0,1,0,0,0,0,3,2,0,1,0,1,0,4,2,5,2,4,5,5,8,2,0,0,0,0,0,0,0,4,5,0,0,0,0,1,1,0,2,1,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,2,0,0,0,0,0,0,1,0,1,3,0,1,0,0,0,0,0,0,1,1,0,0,1,2,0,0,1,1,0,1,3,3,4,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0&amp;chxt=x,y&amp;chm=o,333333,1,1.0,25.0&amp;chxl=0:||12am|1|2|3|4|5|6|7|8|9|10|11|12pm|1|2|3|4|5|6|7|8|9|10|11||1:||Sun|Mon|Tue|Wed|Thr|Fri|Sat|&amp;cht=s">
53+
54+
55+
## What's Next?
56+
57+
The post for the next idea will be up shortly - we've been discussing in the chatroom how to tackle this idea, so stay tuned.

_posts/2012-02-07-metro-dot-css.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
layout: post
3+
permalink: /pretzel.html
4+
date: 2012-01-31 08:00
5+
title: "Pretzel"
6+
author: "@aeoth, @shiftkey and @tobin"
7+
comments: true
8+
---
9+
10+
11+
After an epic week doing game development (which for many of us was new territory), we've picked a project which revisits one of languages we use everywhere with Code52 - Markdown.
12+
13+
## Pretzel
14+
15+
Code52 are big fans of [Jekyll](https://github.com/mojombo/jekyll), the Ruby-based static site generator tool. In fact, the site you are reading leverages output from Jekyll (running on GitHub too - check out the code [here](https://github.com/code52/code52.github.com)) and all our project sites run on top of the same stack (more details [here](http://code52.org/gh-pages.html)).
16+
17+
To develop locally against Jekyll, you need to install ruby and configure your environment to install the right set of gems. **We want to create a tool in this vein which is more friendly for .NET developers - and support for the technologies that they use so that they too can quickly create sites.**
18+
19+
We also want to explore implementing features on top of this Jekyll-like workflow:
20+
21+
* support different templating engines - Razor/Spark/???
22+
* support dynamic content alongside static content - for example using AppHarbor to generate content on-the-fly.
23+
* support for different inputs - could we generate documentation for code using this tool?
24+
25+
But before we head down that road, we want a simple tool to generate our websites.
26+
27+
## Why Pretzel?
28+
29+
We were discussing on JabbR what to name this tool, and someone described the process of generating a site as "baking". A few minutes later, we'd settled on the name "Pretzel" for the tool, rather than some derivative of Jekyll and Hyde.
30+
31+
Conceptually, Pretzel could support two modes - **bake** and **taste**.
32+
33+
**Bake** is for a once-off generation of the site.
34+
35+
To scan the current directory for a website and detect the content to process, run:
36+
37+
pretzel bake
38+
39+
To scan a specific folder and parse the contents, run:
40+
41+
pretzel bake C:\path\to\folder
42+
43+
To explicitly specify the input - we should support inferring the input based on the files found anyway - run:
44+
45+
pretzel bake --engine jekyll
46+
47+
**Taste** is for testing a site locally using a browser - make a change, and Pretzel should detect the file changes and regenerate the site.
48+
49+
To test a site locally (we plan to use [Dragonfly](https://github.com/loudej/dragonfly)), run:
50+
51+
pretzel taste
52+
53+
To specify the port to serve the site from (default will be 4000), run:
54+
55+
pretzel taste --port 5000
56+
57+
58+
There's more ideas that we'll get to over teh course of the week, but this should give people an idea of how the tool should behave.
59+
60+
61+
## How can I get involved?
62+
63+
The initial code is up on [GitHub](http://github.com/Code52/pretzel). The [Trello board](https://trello.com/board/pretzel/4f25ffb3dbbed1ab5a4f0f5a) will be updated over the course of today to define the set of tasks we plan to implement.
64+
65+
Got an feature you'd like to see implemented in Pretzel? Hang out in the chatroom at [JabbR](http://jabbr.net/#/rooms/code52) and join in on the fun!
66+
67+
68+
69+
70+
71+

img/pretzel-console-2.png

14.2 KB
Loading

img/pretzel-console.png

16.1 KB
Loading

img/pretzel-demosite.png

47.9 KB
Loading

img/pretzel-edit.png

19.6 KB
Loading

0 commit comments

Comments
 (0)