스핑크스에서 jinja2로 전달되는 변수 찾기

Question

스핑크스에서 템플릿을 만들려고합니다. 내 의도는 기본 템플릿을 사용하는 것이 아니라 새로운 템플릿을 처음부터 만드는 것입니다. 그러나 스핑크스에서 템플릿으로 전달되는 변수에 대한 문서는 거의 없습니다.

스핑크스에서 템플릿으로 전달되는 모든 변수를 덤프하고 싶습니다. (이상적으로는 내 파이썬 지식이 좋지 않아서 템플릿 안에 있습니다!)

Answer 1

스핑크스 문서는 템플릿에서 사용할 수있는 list of most variables을 제공합니다. this dictionary (Sphinx source code)에 추가 변수 (대부분 docutils에서 전달 된 변수)가 있습니다.

conf.py 파일의 html_theme_options 사전을 사용하여 사용자 지정 구성 변수를 자신의 템플릿에 추가 할 수 있습니다.

사용자 지정 구성 변수는 접두어 theme_으로 액세스해야합니다. 당신이 당신의 사용자 정의 변수를 정의하면

예를 들어, 다음과 같이

html_theme_options = { 
    'pdf_path': '/docs/MyDocs.pdf' 
} 

, 당신은 {{theme_pdf_path}}로 pdf_path 변수에 액세스 할 수 있습니다.

또는 테마의 theme.conf 파일에서 맞춤 테마 변수를 정의 할 수 있습니다. 이 예에서는 행 pdf_path = /docs/MyDocs.pdf을 추가합니다.