Doc: Add some odoc generated html files to the rdbg section of the user guide

also, use (back) the odoc make rule now the image has been updated

Because currently, the docker image that  builds the pages via the CI
can not run odoc as it require a more recent dune version. It is because
this image used opam 1

using opam 2 would fix this. will do latter

- do not hard-code the size of the graph in the ml files
- do not print the whole state of big graphs. Indeed, for graphs of
  10000 nodes, if we print the path (which is itself an array of size 10000)
  we obtain 100 000 000 variables, which is too much for the rif file.

(i.e., fold_left instead of map + flatten + @)

Indeed, for graphs of 10000 nodes on the dfs, we need to operate
on list of 100 000 000 variables, which overflow the stack.

to be consistent with  the behavior of lv6 and lutin  (and work with the
lurette stdin.stdout mode), and so that lurette works with sasa !

as it is where they belong.

Indeed, during the explanations, it makes more sense to start with the state.

Doc: rework the documentation of the Algo API.

Its basename is the basename of the name of the .dot file.

Also provide a =--gen-register= option generates such a registring ml
file. --gen-register also generate a state.ml skeleton file.

The Makefile test/Makefile.inc also suppose that the types of the state
is defined in state.ml

To do that, I've reorganized the code

Test: with ocaml 4.08, it is impossible to load the same function twice.
Hence the need to define p.mli files for graphs with several nodes.

Also, track missing files and the alea-coloring exemples.

- the move_count node was wrong (missing parenthesis)
- the lemma an the theorem only holds for locally central unfait demon