:method: role creates wrong url

[wouterj]

We have a very strange error on the documentation. If you take a look at http://symfony.com/doc/current/components/finder.html (or any other article which uses the :method: role) the links to the API docs for methods become something like this: http://api.symfony.com/2.1/Symfony/Component/Finder/Finder.html#exclude() while it should become this: http://api.symfony.com/2.1/Symfony/Component/Finder/Finder.html#method_exclude.

I thought it was an error in the extensions created by Fabian, but that looked correct:

full_url = base_url % full_class.replace('\\', '/') + '.html' + '#method_' + method

The link that is created looks like the old way of generating links. When we changed to the new link format in the API doc generator, @weaverryan had changed this 8 months ago in: fabpot/sphinx-php@a9d5ec5

To me, it looks like the documentation generator uses an old version of the sphinx extensions by Fabien.

/cc @fabpot

@weaverryan this should get a 'website' label

[weaverryan]

@wouterj - nice detective work :). Yes, I completely agree - looks like symfony.com is perhaps using an older version of the sphinx extensions which are causing these :method: links to render incorrectly.

[wouterj]

@weaverryan strangly enough, the :phpmethod: role that I added some weeks ago works correctly on the site.

[wouterj]

ping @fabpot @sensio this issue still exists.

[wouterj]

ping again @fabpot I think it is important to fix this, as broken links in the documentation is not something people like...

[wouterj]

ping @fabpot, this is an urgent bug as nobody likes not working links

[wouterj]

ping @fabpot @sensiolabs @...? Could anybody please take a look at the website issues for a day and fix some of them?

Some important issues:

• :method: role creates wrong url #2156
• Configuration blocks too small #3226
• Documentation search #3023
• [website] Broken images in PDF for CMF documentation #1981
• add more published doc formats (pdf, epub) #1029

[wouterj]

ping @javiereguiluz this is a very important bug which is open for too long if you ask me :)

[stof]

@javiereguiluz can you update the submodule on the doc builder ? The symfony-docs repo points to a fixed version of the extension since months, but it looks like the prod has not updated the submodules since a very long time.

[xabbuh]

ping @javiereguiluz

[Baptouuuu]

problem still existing, the submodule points to the fixed version of sphinx-php. Just need a git submodule foreach git pull where the builder is executed?!