Installation instructions in README
This commit is contained in:
@@ -1,6 +1,58 @@
|
||||
YellowLabTools
|
||||
==============
|
||||
# Yellow Lab Tools
|
||||
|
||||
Online tool designed to help Front-End developers optimize their website
|
||||
|
||||
[](https://gemnasium.com/gmetais/YellowLabTools)
|
||||
[](https://gemnasium.com/gmetais/YellowLabTools)
|
||||
|
||||
|
||||
## How it works
|
||||
|
||||
The tool is based on the fabulous [Phantomas](https://github.com/macbre/phantomas) by Maciej Brencz, that loads a page and collects many web performance metrics.
|
||||
I rewrote some modules to deeper analyse Javascript interactions with the DOM (especially with jQuery).
|
||||
And then it is wrapped inside a small server (inspired by my favorite tool: [WebPageTest](http://www.webpagetest.org/)).
|
||||
|
||||
**There are so many things left to do, your help would be greatly appreciated! Please report bugs, ask for evolutions and come code with me.**
|
||||
|
||||
|
||||
## Install your own instance
|
||||
|
||||
### Manual installation
|
||||
|
||||
You need this 3 brothers: [Git](http://git-scm.com/downloads), [NodeJS](http://nodejs.org/download/) and [Bower](http://bower.io/#install-bower). Click on the links to know how to install them.
|
||||
|
||||
1) Clone this repository somewhere on your computer:
|
||||
```shell
|
||||
git clone https://github.com/gmetais/YellowLabTools.git
|
||||
```
|
||||
|
||||
2) Get inside the newly created folder and install the dependencies:
|
||||
```shell
|
||||
cd YellowLabTools
|
||||
npm install
|
||||
bower install
|
||||
```
|
||||
|
||||
3) Launch the server
|
||||
```shell
|
||||
node server.js
|
||||
```
|
||||
|
||||
4) Open you browser to [http://localhost:8383](http://localhost:8383). The default port 8383 can be changed in `server_config/settings.json`.
|
||||
|
||||
|
||||
### In a virtual machine with Vagrant
|
||||
|
||||
You need VirtualBox & Vagrant.
|
||||
|
||||
1) Clone this repository somewhere on your computer:
|
||||
```shell
|
||||
git clone https://github.com/gmetais/YellowLabTools.git
|
||||
```
|
||||
|
||||
2) Get inside the newly created folder and build the virtual machine:
|
||||
```shell
|
||||
cd YellowLabTools
|
||||
vagrant up
|
||||
```
|
||||
|
||||
3) Open your browser to [http://10.10.10.10](http://10.10.10.10).
|
||||
|
||||
@@ -3,13 +3,13 @@
|
||||
# APT-GET
|
||||
sudo apt-get update
|
||||
sudo apt-get install lsb-release -y --force-yes
|
||||
sudo apt-get install curl git -y --force-yes
|
||||
sudo apt-get install curl git python-software-properties -y --force-yes
|
||||
|
||||
# Installation of NodeJS
|
||||
curl https://raw.githubusercontent.com/creationix/nvm/v0.12.2/install.sh | bash
|
||||
sudo add-apt-repository -y ppa:chris-lea/node.js
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y nodejs
|
||||
source ~/.profile
|
||||
nvm install v0.10.30
|
||||
nvm use v0.10.30
|
||||
|
||||
# Installation of some packages globally
|
||||
npm install bower -g
|
||||
@@ -22,7 +22,7 @@ cd /space
|
||||
git clone https://github.com/gmetais/YellowLabTools.git --branch master
|
||||
cd YellowLabTools
|
||||
npm install
|
||||
bower install --config.interactive=false
|
||||
bower install --config.interactive=false --allow-root
|
||||
|
||||
# Start the server
|
||||
rm server_config/settings.json
|
||||
|
||||
Reference in New Issue
Block a user