스핑크스 인라인 포함

Question

.. include:: 함수를 인라인으로 사용하고 싶지만 이전 텍스트의 두 줄로 구분하면 원하는 파일을 실제로 포함시킬 수 있습니다.

누군가가 묻기 전에 내가 포함시키고 자하는 파일은 프로토콜 번호입니다. 그렇기 때문에, 새로운 줄을 전혀 사용하지 않아도됩니다. 쉽게 변경할 수 있기를 원하며 문서의 여러 위치에서 사용할 수 있습니다. 예를 들어 "우리는 현재 프로토콜 (proto.txt)을 사용합니다."라고 생각합니다. 나는 스핑크스와 처음으로 새로운데, 아마도 내가 찾지 못한 아주 명백한 해결책이있을 것입니다.

Answer 1

인라인 포함은 스핑크스에서 불가능합니다.

그러나, 당신은 당신의 build configuration file의 rst_epilog 변수에 글로벌aliases을 정의 할 수 있습니다.

예를 들어, 당신은 당신의 conf.py 파일에 다음 행을 추가 할 수 있습니다

rst_epilog = """ 
    .. |version| replace:: 4.1 
    .. |protocol| replace:: httpx 
""" 

을 이제,이 같은 예를 들어, 프로젝트 내에서 어떤 한 .rst 파일에서 변수 |version| 및 |protocol|에 액세스 할 수 있습니다

를

Version |version| uses the |protocol| protocol.

는

된다

소프트웨어의 다른 부분에 (또는 다른 변수)을 특정 파일이나 형식으로 지정해야하는 경우 해당 파일을 변수로 읽어서 Sphinx 구성 파일에 읽을 수있는 스크립트를 작성할 수 있습니다.