Làm cách nào để gạch dưới văn bản trong reStructuredText?

Question

Tất nhiên, trên web một gạch chân biểu thị siêu liên kết, nhưng nếu tôi cần gạch chân không phải là siêu liên kết thì sao?

Answer 1

Tôi đã hỏi một câu hỏi tương tự here. Hãy thử như thế này:

.. role:: underline 
    :class: underline 

Trong tài liệu, điều này có thể được áp dụng như sau:

:underline:`This text is underlined` 

Trong file css của bạn, bạn có thể có:

.underline { 
    text-decoration: underline; 
} 

này nên hoạt động cho đầu ra HTML . Tuy nhiên, gạch chân là cố ý không phải là một phần của thông số kỹ thuật ReST. Xem this link.

Answer 2

Bạn thêm các chỉ thị sau đây trong tập tin index.rst ví dụ:

.. role:: underline 
    :class: underline 

Trong tài liệu mà bạn chỉ ra văn bản như nhấn mạnh như sau:

:underline:`This text is underlined` 

Để xác định css cho lớp gạch dưới của bạn, bạn thêm một số css vào tệp layout.html bên trong thư mục _themes/sphinx_rtd_theme/sphinx_rtd_theme/nếu bạn đang sử dụng sphinx_rtd_theme, nếu không thì thư mục chủ đề mặc định của bạn:

<style> 
    .underline { 
    text-decoration: underline; 
    } 
</style> 

Điều này sẽ tạo kiểu html cho phù hợp.

gạch dưới là một phần của StructureText nhưng không chi tiết kỹ thuật reStructuredText Sphinx, theo một báo từ David Ascher trong 2000/01/21 Doc-SIG mailing list bài của mình, "docstring ngữ pháp: một đề nghị rất sửa đổi":

Việc gắn thẻ văn bản được gạch chân với _'s là tối ưu hóa. Gạch chân không nên được sử dụng từ góc nhìn chính tả (gạch dưới là được thiết kế để sử dụng trong bản thảo để giao tiếp với bộ phân loại mà văn bản phải được in nghiêng - không có cuốn sách nào có thể sử dụng số gạch dưới) và xung đột với đôi -underscored Python biến tên (init và các loại tương tự), sẽ bị cắt ngắn và gạch dưới khi hiệu ứng đó không được mong muốn. Lưu ý rằng khi hoàn thành việc đánh dấu sẽ ngăn chặn việc cắt bớt đó ('init'), tôi nghĩ rằng đánh dấu tài liệu giống như tôi nghĩ chú thích loại - chúng phải là tùy chọn và trên tất cả đều không gây hại. Trong trường hợp này, dấu gạch dưới đánh dấu không gây hại.