upstream/ipython Commit - r17453:2dcca9be

13

14

We are moving to a model where our JavaScript dependencies are managed using

14

We are moving to a model where our JavaScript dependencies are managed using

15

[bower](http://bower.io/). These packages are installed in `static/components`

15

[bower](http://bower.io/). These packages are installed in `static/components`

16

and committed into our git repo. Our dependencies are described in the file

16

and committed into a separate git repo [ipython/ipython-components](ipython/ipython-components).

17

Our dependencies are described in the file

17

`static/components/bower.json`. To update our bower packages, run `fab update`

18

`static/components/bower.json`. To update our bower packages, run `fab update`

18

in this directory.

19

in this directory.

19

20

Because CodeMirror does not use proper semantic versioning for its GitHub tags,

21

we maintain our own fork of CodeMirror that is used with bower. This fork should

22

track the upstream CodeMirror exactly; the only difference is that we are adding

23

semantic versioned tags to our repo.

24

25

## less

21

## less

26

22

27

If you edit our `.less` files you will need to run the less compiler to build

23

If you edit our `.less` files you will need to run the less compiler to build

28

our minified css files. This can be done by running `fab css` from this directory.

24

our minified css files. This can be done by running `fab css` from this directory,

25

or `python setup.py css` from the root of the repository.

26

If you are working frequently with `.less` files please consider installing git hooks that

27

rebuild the css files and corresponding maps in `${RepoRoot}/git-hooks/install-hooks.sh`.

29

28

30

## JavaScript Documentation

29

## JavaScript Documentation

31

30

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

             We are moving to a model where our JavaScript dependencies are managed using
             [bower](http://bower.io/). These packages are installed in `static/components`
-            and committed into our git repo. Our dependencies are described in the file
+            and committed into a separate git repo [ipython/ipython-components](ipython/ipython-components).
+            Our dependencies are described in the file
             `static/components/bower.json`. To update our bower packages, run `fab update`
             in this directory.
-            Because CodeMirror does not use proper semantic versioning for its GitHub tags,
-            we maintain our own fork of CodeMirror that is used with bower. This fork should
-            track the upstream CodeMirror exactly; the only difference is that we are adding
-            semantic versioned tags to our repo.
             ## less
             If you edit our `.less` files you will need to run the less compiler to build
-            our minified css files.  This can be done by running `fab css` from this directory.
+            our minified css files.  This can be done by running `fab css` from this directory,
+            or `python setup.py css` from the root of the repository.
+            If you are working frequently with `.less` files please consider installing git hooks that
+            rebuild the css files and corresponding maps in `${RepoRoot}/git-hooks/install-hooks.sh`.
             ## JavaScript Documentation