stenington / hacktivity-kit

A Hackasaurus hack jam how-to

This is the content for the hackasaurus.org hacktivity kit.

Prerequisites

Conversion toolchain

Prince does not offer as full-featured support for JavaScript as modern browsers do. To allow the use of libraries like jQuery (which Prince currently cannot handle) the files get "compiled" into static HTML before feeding them to Prince.

jsdom

vandegraaff.js is a node.js script that uses jsdom to load the page, allow any initial JavaScript to run, and dump a static HTML version out. This gets sent to...

Prince

You need Prince 8.0 to generate the PDF version of the kit. The free version is fine.

Sample command

cat kit.html | node vandegraaff.js | prince -s stylesheets/print.css -o kit.pdf -

This creates kit.pdf that you can open with your favorite PDF viewer.

With -v, Prince may report errors like:

prince: kit.html:9: error: Tag section invalid<

These don't affect processing and should disappear with upcoming releases of Prince.

Testing

Ideally, all tests should be viewed in both a browser and converted to PDF to ensure compatability in both scenarios. The strategy above should work for QUnit pages, which can be compiled to static HTML and viewed in a browser for pass/fail status.

hacktivity-kit's Issues

Table of Contents

Is there a way to remove the ordered list in the table of contents on the page 1 of the pdf?
Additionally, there should be a title (h1?) on the page as well- so that should read "Table of Contents"

Resources

The current resources section is empty. Figure out how each resource is going to be included in the web and pdf versions of the kit.

Tips

The tips should be italicized- and called out a little.

Some of this will be addressed when we do a deeper dive into design, but I think for now we can just keep it simple and italicize any "Tip" in the document.

FF cross domain font-face problem

The webfonts used on hackasaurus.org show up in the kit in Chrome but not Firefox. Firefox has some cross domain protection that would need to be circumvented for this to work, like so: http://www.cssbakery.com/2010/07/fixing-firefox-font-face-cross-domain_25.html

Add learning rubric

Build the learning rubric from pg 27-28 of the hacktivity kit into the web/prince version.

copyright

Is it possible to make the link clickable? If so then I would just make the word "license" available and have license link to the licensing website.

© 2011 by individual mozilla.org contributors. Content available under a Creative
Commons license. http://www.mozilla.org/foundation/licensing/website-content.html