Displayed some examples in the docs. (#11758)
Displayed some examples in the docs. (#11758)

### Summary

The keras examples are great, but do not benefit from a good visibility. I believe we could add them to the docs. It requires very little work since all the code and docstrings have already been written.

### Related Issues

### PR Overview

There is some black magic at work with `compile`. I took the code from https://gist.github.com/rduplain/1249199

We can control which files get displayed with `mkdocs.yml`. For the moment only two are displayed. Here is the result:

![1](https://user-images.githubusercontent.com/12891691/49258375-88c73200-f435-11e8-8dc9-95c4201bfcbe.png)
![2](https://user-images.githubusercontent.com/12891691/49258377-8a90f580-f435-11e8-81f0-d6fa42df09a9.png)
![3](https://user-images.githubusercontent.com/12891691/49258378-8bc22280-f435-11e8-98d4-df9e6b677aa0.png)

- [ ] This PR requires new unit tests [y/n] (make sure tests are included)
- [ ] This PR requires to update the documentation [y/n] (make sure the docs are up-to-date)
- [x] This PR is backwards compatible [y/n]
- [ ] This PR changes the current API [y/n] (all API changes need to be approved by fchollet)

keras-team/keras-autodoc