restructuredtext

7Nhiệt

1Trả lời

Làm thế nào để thay đổi kích cỡ hình ảnh có trong các trang tài liệu GitHub?

Tôi có trang README.rst trên GitHub nhưng tôi không thể chỉ định kích thước của hình ảnh được liên kết và thực sự tôi không muốn đưa chúng vào kho lưu trữ của mình. Xem https://github.com/pycontribs/j

5Nhiệt

3Trả lời

Siêu kết nối nội bộ trong cấu trúc lại với văn bản tùy chỉnh

Tôi biết cách tạo siêu kết nối bên ngoài bằng văn bản tùy chỉnh. `My cool link <http://www.asdf.com>`_ Nhưng tôi muốn liên kết với tham chiếu nội bộ. .. _foo: Lorem ipsum dolor sit amet, consectet

6Nhiệt

2Trả lời

Tôi làm cách nào để ghi lại: rtype: cho hàm trả về nhiều loại dữ liệu có thể?

Trong một chuỗi tài liệu Python, cách tài liệu :rtype: cho một hàm có thể trả về nhiều loại dữ liệu có thể? Ví dụ: nếu một hàm có thể trả về defaultdict HOẶC dict HOẶC list, dựa trên thông số chức năn

7Nhiệt

1Trả lời

Hình ảnh trong README.rst không hiển thị trong pypi

Tôi muốn một hình ảnh được liên kết trong tệp README.rst của tôi sẽ được hiển thị khi tôi tải gói của mình lên PyPI. Trong README của tôi, tôi có: .. image:: example-python.png :height: 100px

5Nhiệt

2Trả lời

lồng/vai trò hỗn hợp: áp dụng nhiều vai trò để chồng chéo văn bản

Trong file custom.css của tôi, tôi có, .bold { font-weight: bold; } .red { color:red; } Và trong tập tin _.rst tôi, .. role:: bold .. role:: red Nhưng nếu tôi cố gắng tổ/hợp chất h

6Nhiệt

1Trả lời

Thêm một lớp CSS vào một liên kết trong RST

Tôi có một liên kết trong tập tin .rst của tôi trông giống như Click me! <../link_reference.html> Điều này ám như Nhấn vào tôi !. Tuy nhiên, tôi muốn thêm một lớp CSS vào nó, để nó trông giống như C

5Nhiệt

1Trả lời

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

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à d

7Nhiệt

1Trả lời

Làm nổi bật một phần của khối mã

Tôi có một khối mã rất lớn trong tệp .rst của tôi, mà tôi muốn làm nổi bật một phần nhỏ và tô đậm. Hãy xem xét những điều sau đây đầu tiên: wall of text. wall of text. wall of text.wall of text. wall

8Nhiệt

2Trả lời

Một chữ "*" trong RestructuredText

Tôi nhìn vào đoạn mã này: def ook(*args): """Some silly function. :param *args: Optional arguments. """ ... Và ngay khi tôi chạy Sphinx, tôi nhận được lỗi oh-so hữu ích: WARNING

6Nhiệt

2Trả lời

Cách bao gồm tham chiếu nội bộ trong khối mã?

Trong tài liệu Sphinx tôi .rst Tôi có một khối mã có chứa một cây cấu trúc của sản phẩm của tôi bằng cách sử dụng lệnh UNIX tree: |── parent | |── child | |── grandchild Đó là trong m