Jeff Escalante jescalan

Helpful Node Tools

greenkeeper
when one of your projects' dependencies releases a new version, creates a pull request to update it
install: npm i greenkeeper -g, run: gk enable
npm-check
command line tool which checks your projects dependencies, tells you when there are any out of date, upgrades them
install: npm i npm-check -g, run: npm-check -u
fixpack
checks your package.json file to make sure it has important fields, organizes fields consistently

Spike `v0.11.0` Migration Guide

In this release of spike, we switch posthtml for reshape. Reshape is a complete rewrite of posthtml by the static-dev team with several significant differences:

It returns a function by default, so that its results can be used as client-side templates
It has a much more clear and robust error reporting system, reporting errors that include the line/col in the original source, and exposing a code snippet to show where it came from
It has more clearly written documentation, more thorough tests, consistent code style, and 100% coverage on all core modules

However, as a consequence of this move, the jade plugin is no longer available. The jade plugin was always a hack, and had several crippling caveats. In addition, jade does not fit well with reshape's philosophy of breaking functionality down into small modules. As such, we have replaced ja

Using Named Functions

In javascript, there are two methods of declaring functions that are seen frequently. They are similar in many ways, but there are a few ways in which they are different. The first one is called a named function. This is how it looks:

function test(){
  console.log('hello world!');
}

"A beginning programmer writes her programs like an ant builds her hill, one piece at a time, without thought for the bigger structure. Her programs will be like loose sand. They may stand for a while, but growing too big they fall apart.

Realizing this problem, the programmer will start to spend a lot of time thinking about structure. Her programs will be rigidly structured, like rock sculptures. They are solid, but when they must change, violence must be done to them.

The master programmer knows when to apply structure and when to leave things in their simple form. Her programs are like clay, solid yet malleable."

-- Master Yuan-Ma, The Book of Programming

Keybase proof

I hereby claim:

I am jescalan on github.
I am je (https://keybase.io/je) on keybase.
I have a public key whose fingerprint is 6491 2DC4 0D77 ADFF DCAD D2D3 E9E9 CDDA D7FD 94AA

To claim this, I am signing this object:

Stylus Plugin Use

This document will briefly review a few of the more common ways of using stylus plugins for those who are not familiar. Throughout these examples, we will be using a non-existant stylus plugin called example. Please change example out for whatever plugin you are actually trying to use!

Standalone/Node

First example is for if you are building your own stylus pipeline in node. This is a pretty standard way to do things.

	function serializeVerbatim (obj) {
	let i = 0
	const fns = []
	let res = JSON.stringify(obj, (k, v) => {
	if (typeof v === 'function') {
	fns.push(v.toString())
	return `__REPLACE${i++}`
	} else {
	return v
	}

	axis = require 'axis'
	js_pipeline = require 'js-pipeline'
	css_pipeline = require 'css-pipeline'
	roots_config = require 'roots-config'
	W = require 'when'
	readdirp = require 'readdirp'

	siteFiles = []

	# generate files for sitemap

	package main

	import "fmt"

	type Vertex struct {
	X, Y int
	}

	func main() {
	v := new(Vertex)

	/**
	* Requires a library, but only loads it when it's actually used.
	*
	* lazy_require('fs');
	* fs.readFileSync('example.js');
	*
	* var wow = lazy_require('fs');
	* wow.readFileSync('example.js');
	*
	* @param {String} lib - name of the lib you want to load