reStructuredText에서 강조 표시된 인라인 코드


130

reStructuredText에 다음 지시문이 있음을 알고 있습니다.

.. code:: bash

    gedit pohl.m

코드 블록을 렌더링합니다. 다음과 같이 인라인 스 니펫에 대한 구문 강조를 얻는 방법이 있습니까?

Do edit the file, type ``gedit pohl.m`` into a terminal.

백틱은 코드로 표시되지만 블록과 같은 피그먼트로 강조 표시하고 싶습니다. 이게 가능해?


7
백틱은 텍스트의 해당 부분을 코드 블록이 아닌 인라인 리터럴 로 표시합니다 . 일반적으로 이것은 모노 스페이스 글꼴로 게시됩니다. 인라인 코드 구문으로 강조 표시된 스 니펫을 얻는 방법을 잘 모르겠습니다.
Chris

답변:


209

이것에 대해 좀 더 살펴보면 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에서 사용할 수 없습니다 (테스트해야하는 유일한 버전 임).


4
스핑크스를 사용할 때이 문제에 유의하십시오 : stackoverflow.com/questions/21591107/…
Donatello
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.