reStructuredText에 다음 지시문이 있음을 알고 있습니다.
.. code:: bash
gedit pohl.m
코드 블록을 렌더링합니다. 다음과 같이 인라인 스 니펫에 대한 구문 강조를 얻는 방법이 있습니까?
Do edit the file, type ``gedit pohl.m`` into a terminal.
백틱은 코드로 표시되지만 블록과 같은 피그먼트로 강조 표시하고 싶습니다. 이게 가능해?
답변
이것에 대해 좀 더 살펴보면 reStructuredText Interpreted Text Roles 문서를 우연히 발견했습니다 . 이 문서에서 :
해석 된 텍스트는 텍스트 주위에 큰 따옴표 (`)를 사용합니다. 명시 적 역할 마커는 선택적으로 텍스트 앞뒤에 콜론으로 구분되어 나타날 수 있습니다. 예를 들면 다음과 같습니다.
This is `interpreted text` using the default role. This is :title:`interpreted text` using an explicit role.
code역할 이있는 것 같아서 간단히 입력 할 수 있습니다.
:code:`a = b + c`
인라인 코드 블록을 렌더링합니다. 구문 강조를 얻기 위해 사용자 정의 역할을 정의 할 수 있습니다. 예를 들어
.. role:: bash(code)
:language: bash
다음과 같이 사용할 수 있습니다.
Here is some awesome bash code :bash:`a = b + c`.
역할 정의는 역할을 참조하기 전에 배치해야합니다.
내가 링크하는 문서는 그것이 참조하는 docutils의 버전을 언급하지 않습니다. 코드 역할은 docutils 0.8.1에서 사용할 수 없습니다 (테스트해야하는 유일한 버전 임).
