The slow local documentation build might be due to downloading Weblate's icons.

[saierXP]

When I tried to build the Chinese documentation locally, I found that there were hundreds of download requests to Weblate during the build process, and the amount of data requested was the same.

Investigating conf.py, I discovered that it should be the Weblate widget in rst_epilog that needs to download images. After downloading the Chinese Weblate images locally and changing the image address to an absolute local path, the build time was reduced to within a few minutes instead of more than half hour.

Additionally, I only found one reference to a weblate-widget in index.rts. Is there another way to implement it instead of downloading weblate images for every document page?

godot-docs/conf.py

Lines 309 to 318 in c37184a

	rst_epilog = """
	.. |weblate_widget| image:: https://hosted.weblate.org/widgets/godot-engine/{image_locale}/godot-docs/287x66-white.png
	:alt: Translation status
	:target: https://hosted.weblate.org/engage/godot-engine{target_locale}/?utm_source=widget
	:width: 287
	:height: 66
	""".format(
	image_locale="-" if language == "en" else language,
	target_locale="" if language == "en" else "/" + language,
	)

The built index page still needs to be online to download this translation status icon, which is completely pointless.

[mhilbrunner]

Oooh, good catch, if that is indeed the reason for the slow local builds you have just become a strong candidate for my person of the year and we're not even out of january. Will have to investigate after the 4.6 release, thank you!

[mhilbrunner]

@saierXP Can you provide more details on how exactly you observed this? How did you build, and how did you catch the requests?

I couldn't reproduce this when building the docs and looking at outgoing traffic with Wireshark or a router, both for the english and CN docs. I removed the rst_epilog for testing and that did reduce the build times from ~33m to ~31m.

[saierXP]

Upon further investigation, it was found that this issue occurs when building the epub, but not when building the html. Because I wanted to create a pdf through the epub, I first tried the epub. Later, since the pdf quality was not good, I tried building the html and converting it to pdf through a browser.

When making epub, the build speed was indeed significantly improved by pre-downloading the icons.