Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
out
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

About

home

Resources

Releases

No releases published

Packages

No packages published
You can’t perform that action at this time.