home
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
node_modules
out
src
.gitignore
.project
CNAME
README.md
docpad.coffee
foo.txt
npm-debug.log
package.json

README.md

josequesada.docpad

I'm a data scientist. This is the 4th reincarnation of my website. Learning proper js/coffescript is one of my goals, because node's stream-based worldview looks like could be important for analytics-in-motion (vs analytics-at-rest).

This site is done with Docpad, which uses node.js.

Docpad gets lots of updates, and so do the plugins. It's easier to update them all (and docpad), by issuing:

$ npm update

Note the lack of sudo, and npm -g. The install instructions recommend to install docpad globally, but this way it's easier to be up-to-date:

$ ln -s node_modules/docpad/bin/docpad .

Then, use it as:

$ ./docpad 

About the node ecosystem...

1- The package manager kicks ass. if you are used to rvm or virtualenv+pip, the node way of this is refreshing:

  • Everything install locally by default (built-in virtualenv)
  • Semantic versioning (ie, specify what version of a plugin you need)
  • Each package can have isolated dependencies. That is, two packages might be using different versions of a package as a dependency

2- The node aesthetic goes a long way to promote radical reusability. This is very similar to the unix philosophy (do one thing only, and do it well). Packages are tiny, when you install one it looks like it's downloading half the internet: reusability is very high.

For these two reasons, node's community moves at blazing speeds. UPDATE: after ~6m of use... This has one downside: things break all the time. I'd say I have spend more time fixing bugs after updates than actually working on my site. Updating node and docpad is as dangerous as playing with knifes, and I simply won't do it anymore. Buyer beware.

Thanks to:

  • Ben Lupton for docpad. He's very commited to making docpad the best CMS possible. Still too geeky for the masses, but in the future docpad could dethrone wordpress.

  • Ben Delarre for his pagination plugin and sharing the code for his bootstrap-basd docpad blog.