sphinx-doc/sphinx

PDF metadata uses non-standard `&` to separate authors (if `\and` was used in `latex_documents`)

Open

#6.897 geöffnet am 7. Dez. 2019

Auf GitHub ansehen
 (1 Kommentar) (1 Reaktion) (0 zugewiesene Personen)Python (1.985 Forks)batch import
builder:latexhelp wantedtype:enhancement

Repository-Metriken

Stars
 (5.625 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 10T 11h) (11 gemergte PRs in 30 T)

Beschreibung

Here is the relevant code: https://github.com/sphinx-doc/sphinx/blob/364f54cb5597bc6e5b619742492b4cae3067012f/sphinx/texinputs/sphinxmanual.cls#L44-L48

However, Adobe Pro apparently uses ; to separate author names. And it looks as if it also parses ,. I don't have access to such software so I can not check and my information is second-hand.

Some time recently, LaTeX package hyperref modified the behavior of its option pdfusetitle to recognize \and keyword in \author{....} input and to transform it into ; . See here.

Sphinx behavior perhaps is not quite a bug, the problem is at the time I introduced the & I has searched for some official clear guidelines on PDF author data, in case of multiple authors, and failed to find one.

I propose to adopt the ; separator.

Suggestions welcome! If no one opposes I wlll do the change in time for 2.3.0 2.4.0

Relates: #6875

Contributor Guide