Subversion Repositories wimsdev

# WIMS External packages

We use `Yarn` to automatically download JS packages/plugins,
And then we use `Grunt` to perform special tasks (concat, minify, verify ...)

## Installation

### Install Yarn

* See here: [install Yarn](https://yarnpkg.com)

```sh
brew install yarn
```

### Install Grunt

```sh
yarn upgrade
yarn global add grunt-cli
```

## Manage Packages

### Audit each dependency if there is a known issue to fix

```sh
yarn audit
```

### Update Javascripts plugins

```sh
yarn upgrade
```

## Download new Package(s)

```sh
yarn add <package>
```

nb: When upgrading TinyMCE 6, you must also manually download language packs here :
<https://www.tiny.cloud/get-tiny/language-packages/>
(i.e for French: <https://download.tiny.cloud/tinymce/community/languagepacks/6/fr_FR.zip>)

## Migrate files from _packages/ to wims/

  After each update, Grunt is handy to automatically compress js + css, and move each files at is wims destination. simply call "grunt"

```sh
# First, compile JSXGraph
cd node_modules/jsxgraph
npm install
npm run buildCore
# Then, do WIMS things
cd ../..
grunt
yarn run build
```

## Test & Check

After each js package update, look at these URL:

* jquery-ui
  * Tabs : [searchform](http://localhost/wims/?cmd=new&module=home&search_keywords=oef&search_category=A&search_lang=fr#searchform)
  * Menu : [H6/algebra/docnatural.fr](http://localhost/wims/?module=H6/algebra/docnatural.fr)
* jsXgraph
  * [U1/geometry/oeftiling.fr](http://localhost/wims/?module=U1/geometry/oeftiling.fr&cmd=new&exo=translation)
* mathlive
  * ??
* CodeMirror 5
  * slib/coding/editor : [H4/programming/pixelart.fr](http://localhost/wims/wims.html?&cmd=new&module=H4/programming/pixelart.fr)
* jQuery
  * needed at least by Jquery UI
* jQuery-hoverintent
  * ??
* jQuery-ui-Slider-Pips
  * Level filter in "Searching for a teaching material" on WIMS home <http://localhost/wims/>
* slick-carousel
  * "Samples" on WIMS home <http://localhost/wims/>
* Marked
  * <http://localhost/wims/wims.html?module=help%2Fwimsdoc.en&+cmd=new&+style=integral#anstype_content>
* chart.js
  * <http://localhost/wims/wims.html?cmd=new&module=adm%2Fstat%2Fstat&special_parm=module_updates>

## Cleaning

```sh
yarn cache clean
yarn autoclean --force
```

## Documentations

* [Yarn docs](https://yarnpkg.com/docs)
* [Grunt HowTo (video fr)](http://www.grafikart.fr/tutoriels/grunt/grunt-introduction-470)
* [Grunt "getting started"](http://gruntjs.com/getting-started)

## JSXGraph

```sh
cd node_modules/jsxgraph
npm install
npm run buildCore
```