blender/doc/python_api
Campbell Barton 1c6b66c9cf PyDoc: replace in-lined enum references with links where possible
Avoid in-lining large enums such as icons and event types, linking
to them instead.

This mitigates T76453, where long enums took a lot of space in the docs,
this was a problem with `UILayout` where each icon argument would list
all icons. [0] worked around the issue using CSS to scroll the list.
However this has the draw-back where some items are clipped in a way
that's not obvious, see: T87008.

The reason this isn't a complete solution is that Python defined enums
aren't written into their own pages which can be linked to, although
currently there are no large Python enums included in the API docs.
All in-lined enums are now under 20 items.

[0]: 1e8f2665916c049748a3985a2fce736701925095
2022-05-31 14:19:06 +10:00
..
examples Cleanup: format 2022-05-18 12:17:42 +10:00
rst Python API: warn that the bgl module is deprecated in the docs 2022-05-19 21:21:28 +02:00
static Python API Docs: Hide version swtich 2022-02-22 14:39:51 -05:00
templates Py Docs: Implement version switch to switch between versions on the website 2022-02-03 14:25:26 -05:00
requirements.txt PyDocs: Update theme to latest version 2021-09-14 23:16:38 -04:00
rst_from_bmesh_opdefines.py File headers: SPDX License migration 2022-02-11 09:14:36 +11:00
sphinx_changelog_gen.py File headers: SPDX License migration 2022-02-11 09:14:36 +11:00
sphinx_doc_gen_monkeypatch.py File headers: SPDX License migration 2022-02-11 09:14:36 +11:00
sphinx_doc_gen.py PyDoc: replace in-lined enum references with links where possible 2022-05-31 14:19:06 +10:00