Skip to content

Conversation

amueller
Copy link
Member

Tries to fix the circle failure caused by sphinx-doc/sphinx#3212

@amueller amueller added this to the 0.19 milestone Jun 20, 2017
@amueller
Copy link
Member Author

Just realized this conflicts with #8828. I'm not sure unpinning sphinx is a good idea. Either way seems risky....

@amueller
Copy link
Member Author

ping @lesteve who apparently just did the opposite.

@GaelVaroquaux
Copy link
Member

GaelVaroquaux commented Jun 20, 2017 via email

@amueller
Copy link
Member Author

@GaelVaroquaux thanks, not super urgent.

@glemaitre
Copy link
Member

The issue was linked with the building of the PDF. Calling make latexpdf will failed locally.
Some issue are due to the presence of *.gif which can be used with pdftex --- no idea why it was working before thought.

I will give a look if it is the only issue such that the PDF can be built.

@lesteve
Copy link
Member

lesteve commented Jun 26, 2017

As @glemaitre said the pdf doc generation is broken with sphinx 1.6.2 (I was able to reproduce locally too) and I haven't understood why ... they decided to use latexmk in sphinx 1.6 this could be related or a red herring not sure. As far as I understood there is something in the Makefile that is supposed to convert gif into png for inclusion into the LaTeX document but this is not working for some reason.

Note: the reason CircleCI is green on this one is that you did not kick off the full doc generation. You need [doc build] in your commit message to do that.

@lesteve
Copy link
Member

lesteve commented Jun 26, 2017

From #9030 (comment):

I've updated the plot_cluster_iris.py file so that all 4 plots are now part of 1 subplot and I could see all axis labels as desired. Also added titles to each plot

This is what broke the build on master for the pdf generation. IIRC we are not running pdf generation on PRs because it would take too much time, hence we did not spot this problem while reviewing the PR.

@lesteve
Copy link
Member

lesteve commented Jun 26, 2017

I pushed 1bb8826 into master which should fix the pdf doc generation on CircleCI.

@lesteve
Copy link
Member

lesteve commented Jun 26, 2017

CircleCI build result can be seen here: https://circleci.com/gh/scikit-learn/scikit-learn/11642.

@jnothman
Copy link
Member

jnothman commented Jun 26, 2017 via email

@glemaitre
Copy link
Member

glemaitre commented Jun 26, 2017 via email

@lesteve
Copy link
Member

lesteve commented Jun 26, 2017

I pushed 1bb8826 into master which should fix the pdf doc generation on CircleCI.

CircleCI just finished and is green so I am going to close this one.

@lesteve lesteve closed this Jun 26, 2017
@jnothman
Copy link
Member

jnothman commented Jun 26, 2017 via email

@lesteve
Copy link
Member

lesteve commented Jun 26, 2017

For completeness, a summary of the problem:

  • one example changed and moved 4 different figures into a single one with subplots
  • the pngs of the examples were included in a .rst file. After the change there were only 1 png of 4.This causes a warning in the html doc but an error in the pdf doc.
  • this was not detected in the PR because we are only running the html generation to save time.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants