Readthedocs.org: pdf generation fails after a 'libpng error: Not a PNG file'

[Abdelkrim]

Details

Building the documentation on my local machine works.

The document contains images such as this one:

Deploying the project documentation on rtfd fails due to a 'libpng error: Not a PNG file' due to the above mentioned image

• Read the Docs project URL: https://readthedocs.org/projects/alt-f1-software-architecture
• Build URL (if applicable): https://readthedocs.org/projects/alt-f1-software-architecture/builds/10589242/
• Read the Docs username (if applicable): Abdelkrim

Expected Result

the build succeeds

Actual Result

an error appears during the build :

/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1pcr.fd)libpng error: Not a PNG file

!pdfTeX error: pdflatex (file ./Value-Chain-1198x619.png): libpng: internal err
or
==> Fatal error occurred, no output PDF file produced!
Latexmk: Index file 'alt-f1-software-architecture.idx' was written
Failure to make 'alt-f1-software-architecture.pdf'
Collected error summary (may duplicate other messages):
pdflatex: Command for 'pdflatex' gave return code 256
Latexmk: Errors, in force_mode: so I tried finishing targets

Thank you in advance for the time you will invest on my issue

[stsewd]

@Abdelkrim do you see the same problem when you build your docs locally in a clean environment? If so, this isn't a read the docs problem.

[Abdelkrim]

@stsewd the pdf is generated by sphinx.

• I have executed the same command line as RTFD on my machine and the PDF was correctly generated

  • latexmk -r latexmkrc -pdf -f -dvi- -ps- -jobname=alt-f1-software-architecture -interaction=nonstopmode

• the pdf : SoftwareEngineeringByALT-F1.pdf

• the image generating the error :

• the logs from sphinx while generating the pdf : generate_pdf.txt

thank you for you support

[humitos]

@Abdelkrim you are using Git LFS in that file (https://bitbucket.org/altf1be/software-architecture/src/master/source/_static/img/business-to-you.com/Value-Chain-1198x619.png) which is not supported for now. See https://github.com/readthedocs/readthedocs.org/issues/1846 for more information.

I'm closing this one, but feel free to re-open if you consider.

Thanks!

[Abdelkrim]

@humitos thank you for the support. I didn't think about Git LFS!

[Abdelkrim]

For those who got the issue, here is THE solution : https://github.com/readthedocs/readthedocs.org/issues/1846#issuecomment-477096309