
Hi all! I am just trying to get my bearings in the documentation and was wondering if there was more that I needed to install other than the files in the Github repo? I was curious as it doesn't seem as if the Github repo has all of the css and js files that are in the built documentation. Are there addition Sphinx templates or does the Docs theme not use any? Thanks

On Wed, 5 Apr 2023, 20:12 Zac Belado, <pixelgeek@gmail.com> wrote:
Yes, you do need to install additional things. More details below. I was curious as it doesn't seem as if the Github repo has all of the css
and js files that are in the built documentation. Are there addition Sphinx templates or does the Docs theme not use any?
Indeed. We use a Sphinx theme that lives outside of the repository. You can find it at https://github.com/python/python-docs-theme Also, you can find instructions for building the Python's documentation from source at https://devguide.python.org/documentation/start-documenting/, in case you're interested in trying to build the Python documentation on your own (eg: for just poking around and investigating, or for contributing to Python itself!). :) Cheers, Pradyun

Hi, I'm assuming that you're trying to build the CPython documentation locally. Our docs are built using Sphinx. We don't commit the Docs output to the GitHub repo. You can build the docs locally by following the instructions here: https://devguide.python.org/documentation/start-documenting/ On Wed, Apr 5, 2023, 12:12 PM Zac Belado <pixelgeek@gmail.com> wrote:

On Wed, 5 Apr 2023, 20:12 Zac Belado, <pixelgeek@gmail.com> wrote:
Yes, you do need to install additional things. More details below. I was curious as it doesn't seem as if the Github repo has all of the css
and js files that are in the built documentation. Are there addition Sphinx templates or does the Docs theme not use any?
Indeed. We use a Sphinx theme that lives outside of the repository. You can find it at https://github.com/python/python-docs-theme Also, you can find instructions for building the Python's documentation from source at https://devguide.python.org/documentation/start-documenting/, in case you're interested in trying to build the Python documentation on your own (eg: for just poking around and investigating, or for contributing to Python itself!). :) Cheers, Pradyun

Hi, I'm assuming that you're trying to build the CPython documentation locally. Our docs are built using Sphinx. We don't commit the Docs output to the GitHub repo. You can build the docs locally by following the instructions here: https://devguide.python.org/documentation/start-documenting/ On Wed, Apr 5, 2023, 12:12 PM Zac Belado <pixelgeek@gmail.com> wrote:
participants (3)
-
Mariatta
-
Pradyun Gedam
-
Zac Belado