Bug 2180476

Summary:	python-pelican fails to build with Sphinx 6.1.3
Product:	[Fedora] Fedora	Reporter:	Karolina Surma <ksurma>
Component:	python-pelican	Assignee:	Matthias Runge <mrunge>
Status:	CLOSED ERRATA	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	rawhide	CC:	gwync, mr.marcelo.barbosa, mrunge
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	python-pelican-4.8.0-1.fc39	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2023-04-12 06:29:59 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	2135122

Description Karolina Surma 2023-03-21 14:36:11 UTC

python-pelican fails to build with Sphinx 6.1.3 in Fedora 39 (currently Rawhide).

For the logs from testing build attempts, see:
https://copr.fedorainfracloud.org/coprs/ksurma/sphinx-6.1.3/package/python-pelican/

You can test you package in mock running:

$ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-6.1.3/fedora-rawhide-x86_64/ --no-clean your.src.rpm
$ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-6.1.3/fedora-rawhide-x86_64/ shell

The issue detected:

Exception occurred:
File "/usr/lib/python3.11/site-packages/sphinx/ext/extlinks.py", line 103, in role
title = caption % part
        ~~~~~~~~^~~~~~
TypeError: not all arguments converted during string formatting

It's an error in configuration.
To resolve, edit the documentation `conf.py` and correct the `extlinks` definition to contain exactly one `%s` in the captions, eg.

Bad:
'github': ('https://github.com/%s', '')

Good:
'github': ('https://github.com/%s', '%s')

Sphinx 6.1.3 will be included in Fedora 39.
Let us know here if you have any questions. Thank you!

Comment 1 Karolina Surma 2023-04-05 09:30:55 UTC

Hi,

This is a friendly notice that Sphinx 6.1.3 will be shipped to Fedora Rawhide on April 13th. This package - unless fixed - will start to FTBFS.
I'll be happy to help with fixing the issues, should you need it.
If this package has already been handled, please ignore this message and ideally close the ticket. Thank you!

Comment 2 Matthias Runge 2023-04-12 05:56:12 UTC

Thank you!

https://github.com/getpelican/pelican/commit/33aca76d78601f0f0da635c8a14c89bbbc9ff8d6 is the necessary patch to apply

Comment 3 Fedora Update System 2023-04-12 06:27:43 UTC

FEDORA-2023-84baaba8fb has been submitted as an update to Fedora 39. https://bodhi.fedoraproject.org/updates/FEDORA-2023-84baaba8fb

Comment 4 Fedora Update System 2023-04-12 06:29:59 UTC

FEDORA-2023-84baaba8fb has been pushed to the Fedora 39 stable repository.
If problem still persists, please make note of it in this bug report.