ReStructuredText'te satır içi kod vurgulama


130

ReStructuredText'in bu yönergeye sahip olduğunu biliyorum:

.. code:: bash

    gedit pohl.m

bir kod bloğu oluşturur. Bunun gibi satır içi snippet'ler için sözdizimi vurgulamanın bir yolu var mı:

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

Ters işaretler onu kod olarak işaretler, ancak onu blok gibi pigmelerle vurgulamak isterim. Mümkün mü?


7
Ters işaretler, metnin o kısmını bir kod bloğu olarak değil, bir satır içi değişmez değer olarak işaretler. Tipik olarak bu sadece tek aralıklı bir yazı tipinde yayınlanacaktır. Satır içi kod sözdizimi vurgulanmış snippet'leri nasıl elde edeceğimi bilmiyorum, korkarım.
Chris

Yanıtlar:


209

Bunu biraz daha inceledikten sonra, reStructuredText Yorumlu Metin Rolleri belgesine rastladım . Bu belgeden:

Yorumlanan metin, metnin etrafında ters tırnak (`) kullanır. Açık bir rol işaretçisi isteğe bağlı olarak iki nokta üst üste ile ayrılmış metinden önce veya sonra görünebilir. Örneğin:

This is `interpreted text` using the default role.

This is :title:`interpreted text` using an explicit role.

Görünüşe göre bir coderol var , bu yüzden basitçe yazabilirsiniz

:code:`a = b + c`

bir satır içi kod bloğu oluşturmak için. Söz dizimi vurgulamasını almak için özel bir rol tanımlayabilirsiniz. Örneğin

.. role:: bash(code)
   :language: bash

daha sonra bu şekilde kullanabilirsiniz:

Here is some awesome bash code :bash:`a = b + c`.

Rol tanımının, role referanslardan önce yerleştirilmesi gerektiğini unutmayın.

Bağlandığım belge, başvurduğu belgelerin sürümünden hiç bahsetmiyor. Kod rolü, 0.8.1 belgelerinde mevcut değil (bu, karşı test etmem gereken tek sürüm).


4
sfenks kullanırken lütfen bu sorunu not edin: stackoverflow.com/questions/21591107/…
Donatello
Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.