Find a way to have a common format for github restructuredtext parser, sphinx and the efesto app

[robygior]

Sphinx uses some additional directives to generate docs. Those directives are mis-interpreted by standard rest parsers (like the one used by github or the upcoming efesto app).

The main problem is maintaining document references, for Example:

github/efesto will search for HTTP.rst
sphinx will search for HTTP.html

[akx]

What do you mean with Sphinx looking for HTTP.html? Or rather, in which case does it do this? All the intra-docs refs I've done so far have been of the

:doc:`page`

format Sphinx likes. They remain uncooked if Sphinx is unaware of a page page existing in its world.