Tag: npm

Posted on

Antora generates static documentation sites from AsciiDoc

A static site generator for making documentation sites from one or more versioned content repositories.

A documentation pipeline that enables docs, product, and engineering teams to create, manage, remix, and publish documentation sites composed in AsciiDoc and sourced from multiple versioned content repositories.

See details at https://antora.org/ and get the code at https://gitlab.com/antora/antora

Antora is designed to generate and manage static, versioned documentation sites using AsciiDoc. Works with git across multiple repos to pull together documentation for a project into a single site.

Posted on

Use npm shrinkwrap to manage dependencies in your node app

The reason to use npm’s shrinkwrap feature is that, while you can fix the versions of your direct dependencies in your package.json, you can’t fix the versions of their dependencies, which may be quite loosely specified. This means that if you or someone else rebuilds the image at some future time, you can’t guarantee (without using shrinkwrap) that it won’t pull down a different version of some indirect dependency, breaking your app. This seems to happen to me much more often than one might expect, so I advocate using shrinkwrap. If you are familiar with ruby’s excellent bundler dependency manager, npm-shrinkwrap.json is much like Gemfile.lock.

Source: Lessons from Building a Node App in Docker

Dependencies in the node ecosystem can be a real pain in the ass. Some relief can be had by using npm shrinkwrap to manage the dependencies of your dependencies.

Posted on

Calypso interface used to manage WordPress.com blogs now open source

A single interface to manage all your WordPress.com or Jetpack-enabled sites, built with the latest web technologies and used by millions of people — and now it’s open source.

https://developer.wordpress.com/calypso/

This could present a radical change for managing the Classcaster network. Written in JavaScript and powered by Node.js, Calypso leverages the REST API in WordPress. Check out the code on Github at  https://github.com/Automattic/wp-calypso.