Sự khác biệt giữa mã và các chỉ thị chặn mã trong ReST là gì?

Question

Trong mỗi trình kết xuất tôi đã thử, code và code-block dường như có cùng kết quả chính xác: một khối mã. Cả hai đều tạo chính xác cùng một html - bao gồm các lớp và loại thẻ (sử dụng Tôi nghĩ đó là docutils?):

<pre class="code [language] literal-block"> 

Vì vậy, sự khác biệt là gì? Tại sao chúng ta có cả hai? Có bất kỳ trình kết xuất nào hiển thị chúng khác nhau không? Có một sự khác biệt ngữ nghĩa?

Answer 1

code là chỉ thị reStructuredText. code-block là chỉ thị Sphinx.

code-block có một bộ tùy chọn khác với chỉ thị code. Ví dụ: :emphasize-lines:

Vì bạn đang sử dụng Nhân sư, tôi khuyên bạn nên sử dụng chỉ thị code-block.

Khi sử dụng code-block Tôi luôn nhận được đánh dấu chính xác. Khi sử dụng code Đôi khi tôi nhận được màu sắc và đôi khi chỉ là các khối mã theo nghĩa đen. Tôi vẫn chưa tìm ra những kết hợp của thiết lập trong conf.py mà dự đoán tạo ra đầu ra màu.

Chỉ thị code không có lợi thế là tài liệu có thể được sử dụng cả trong cây tài liệu Sphinx và cùng lúc với tài liệu reStructuredText độc lập.