2008-08-04 12 views
35

Quay lại những ngày cũ, Trợ giúp không tầm thường nhưng có thể: tạo một số tệp .rtf sôi nổi với các thẻ đặc biệt, chạy nó thông qua trình biên dịch và bạn có tệp WinHelp (.hlp) thực sự hoạt động rất tốt.Tệp trợ giúp của Windows - các tùy chọn là gì?

Sau đó, Microsoft đã quyết định rằng WinHelp không hông và mát mẻ nữa và chuyển sang CHM, lên đến mức họ thực sự sa thải WinHelp từ Vista.

Bây giờ, CHM có thể tốt đẹp, nhưng tất cả mọi người đã cố gắng mở tệp .chm trên Mạng sẽ biết màn hình "Điều hướng đến trang web đã bị hủy" đẹp do các hạn chế bảo mật gây ra.

Mặc dù có nhiều cách để làm cho CHM hoạt động ngoài mạng, nhưng đây không phải là một lựa chọn tốt bởi vì khi người dùng nhấn nút Trợ giúp, anh ấy muốn trợ giúp và không phải thực hiện một số cài đặt sôi nổi.

Dòng dưới cùng: Tôi thấy CHM hoàn toàn không sử dụng được. Nhưng với WinHelp không còn là một lựa chọn nữa, tôi tự hỏi các lựa chọn thay thế là gì, đặc biệt là khi tích hợp với Ứng dụng của tôi (tức là đối với WinHelp và CHM có các chức năng cho phép bạn trực tiếp chuyển đến một chủ đề)?

PDF có những bất lợi của yêu cầu Adobe Reader (hoặc một trong những người nhẹ hơn mà không có nhiều người sử dụng). Tôi có thể sống với điều đó vì đây là loại tiêu chuẩn ngày nay, nhưng bạn có thể nói nó một cách đáng tin cậy để nhảy đến một trang/neo nhất định không?

file HTML dường như là sự lựa chọn tốt nhất, sau đó bạn chỉ phải đối phó với các trình duyệt khác nhau (CSS và các công cụ).

Chỉnh sửa: Tôi đang tìm cách tạo Tệp trợ giúp của riêng mình. Vì tôi là người hâm mộ triết lý "Không thiết lập, chỉ trích xuất và chạy", tôi đã gặp vấn đề đó nhiều lần trong quá khứ vì nhiều người dùng của tôi sẽ chạy nó ra khỏi mạng, điều này gây ra vấn đề chính xác.

Vì vậy, tôi đang tìm kiếm một cách mạnh mẽ và tương lai chứng minh hơn để cung cấp sự giúp đỡ để người dùng của tôi mà không cần phải viết mã một hệ thống trợ giúp khác nhau cho mỗi ứng dụng tôi làm.

CHM là một định dạng thật sự tốt đẹp, nhưng điều đó an Stuff làm cho nó không sử dụng được, như một hệ thống trợ giúp có nghĩa vụ phải cung cấp sự giúp đỡ cho người sử dụng, chứ không phải để tạo ra các vấn đề thậm chí nhiều hơn.

Trả lời

15

