guilgautier / DPPy

Python toolbox for sampling Determinantal Point Processes
https://dppy.readthedocs.io
MIT License
219 stars 52 forks source link

PDF version of documentation has wrong title and author #59

Closed Naereen closed 4 years ago

Naereen commented 4 years ago

Hi, The PDF version of the sphinx documentation has a wrong title and author:

I'm referring to this document: https://buildmedia.readthedocs.org/media/pdf/dppy/latest/dppy.pdf (on the 2nd of December). It popped out in my Google Scholar feed, as it cited Guillaume's paper @guilgautier, but the title appearing in Google Scholar was weird so I clicked.

I think this bug is very easy to fix, by adding configuration in conf.py. I'll write down here how I did this in some previous project of mine (just later when I'll have my computer). Regards!

Naereen commented 4 years ago

In the conf.py of my web-sphinx website source code (conf.py), I use the following Python code to configure the PDF versions, using the latex_documents setting key:

# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title, author, documentclass [howto/manual]).
latex_documents = [
    ('index.fr', 'LilianBesson.fr.tex', u'Lilian Besson - Page personnelle', u'Lilian Besson', 'howto'),
]
Naereen commented 4 years ago

I think I fixed this issue (I forgot I had direct commit right on this project). I hoped it'll fix the issue in the generated PDF, I'll check tonight.

Naereen commented 4 years ago

I don't understand why the latest built PDF (https://readthedocs.org/projects/dppy/downloads/pdf/latest/) did not include the changes.

guilgautier commented 4 years ago

Hi @Naereen, Thanks for pointing this out! I've just built the docs (is not generated automatically after each commit) and the pdf renders well. Cheers

Naereen commented 4 years ago

Greart @guilgautier thanks for building the doc and telling me!