phong cách reStructuredText

Question

Tôi đã tìm thấy this guide cho rst2pdf để tìm hiểu cách tạo kiểu tệp reStructuredText trong tài liệu pdf kết quả. Có điều sau đây trong stylesheet JSON của tôi, ví dụ, nó được áp dụng thành công vào tài liệu toàn:

"pageSetup" : { 
    "size": "A4", 
    "width": null, 
    "height": null, 
    "margin-top": "2cm", 
    [...] 
    "margin-gutter": "0cm" 
} 

thế nào là một phong cách đặc biệt chỉ áp dụng cho một lớp học cụ thể? Ví dụ, làm thế nào tôi có thể áp dụng một phông chữ cụ thể cho lớp h1? Khó khăn trước mắt của tôi bắt nguồn từ thực tế là tôi không chắc chắn về việc liệu nó có thực sự được gọi là h1, H1, header1 hoặc Header1.

Answer 1

rst2pdf.py manual dường như không có nhiều thông tin liên quan đến tên kiểu. Tuy nhiên, phần về Kiểu (chương 8) có ví dụ này:

["heading1" , { 
    "parent": "normal", 
    "fontName": "Tuffy_Bold", 
    "fontSize": 18, 
    "keepWithNext": true, 
    "spaceAfter": 6 
}], 

Vì vậy, có vẻ như heading1 là tên kiểu thích hợp.

Một điều cần lưu ý là

Nếu tài liệu của bạn đòi hỏi một phong cách mà không được định nghĩa trong stylesheet của bạn, nó sẽ in một cảnh báo và sử dụng bodytext để thay thế.

Vì vậy, giả sử bạn không nhận được bất kỳ cảnh báo nào khi tạo tài liệu, kiểu phải được đặt trong biểu định kiểu mặc định, vì vậy hãy xem qua điều này để cảm nhận tên kiểu được sử dụng.

Bạn có thể làm rst2pdf in stylesheet mặc định sử dụng

rst2pdf --print-stylesheet 

Nếu bạn muốn thêm phong cách, chỉ cần tạo một kiểu, (hoặc đi stylesheet tiêu chuẩn và sửa đổi nó) và vượt qua nó với các tùy chọn -s

rst2pdf mydoc.txt -s mystyles.txt