How to handle archival builds with gh-pages?

[bebraw]

I deploy the documentation sites of many of my projects through gh-pages. A while ago I realized that instead of nuking the whole site each time I publish, it would be nice to archive the old one below the previous version in the directory tree.

Is there some nice way to pull this off with gh-pages?

[tschaub]

You can use the add option for this. For example, if you wanted to leave old versions around, could do this by building new artifacts in a directory named like the version. For example, build/v1.2.3 would be generated when building v1.2.3. Then you can do this:

ghpages.publish('build', {add: true}, callback);

[bebraw]

Perfect! Thanks a lot.