User Tools

Site Tools


tools:taaabs:doc

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
tools:taaabs:doc [2015/09/04 17:56]
rcazenav
tools:taaabs:doc [2015/09/07 19:46]
rcazenav
Line 18: Line 18:
  
 ===== Clone the project ===== ===== Clone the project =====
- 
 ''git clone git@github.com:liris-tweak/taaabs.git'' ''git clone git@github.com:liris-tweak/taaabs.git''
 +
 ''cd taaabs/'' ''cd taaabs/''
  
 ===== Gulp ===== ===== Gulp =====
- 
 Then, you need to install gulp, as an executable application.  Then, you need to install gulp, as an executable application. 
 ''[sudo] npm install -g gulp'' will install ''gulp'' for you in ''/usr/lib/node_modules/'' and the executable will be available as a link on ''/usr/bin''. ''[sudo] npm install -g gulp'' will install ''gulp'' for you in ''/usr/lib/node_modules/'' and the executable will be available as a link on ''/usr/bin''.
Line 36: Line 35:
  
 ===== Bower ===== ===== Bower =====
- 
 Then, you can install ''bower'', as an executable application. ''[sudo] npm install -g bower'' will install ''bower'' for you in the same way as explained before. Then, you can install ''bower'', as an executable application. ''[sudo] npm install -g bower'' will install ''bower'' for you in the same way as explained before.
  
Line 47: Line 45:
 Then, you must fetch the client-side dependencies of the project: ''bower install''. ''bower'' will read the ''bower.json'' and by default theses dependencies are stored in the ''bower_components/'' directory at the root of the project.  Then, you must fetch the client-side dependencies of the project: ''bower install''. ''bower'' will read the ''bower.json'' and by default theses dependencies are stored in the ''bower_components/'' directory at the root of the project. 
  
 +====== Development Worflow ======
 +
 +===== JSHint =====
 +We use [[http://jshint.com/docs/|JSHint]] to check suspicious usage in the JavaScript code inside Taaabs. This application take JavaScript code, parse it, and do some syntaxic/semantic checking. 
 +
 +When building ''Taaabs'' (using ''gulp'' command), JSHint run a check on all files inside app/ directory. 
 +<note warning>If you ignore these warnings, the building process cannot complete.</note>
 +
 +We suggest you to 
 +I suggest that you regularly scan your code using
 +
 +
 +===== JSCS =====
 +
 +===== Project Directory Structure =====
 +''app/'': Directory containing sources of the application.
 +
 +''bower.json'': A file describing client-side dependencies of the project.
 +
 +''bower_components/'': Directory containing client-side dependencies.
 +
 +''dist/'': Contains the "production" files (this directory can be served by an HTTP server like Apache, Nginx)
 +
 +''gulpfile.js'': File describing the build process.
 +
 +''node_modules/'': Directory containing build dependencies (or server-side dependencies for Node.js based server applications). 
 +
 +''package.json'': A file describing build dependencies of the project. (usually this folder contains server-side dependencies for Node.js based server applications)
 +
 +''.bowerrc'': Configuration file for ''bower''
 +
 +''.jscsrc'': configuration file for JSCS (JSCS is a code style linter for programmatically enforcing your style guide). 
 +
 +''.jshintrc'': configuration file for JSHint (JSHint is a tools to detect suspicious usage in programs written in JavaScript).
 +
 +''wct.conf.json'': A file desbribing Unit tests
 +
 +===== Running the development web server =====
 +
 +When you are modifing sources files of ''Taaabs'', you can see a continuous updated version on your browser.
 +To do this, use ''gulp serve'', and open http://localhost:3000/ in Chromium browser or Chrome browser.
 +
 +
 +===== Run the simple webserver =====
 +''gulp simpleserver''
 +
 +Then open http://localhost:8080/dist/ .
  
tools/taaabs/doc.txt · Last modified: 2018/12/10 13:20 by pchampin

CNRS INSA de Lyon Université Lyon 1 Université Lyon 2 École centrale de Lyon