2013-09-23 18:48:27 +02:00
|
|
|
[](http://badge.fury.io/js/local-web-server)
|
|
|
|
local-web-server
|
|
|
|
================
|
2013-06-11 14:49:12 +01:00
|
|
|
Fires up a simple, static web server on a given port. Use for local web development or file sharing (directory browsing enabled).
|
2013-06-04 14:23:50 +01:00
|
|
|
|
|
|
|
Install
|
2013-06-04 14:26:42 +01:00
|
|
|
-------
|
2013-06-04 14:23:50 +01:00
|
|
|
Install [Node.js](http://nodejs.org), then run
|
|
|
|
|
|
|
|
```sh
|
|
|
|
$ npm install -g local-web-server
|
|
|
|
```
|
|
|
|
|
2013-06-04 14:26:42 +01:00
|
|
|
*Linux/Mac users may need to run the above with `sudo`*
|
2013-06-04 14:23:50 +01:00
|
|
|
|
|
|
|
Usage
|
2013-06-04 14:26:42 +01:00
|
|
|
-----
|
2013-06-05 20:16:10 +01:00
|
|
|
From the folder you wish to serve, run:
|
2013-06-04 14:23:50 +01:00
|
|
|
```sh
|
2013-06-21 18:35:12 +01:00
|
|
|
$ ws
|
|
|
|
serving at http://localhost:8000
|
|
|
|
```
|
|
|
|
|
|
|
|
If you wish to override the default port (8000), use `--port` or `-p`:
|
|
|
|
```sh
|
|
|
|
$ ws --port 9000
|
|
|
|
serving at http://localhost:9000
|
|
|
|
```
|
|
|
|
|
|
|
|
Use a built-in or custom [Connect logger format](http://www.senchalabs.org/connect/middleware-logger.html) with `--log-format`:
|
|
|
|
```sh
|
|
|
|
$ ws --log-format short
|
2013-06-04 14:23:50 +01:00
|
|
|
```
|
2013-06-05 20:06:54 +01:00
|
|
|
|
2013-06-15 00:41:43 +01:00
|
|
|
Use with Logstalgia
|
2013-06-15 00:52:03 +01:00
|
|
|
-------------------
|
2013-06-15 00:50:27 +01:00
|
|
|
The "default" log-format is compatible with [logstalgia](http://code.google.com/p/logstalgia/).
|
2013-06-15 00:41:43 +01:00
|
|
|
|
2013-06-15 00:47:51 +01:00
|
|
|
If you wrote your log output to disk, like so:
|
2013-06-15 00:41:43 +01:00
|
|
|
```sh
|
2013-06-15 00:47:51 +01:00
|
|
|
$ ws --log-format default > web.log
|
2013-06-15 00:41:43 +01:00
|
|
|
```
|
|
|
|
|
2013-06-15 00:50:27 +01:00
|
|
|
Then you could visualise in logstalgia with:
|
2013-06-15 00:41:43 +01:00
|
|
|
```sh
|
|
|
|
$ logstalgia web.log
|
|
|
|
```
|
|
|
|
|
2013-06-15 00:47:51 +01:00
|
|
|
Alternatively, pipe directly from ws into logstalgia for real-time visualisation:
|
2013-06-15 00:41:43 +01:00
|
|
|
```sh
|
2013-06-15 00:47:51 +01:00
|
|
|
$ ws --log-format default | logstalgia -
|
2013-06-15 00:41:43 +01:00
|
|
|
```
|
|
|
|
|
2013-06-05 20:06:54 +01:00
|
|
|
[](http://githalytics.com/75lb/local-web-server)
|
2013-09-23 18:48:27 +02:00
|
|
|
[](https://bitdeli.com/free "Bitdeli Badge")
|