Nhân sư có tốt hơn LaTex khi viết sách hướng dẫn/sách không?

Question

Chỉ a few people recommended để sử dụng Nhân sư vào đầu năm.

Nhân sư đã phát triển khá nhanh trong thời gian gần đây. Hôm nay tôi đã lưu ý rằng Sage đã thực hiện thay đổi từ chỉnh sửa trực tiếp với LaTex thành Sphinx. Điều này hiển nhiên trong số William Stein's answer vào ngày 2 tháng 4 về hướng dẫn của Sage

Hướng dẫn không còn là tài liệu latex nữa. Nó hoàn toàn là tài liệu Nhân sư khác nhau có thể xuất ra pdf.

Nó gợi ý rằng Sphinx có thể ở mức phù hợp với tôi.

Nhân sư có tốt hơn LaTex khi viết sách hướng dẫn/sách không?

Answer 1

Chúng tôi đã viết một cuốn sách có sphinx nhưng chúng tôi phải tinh chỉnh tệp tex được tạo bằng tập lệnh Python.

Hãy xem thread này, trong công cụ xây dựng cuốn sách phần

Dưới đây là một số thay đổi, chúng tôi thực hiện cho các tập tin LaTeX gốc:

• documentclass = 'cuốn sách'
• thêm frontmatter, mainmatter và backmatter
• thêm một phong cách mới để fncychap.sty
• hai cột chỉ số thay vì một cột
• một số thay đổi trong tiêu đề trang
• tất cả mọi thứ là màu đen & trắng
  • liên kết
  • tiêu đề
  • hình ảnh (sử dụng imagemagick để chuyển đổi hình ảnh trong thang độ xám)
• lời khuyên và ghi chú hiển thị trong một hộp đẹp hơn với biểu tượng
• tốt hơn vị trí phao trên các trang để tối ưu hóa không gian sử dụng

Chúng tôi cũng thực hiện những thay đổi nhỏ để book.cls và sphinx.sty

Với tất cả các chỉnh sửa này, chúng tôi rất hài lòng với kết quả.

Answer 2

Tốt hơn cho việc tạo tài liệu tham khảo, không phải để viết sách.

Answer 3

Word có phải là công cụ sản xuất tài liệu tốt hơn không?

LaTeX (và TeX) đã tồn tại lâu hơn hầu hết chúng ta nhận ra rằng có những chương trình để làm điều đó và chúng tôi quan tâm đến chúng. LaTeX gần như chắc chắn tốt hơn Sphinx (hay Word).

1. Có tốt hơn cho bạn không? Có lẽ.

2. Có tốt hơn cho tôi không? Không chắc.

3. Có tốt hơn cho người trung bình không? Xác định 'trung bình' sau đó đi đến điểm 1.

Answer 4

Vâng, có được ít nhất một cuốn sách in sử dụng Sphinx và rst2pdf

Một số tài liệu mẫu được tạo ra qua nhân sư và rst2pdf đây:

http://freedrive.com/folder/236385

Và ở đây:

http://freedrive.com/folder/236380

Đặc biệt kiểm tra tham chiếu thư viện python và sách django.

Đây là đầu ra từ nhánh phát triển và có lỗi (ví dụ: TOC thường nằm ở bên trái của trang) đang được sửa.

Answer 5

tôi thích Sphinx với latex để viết hướng dẫn sử dụng vì hai lý do:

1. Bạn có thể xây dựng HTML, PDF, HtmlHelp và qthelp phiên bản đẹp của cuốn cẩm nang với nỗ lực tối thiểu.
2. còn lại cú pháp là nhanh hơn để viết và tôi thấy dễ nhớ hơn (đó là đơn giản hơn)

Một cuốn sách, tuy nhiên, có thể là một câu chuyện khác nhau. Nếu tôi muốn viết một cuốn sách chỉ có một bản in và một bản pdf và chứa các phương trình và trích dẫn tôi sẽ đi với Latex, bởi vì tôi nghĩ nó trưởng thành hơn nhiều so với reST và tôi thấy dễ dàng tùy chỉnh.

Btw. Tôi có nhiều kinh nghiệm hơn trong việc sử dụng Latex.