Làm nổi bật mã nội tuyến trong tái cấu trúc


130

Tôi biết reSturationuredText có chỉ thị này:

.. code:: bash

    gedit pohl.m

mà làm cho một khối mã. Có một số cách để làm nổi bật cú pháp cho các đoạn nội tuyến như thế này:

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

Các backticks đánh dấu nó là mã, nhưng tôi muốn làm nổi bật nó bằng các pygments như khối. Điều này có thể không?


7
Các backticks đánh dấu rằng một phần của văn bản là một dòng chữ , không phải là một khối mã. Thông thường, điều này sẽ chỉ được xuất bản trong một phông chữ đơn cách. Tôi không chắc chắn làm thế nào để có được đoạn mã nội tuyến được tô sáng đoạn trích Tôi sợ.
Chris

Câu trả lời:


209

Sau khi xem xét thêm, tôi tình cờ phát hiện ra tài liệu Vai trò văn bản được giải thích lại . Từ tài liệu này:

Văn bản được giải thích sử dụng backquotes (`) xung quanh văn bản. Một dấu hiệu vai trò rõ ràng có thể tùy ý xuất hiện trước hoặc sau văn bản, được phân cách bằng dấu hai chấm. Ví dụ:

This is `interpreted text` using the default role.

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

Dường như có một codevai trò , vì vậy bạn chỉ cần gõ

:code:`a = b + c`

để kết xuất một khối mã nội tuyến. Để có được cú pháp tô sáng, bạn có thể xác định vai trò tùy chỉnh. Ví dụ

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

mà sau đó bạn có thể sử dụng như vậy:

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

Lưu ý rằng định nghĩa vai trò phải được đặt trước các tham chiếu đến vai trò.

Lưu ý, tài liệu tôi liên kết để không đề cập đến phiên bản của docutils mà nó đề cập đến. Vai trò mã không có sẵn trong docutils 0.8.1 (đây là phiên bản duy nhất tôi phải kiểm tra).


4
xin lưu ý vấn đề này khi sử dụng nhân sư: stackoverflow.com/questions/21591107/ Kẻ
Donatello
Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.