HTML sẽ là sự lựa chọn tốt nhất tiếp theo, chỉ khi bạn sẽ phục vụ họ từ một máy chủ web công cộng. Nếu bạn cố gắng gói nó với ứng dụng của mình, tất cả các tệp (và hình ảnh (và bảng định kiểu (và ...)) sẽ làm cho CHM trông giống như một món quà từ các vị thần.

Điều đó nói rằng, khi thực sự đi kèm trong gói cài đặt, (thay vì được phân phối qua mạng), tôi thấy các tệp CHM hoạt động tốt.

OTOH, một lỗ hổng khác về tệp CHM: Ngay cả khi bạn cố mở tệp CHM trên đĩa địa phương, bạn có thể gặp phải khối bảo mật nếu bạn tải xuống ban đầu từ đâu đó, vì tệp có thể được đánh dấu là "đến từ nguồn bên ngoài" khi thu được.

+1

có, điều này xảy ra mọi lúc. các chuyến đi lên ngay cả các nhà phát triển có kinh nghiệm. – Cheeso

+1

Sau khi xem xét khá nhiều thứ khác, có vẻ như các tệp HTML thực sự là lựa chọn duy nhất của tôi, bởi vì mọi lựa chọn thay thế khác đều bị hỏng một cách đáng buồn. –

+0

Vấn đề mở khóa CHM có thể được giải quyết bằng chương trình, ngay cả khi bạn có trình cập nhật của riêng bạn. (các hệ thống cài đặt thông thường đã sửa chữa nó) Xem http://stackoverflow.com/questions/6823166/chm-file-unreadble-if-saved-to-hdd –

3

Câu hỏi là cách tạo tệp trợ giúp của riêng bạn hoặc định dạng tệp trợ giúp tốt nhất là gì?

Cá nhân, tôi thấy CHM là tuyệt vời. Một trong những điều đầu tiên tôi làm khi thiết lập máy là tải xuống Hướng dẫn sử dụng PHP ở định dạng CHM (http://www.php.net/download-docs.php) và thêm một phím nóng vào nó trong Crimson Editor. Vì vậy, khi tôi nhấn F1 nó sẽ tải CHM và thực hiện tìm kiếm cho từ mà con trỏ của tôi đang bật (tuyệt vời để tham khảo hàm nhanh).

3

Phần mềm của chúng tôi được phân phối cục bộ cho khách hàng và được phân phối từ một mạng chia sẻ. Chúng tôi đã chọn tạo cả tệp CHM và một tập hợp các tệp HTML để phân phát từ mạng. Người dùng bắt đầu chương trình cục bộ sử dụng tệp CHM và người dùng nhận được chương trình của họ được phân phối từ một mạng chia sẻ phải sử dụng các tệp HTML.

Chúng tôi sử dụng Help and Manual và do đó có thể dễ dàng tạo cả hai loại đầu ra từ cùng một dự án nguồn. Các tệp HTML cũng chứa các khả năng tìm kiếm và không yêu cầu máy chủ web, do đó, mặc dù nó không phải là một giải pháp tối ưu, hoạt động tốt.

Cho đến nay tất cả các loại đơn tập tin cho Windows dường như bị phá vỡ bằng cách này hay cách khác:

  • WinHelp - lỗi thời
  • HtmlHelp (CHM) - lỗi thời trên Vista, không hoạt động từ mạng chia sẻ khác với công trình thực sự tốt đẹp
  • Trợ giúp của Microsoft 2 (HXS) - điều này dường như hoạt động ngay cho đến thời điểm không, chỉ mục bị hỏng hoặc tương tự, được sử dụng bởi Visual Studio 2005 trở lên, làm ví dụ
+0

Tôi không biết CHM đã lỗi thời trên Vista. Nó có chính thức không? Bất kỳ liên kết? – PhiLho

+1

(VIsta có người kế thừa (hỗ trợ nền tảng), nhưng không phải là tự do, và bây giờ trong cửa sổ 8 lần vẫn không phổ biến) –

2

Nếu bạn đang làm "chỉ cần trích xuất và chạy", bạn sẽ chạy trong các vấn đề bảo mật. Điều này đặc biệt đúng nếu bạn là người dùng đang chạy Vista (hoặc mới hơn). có lý do nào bạn muốn tránh đóng gói các ứng dụng của bạn bên trong trình cài đặt không? Sử dụng trình cài đặt sẽ làm giảm bớt sự cố "nguồn bên ngoài". Bạn sẽ có thể sử dụng các tệp .chm mà không gặp bất kỳ sự cố nào.

Chúng tôi sử dụng InstallAware để tạo các gói cài đặt của chúng tôi. Nó không rẻ, nhưng rất tốt. Nếu chi phí là mối quan tâm của bạn, WIX là nguồn mở và khá mạnh mẽ. WIX có đường cong học tập, nhưng rất dễ làm việc.

+0

Vâng, lý do tôi muốn tránh trình cài đặt là vì chúng không cần thiết. Tôi ghét cài đặt các công cụ bởi vì luôn có quá nhiều lộn xộn liên quan đến nó (Registry Keys, Uninstall items), miễn là tôi không có bất kỳ phụ thuộc bên ngoài nào, các mục trình đơn bắt đầu, vv, tôi không muốn sử dụng trình cài đặt , đặc biệt là không chỉ cần phân loại các vấn đề bảo mật không cần thiết với hệ thống Trợ giúp: ( –

3

Nếu bạn không muốn sử dụng trình cài đặt và bạn không muốn người dùng thực hiện thêm bất kỳ bước nào để cho phép tệp CHM qua mạng, tại sao không quay lại WinHelp? Vista không bao gồm WinHlp32.exe ra khỏi hộp, nhưng nó là freely available as a download cho cả Vista và Server 2008.

+0

Vì sau đó người dùng phải thực hiện các bước bổ sung để cho phép các tệp HLP, ngay cả cục bộ? –

+0

Chính xác. Vấn đề là Trợ giúp là điều cần thiết Bất kỳ bước bổ sung nào giữa người dùng và tập tin trợ giúp đều không thân thiện với người dùng :-(Nếu không, tôi sẵn lòng quay trở lại WinHelp –

2

PDF có những bất lợi của yêu cầu Adobe Reader

tôi sử dụng Foxit Reader trên Windows tại nhà và tại nơi làm việc. Nhỏ hơn rất nhiều và rất nhanh để mở. Rất tiện dụng khi bạn đang tự hỏi chính xác a80000326.pdf là gì và tại sao nó làm tắc nghẽn thư mục tài liệu của bạn.

+1

Tôi sử dụng sumatrapdf - thậm chí nhỏ hơn Foxit Reader !!! :) Nó có thể được tìm thấy ở đây http://blog.kowalczyk.info/software/sumatrapdf/ một tập tin thực thi độc lập ... hữu ích!;) – t0mm13b

1

Tôi sử dụng gói thương mại có tên AuthorIT có thể tạo ra một số định dạng khác nhau, chẳng hạn như chm, html, pdf, từ, cửa sổ trợ giúp, xml, xhtml và một số người khác mà tôi chưa từng nghe đến chuông?). Đây là một hệ thống quản lý nội dung hướng tới nhu cầu của các nhà văn tài liệu kỹ thuật. Lợi thế là bạn có thể sử dụng và tái sử dụng cùng một nội dung để xây dựng một bộ hướng dẫn và sau đó tạo chúng theo các định dạng khác nhau. Vì vậy, dòng dưới cùng liên quan đến câu hỏi lựa chọn chm hoặc html hoặc bất cứ điều gì là nếu bạn đang sử dụng này, bạn không bị khóa vào một định dạng nhất định, nhưng bạn có thể cung cấp một số trong đó người dùng có thể chọn, và bạn có thể thậm chí thêm nhiều định dạng hơn khi bạn đi cùng, mà không mất thêm chi phí.

Nếu bạn chỉ có một hướng dẫn để tạo nó sẽ không có giá trị trong thời gian của bạn, nhưng nếu bạn có một tài liệu được thiết lập để quản lý thì nó là tốt nhất cho kiến ​​thức của tôi. Hỗ trợ của họ cũng rất hữu ích.

3

Tùy thuộc vào cách nhập tài liệu trực tuyến vào sản phẩm của bạn, cơ sở hạ tầng tài liệu tốt có thể phức tạp để thiết lập nhưng một khi đã hoàn thành, nó sẽ được đền đáp. Dưới đây là cách chúng tôi thực hiện điều đó -

  • XML trợ giúp, được lưu trữ trong SCC (ClearCase).
  • Trợ giúp chỉnh sửa XMetal
  • Trợ giúp biên soạn, chỉnh Open DITA Toolkit, với tùy chỉnh Perl/Java tiền xử lý
  • Trợ giúp tài liệu tham khảo nguồn chéo các ứng dụng nguồn lực tại thời gian biên dịch, các file rc vv
  • phân phôi Trợ giúp từ nguồn duy nhất, PDF, CHM , Eclipse Help, HTML.
  • Kho nguồn đơn tạo ra trợ giúp cho nhiều sản phẩm hơn 10+ với hàng nghìn chủ đề được chia sẻ.

Từ những gì bạn mô tả tôi sẽ xem xét trợ giúp Eclipse, nó không đơn giản để tích hợp vào các ứng dụng .NET hoặc MFC, về cơ bản bạn phải thực hiện ánh xạ trợ giúp để giải quyết yêu cầu tới URL. Giúp trình bao bọc hoặc trình duyệt.

2

Tôi nghĩ rằng giải pháp mà chúng ta sẽ kết thúc với ứng dụng của chúng tôi là tự lưu trữ các tệp trợ giúp. Điều này cho phép chúng tôi truy cập ngay lập tức vào các tệp và khả năng giữ cho chúng được cập nhật.

Điều tôi dự định là tải nội dung vào một loạt tệp XML khổng lồ, mỗi tệp có chứa trợ giúp cho một mục cụ thể. XML này sẽ chứa các liên kết đến các tệp XML khác. Chúng tôi sẽ sử dụng XSLT để hiển thị nội dung khi cần thiết.

Tùy thuộc vào cấp phép, chúng tôi có thể tạo tệp XSLT dành riêng cho khách hàng để điều chỉnh giao diện cho những gì họ cần. Chúng tôi có thể cần phải chỉ có thể hiển thị trợ giúp cho các phiên bản cụ thể của sản phẩm của chúng tôi và điều đó có thể được thực hiện bằng cách lọc ra nội dung trong XSLT.

5

Tôi không thích tùy chọn html và thực sự đã chuyển từ HTML thuần túy sang CHM bằng cách nén và lập chỉ mục chúng. Thậm chí sử dụng chúng trên một số ít khách hàng không phải Windows. Nó chỉ đơn giản là giải quyết sự cố liên tục của những người đặt nó trên mạng (làm sâu giới hạn, hiệu ứng khóa lạ), chống vi-rút đã chết trong thư mục với 30000 tệp html và 20 phút giải nén trong khi cài đặt trên hệ thống cũ hơn. và tính năng, tính toán của không gian cần thiết trong trình cài đặt, vv

Và sau đó tôi thậm chí không bao gồm những người bắt đầu "sửa chữa" chúng, sản phẩm của bên thứ ba bị lỗi "tích hợp" nỗ lực vv, khiếu nại về chậm (trình duyệt bắt đầu -up)

Tất cả chúng ta đã phải chờ đợi nhiều năm để các vấn đề biến mất khi hệ điều hành và phần cứng được cải thiện, nhưng các vấn đề liên tục diễn ra trong một số lượng giống và đủ là đủ. Chúng tôi tìm thấy chmlib, và quyết định chúng tôi có thể sử dụng một cái gì đó dựa trên điều này như là thoát với một người đọc bên ngoài đơn giản, nếu hệ điều hành cung cấp những người ngừng làm việc và chuyển sang.

Trong khi đó, chúng tôi cũng có trình biên dịch riêng, vì vậy chúng tôi là MS miễn phí trong tương lai. Điều đó không có nghĩa là chúng ta sẽ không bao giờ thay đổi (các giải pháp với các máy chủ web cục bộ có vẻ yêu thích hiện nay), nhưng ít nhất chúng ta có một sự lựa chọn.