docs: inline contents.rst into index.rst
The idea of having a single file containing the ToC is not really how things are done in Sphinx, and kinda makes it harder to structure documentation more naturally. This was just something I did to mirror what we used to do for the old HTML-only version of the docs, to ease the transition and to de-clutter index.rst. Now that the transition is far behind us, and index.rst is much cleaner, we can finally start inlining this. In the long run, I expect most of these to be moved to separate "chapter articles" that summarize what these topics are, and thus disappear from here. Reviewed-by: Eric Anholt <eric@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7709>
This commit is contained in:
parent
e3047762c9
commit
893a30eacc
|
@ -79,7 +79,7 @@ language = None
|
|||
# List of patterns, relative to source directory, that match files and
|
||||
# directories to ignore when looking for source files.
|
||||
# This patterns also effect to html_static_path and html_extra_path
|
||||
exclude_patterns = [ "contents.rst" ]
|
||||
exclude_patterns = []
|
||||
|
||||
# The name of the Pygments (syntax highlighting) style to use.
|
||||
pygments_style = 'sphinx'
|
||||
|
|
|
@ -1,105 +0,0 @@
|
|||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Documentation
|
||||
:hidden:
|
||||
|
||||
self
|
||||
history
|
||||
developers
|
||||
systems
|
||||
license
|
||||
faq
|
||||
relnotes
|
||||
thanks
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:caption: Download and Install
|
||||
:hidden:
|
||||
|
||||
download
|
||||
install
|
||||
precompiled
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Need help?
|
||||
:hidden:
|
||||
|
||||
lists
|
||||
bugs
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: User Topics
|
||||
:hidden:
|
||||
|
||||
shading
|
||||
egl
|
||||
opengles
|
||||
envvars
|
||||
osmesa
|
||||
debugging
|
||||
perf
|
||||
extensions
|
||||
application-issues
|
||||
viewperf
|
||||
xlibdriver
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Drivers
|
||||
:hidden:
|
||||
|
||||
drivers/d3d12
|
||||
drivers/freedreno
|
||||
drivers/llvmpipe
|
||||
drivers/openswr
|
||||
drivers/v3d
|
||||
drivers/vc4
|
||||
drivers/vmware-guest
|
||||
drivers/zink
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Developer Topics
|
||||
:hidden:
|
||||
|
||||
repository
|
||||
sourcetree
|
||||
utilities
|
||||
helpwanted
|
||||
devinfo
|
||||
codingstyle
|
||||
submittingpatches
|
||||
releasing
|
||||
release-calendar
|
||||
sourcedocs
|
||||
dispatch
|
||||
gallium/index
|
||||
android
|
||||
Linux Kernel Drivers <https://www.kernel.org/doc/html/latest/gpu/>
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Testing
|
||||
:hidden:
|
||||
|
||||
conform
|
||||
ci/index
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Links
|
||||
:hidden:
|
||||
|
||||
OpenGL Website <https://www.opengl.org>
|
||||
DRI Website <https://dri.freedesktop.org>
|
||||
Developer Blogs <https://planet.freedesktop.org>
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Hosted by:
|
||||
:hidden:
|
||||
|
||||
freedesktop.org <https://www.freedesktop.org>
|
108
docs/index.rst
108
docs/index.rst
|
@ -1,5 +1,3 @@
|
|||
.. include:: contents.rst
|
||||
|
||||
Introduction
|
||||
============
|
||||
|
||||
|
@ -29,3 +27,109 @@ and other operating systems.
|
|||
.. _EGL: https://www.khronos.org/egl/
|
||||
.. _Direct Rendering Infrastructure: https://dri.freedesktop.org/
|
||||
.. _X.org: https://x.org
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Documentation
|
||||
:hidden:
|
||||
|
||||
self
|
||||
history
|
||||
developers
|
||||
systems
|
||||
license
|
||||
faq
|
||||
relnotes
|
||||
thanks
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:caption: Download and Install
|
||||
:hidden:
|
||||
|
||||
download
|
||||
install
|
||||
precompiled
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Need help?
|
||||
:hidden:
|
||||
|
||||
lists
|
||||
bugs
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: User Topics
|
||||
:hidden:
|
||||
|
||||
shading
|
||||
egl
|
||||
opengles
|
||||
envvars
|
||||
osmesa
|
||||
debugging
|
||||
perf
|
||||
extensions
|
||||
application-issues
|
||||
viewperf
|
||||
xlibdriver
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Drivers
|
||||
:hidden:
|
||||
|
||||
drivers/d3d12
|
||||
drivers/freedreno
|
||||
drivers/llvmpipe
|
||||
drivers/openswr
|
||||
drivers/v3d
|
||||
drivers/vc4
|
||||
drivers/vmware-guest
|
||||
drivers/zink
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Developer Topics
|
||||
:hidden:
|
||||
|
||||
repository
|
||||
sourcetree
|
||||
utilities
|
||||
helpwanted
|
||||
devinfo
|
||||
codingstyle
|
||||
submittingpatches
|
||||
releasing
|
||||
release-calendar
|
||||
sourcedocs
|
||||
dispatch
|
||||
gallium/index
|
||||
android
|
||||
Linux Kernel Drivers <https://www.kernel.org/doc/html/latest/gpu/>
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Testing
|
||||
:hidden:
|
||||
|
||||
conform
|
||||
ci/index
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Links
|
||||
:hidden:
|
||||
|
||||
OpenGL Website <https://www.opengl.org>
|
||||
DRI Website <https://dri.freedesktop.org>
|
||||
Developer Blogs <https://planet.freedesktop.org>
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Hosted by:
|
||||
:hidden:
|
||||
|
||||
freedesktop.org <https://www.freedesktop.org>
|
||||
|
|
Loading…
Reference in New Issue