Source for www.builtwithdart.com
This website is built using a similar (but smaller) set of tools to the dartlang website, described on Seth Ladd's blog. At the minimum, you will need Jekyll, a ruby based static site generator.
To run the site locally:
- Check out the code from github
- Change into the
/src/site
folder - Run jekyll from the command line
- Browse to http://localhost:8091 and you should see the site.
The static output generated by jekyll is deployed to google appengine. You should normally not need to worry about this if you just want to see what your pages look like.
- Create a folder in the relevant
/projects
subfolder, eg:/projects/apps/awesome/
- Create an index.md file by copying the
/project/template.md
file, eg: `/projects/apps/awesome/index.md' - Edit the
_includes/header.html
file to add a link to your project on the menu, eg:<li><a href="/projects/apps/awesome/">RGB Cube</a></li>
- Add some screenshots or other images into your project's folder, eg:
/projects/apps/awesome/myapp.png
- Fill in the various fields in your
index.md
and add some text - Git Add, Commit and Push, then make a pull request on github. (Contact me if you need help - I'm happy to do this if you send over some text and images!)
The template.md
file looks like the following. The part between the ---
forms the top part of the page, and injects some meta-data into the html.
---
layout: project
title: 'Your Project Title Here'
download_url: http://<Download URL for your project>
added: <19/Nov/2012 - NOW>
updated: <If you're editing, update this>
description: 'My Awesome Project creates Foos in Dart'
author_name: Your Name
author: http://<a link to your G+ url>
mainimage: myproject.png
author_image: https://profiles.google.com/s2/photos/profile/1234567890 -> The long number from your G+ url - OPTIONAL
source: http://<github/myAwesomeProject (or other source url) - OPTIONAL
homepage: http://my.awesome.project - OPTIONAL
forum: http://groups.google (or other discussion forum) - OPTIONAL
blog: http://<blog.myAwesomeProject - OPTIONAL
---
### Author's Notes
TODO: Enter some text about your project
### Demos
[Launch Demo](http://my.demo.url)
![My Demo Screenshot](screenshot.png)