Poet vs Couscous
Poet and Couscous are both open source static site generators. Poet is written in JavaScript and Couscous is written in PHP.
| Property | Poet | Couscous |
|---|---|---|
| Language | JavaScript | PHP |
| Templates | Jade | Twig |
| License | MIT | MIT |
Poet benefits
Poet has your code-blogging back. Renders markdown, jade, or any templated files as posts, tag it up with metadata that's passed into any view engine you want, instant pagination, tag and category views, and home in time for dinner.
View the source for jsantell.com to see an example of Poet in use. Much <3 to Brittany Fedor for the sweet art!
Couscous benefits
Step 1
Write your documentation in Markdown inside your repository, versioned with your code. Couscous will turn those Markdown files to HTML.
Step 2
couscous preview will render the website on your machine. Tweak the default template, fix some typos and the changes will be reflected in real time.
Step 3
couscous deploy will publish your website on the gh-pages Git branch. GitHub will automatically put it online and host it for you.
Step 4
Your website is online, just sit back and relax.