sphinx-doc/sphinx

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

Open

#6 897 ouverte le 7 déc. 2019

Voir sur GitHub
 (1 commentaire) (1 réaction) (0 assignés)Python (1 985 forks)batch import
builder:latexhelp wantedtype:enhancement

Métriques du dépôt

Stars
 (5 625 stars)
Métriques de merge PR
 (Merge moyen 10j 11h) (11 PRs mergées en 30 j)

Description

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

Guide contributeur