Rework api reference in documentation

[itziakos]

This PR changes the way the api reference is autogenerated and rendered.

• The reference documentation is now autogenerated when make html is used and make clean will remove the generated files.
• The modules that will be rendered are disctated by the developer.rst file.
• Each module is rendered using a jinja template.
• The documentation layout is reworked.

note:

• The code includes a patched version of the autosummary extension that does not try to generate documentation for imported items.

[stefanoborini]

Since @itziakos is on vacation, I'll take this over and finish it.

[stefanoborini]

Ok, checked issue #195 means that it's in @itziakos hands as a whole. Postponing it.

[codecov-io]

Current coverage is 93.28% (diff: 100%)

Merging #194 into master will increase coverage by 0.05%

@@             master       #194   diff @@
==========================================
  Files            73         73          
  Lines          3175       3203    +28   
  Methods           0          0          
  Messages          0          0          
  Branches        209        211     +2   
==========================================
+ Hits           2960       2988    +28   
  Misses          151        151          
  Partials         64         64          

Powered by Codecov. Last update 0b766c7...8d7db21

[stefanoborini]

@itziakos The tests now pass. Is this finished?

[itziakos]

👍

[stefanoborini]

@itziakos I will solve the conflicts and merge it.