godotengine / godotengine/godot-docs

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

Open
#11,645 3 comments 0 reactions 1 assignee Claimed by @mhilbrunner View on GitHub
bug python topic:buildsystem
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

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.

Image

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?

https://github.com/godotengine/godot-docs/blob/c37184acc9002561de0b9a6453cdb27f116ec058/conf.py#L309-L318

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

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.