node-html
v1.0.0-beta.65
Published
Rapid prototyping & building of pages/apps in as few lines as possible.
Downloads
88
Maintainers
drschwabeReadme
node-html
For rapid prototyping & building of webpages or apps in as few lines as possible.
node-html is small lib with a set of convenience functions to get you quickly going with a functional HTML/CSS/JS page or app - including one-liners for generating an HTML skeleton, starting an Express server, serving a static directory, and building a client-side bundle (compile or watch)
The watch & compile functions are pre-configured to accommodate using ES6 module import + CommonJS require formats at the same time - such that you can use either format including both formats in the same JS file if you so please.
usage
npm install node-html//In my nodejs file ie: server.js
const no = require('node-html')api
htmlno.html(css,body,script)
Outputs an HTML skeleton string. Optionally provide CSS (in the form of a raw CSS string), HTML content to go in the body, or a script filename. See template
no.html(null,`<h1>hello world</h1>`, 'client.bundle.js')
// <html><head><style></style></head><body>
// <h1>hello world</h1>
// <script src="client.bundle.js"></script>
// </body></html> makeIndexno.makeIndex(path,html)
Writes an HTML file to the filesystem. Provide an optional path (defaults to cwd + 'index.html') and html (string) If html is not provided it will write the default no.html() skeleton.
let html = no.html(null,`<h1>hello world</h1>`, 'client.bundle.js')
no.makeIndex(null,html)
// outputs index.html to cwd with the html output from previous exampleserverno.server(port)
Creates and returns an Express web server on optional port (default 8000).
no.server(8555)
// Express server created at: http://localhost:8555staticno.static(route, directory)
Serves a given filesystem directory with optional route. Run this after no.server()
Both params are optional, will use '/' and your cwd by default.
no.server()
no.static()
//^ all files in your cwd now being served by Express
no.static('/assets', __dirname + '/assets')
//^ or call on specific directoriesindexno.index(html, port)
Serves the given html (string) at optional port. If a server is not already running it will be created.
no.index( no.html(null,null,'myscript.js') )
// http://localhost:8000/ now serving a blank HTML page + <script src="myscript.js">cssno.css(html, port)
Returns a string containing Tailwind CSS
no.html(no.css,`<h1 class="text-green-500">Now we can use CSS</h1>`))
// > HTML skeleton with the above h1 tag in the <body> and Tailwind CSS loaded into the <head><style> tagjqueryno.jquery()
Let's you run jquery on a given string of HTML, useful in conjunction with no.html() for quickly hacking in some content in your HTML skeleton. A wrapper for cheerio.load
let $ = no.jquery( no.html() )
$('body').append( `<h1>hello world</h1>` )
$('h1').html( `<h1>hello flat world</h1>` )
$.html()
// <html><head></head>
// <body>
// <h1>hello flat world</h1>
// </body></html>compileawait no.compile(watch, compress, clientJsName, bundleName)
Runs browserify with a preconfigured set of transforms including stringify and babelify (and Babel presets,plugins, and additional pre-configuration).
Supply booleans as first params to indicate whether to watch or compress the bundle, and specify a clientJsName (ie- the script you want bundled) as well as output bundle name (if the latter two params are not provided will default to client.js and client.bundle.js)
This 'holy grail' build configuration if all goes well should allow you to use ES6 imports and Node/CommonJS require calls interchangeably. And allows you to require .html, .css, and .svg extensions.
let html = no.html(null,null, 'client.bundle.js')
no.makeIndex(html) //< writes the html to disk
await no.compile(false,true)
//> outputs a compressed bundle of a file called `client.js` in your cwd watchno.watch(clientJsName, bundleName)
Alias for no.compile(true,false) this will watch the optional clientJsName and output bundleName (defaults to client.js and client.bundle.js)
let html = no.html(null,null, 'client.bundle.js')
no.watch(null, '/public/client.bundle.js')
//> creates a bundle of a file named `client.js` and ouptuts to /public/client.bundle.js
// rebundles anytime you make changes to client.js including any changes to modules within it loaded via import or requireAlso note: this particular build configuration makes for a rather system intensive process, especially when watching.
compressno.compress(inputScript, outputTarget, options)
Standalone compress function, uses UglifyJS.minify
Pass raw script input, optional output target (otherwise defaults to bundle.js), and optional options obj which is subsequently passed as compress options obj to UglifyJS's Minify API.
const scriptPath = './public/myBundle.js'
const script = fs.readFileSync(scriptPath, 'utf-8')
no.compress(script, scriptPath, { drop_console : true })
//> ./public/myBundle.js now significantly smaller and no console.log outputMIT