1- Các Khái Niệm
Topic : Đơn vị thông tin của hệ thống Help, được viết cho một chủ đề. Chủ đề
bao gồm chuỗi văn bản xuất hiện trong hệ thống Help, Chủ đề được liên kết với pop_up (hộp bật lên), hot spots (vùng tác động) và các lệnh nhảy theo chuỗi ngữ cảnh kết hợp với chủ đề.
Pop_up : Văn bản của chủ đề tham chiếu được xuất hiện đúng lúc trong hệ
thống Help và có hình chữ nhật bao quanh. Pop_up sẽ mất đi khi người sử dụng bấm chuột ra phía ngoài khung.
Context String : (chuỗi ngữ cảnh). Chuỗi tham chiếu đến chủ đề và được dùng giống như tên biến tượng trưng trong hệ thống Help. Mọi tham chiếu đến chủ đề được hình thành thông qua chuỗi ngữ cảnh.
Hot spot : Vùng ảnh hưởng của chuột trong văn bản hay ảnh có liên kết với chuỗi ngữ cảnh hay sự thực hiện của marco. Việc nhấp chuột vào hot spot sẽ làm nhảy đến chủ đề có chuỗi ngữ cảnh tham chiếu đến, người sử dụng nhận biết được hot spot khi thấy con chuột đổi từ hình mũi tên sang dạng bàn tay. Marco : Là khả năng sẵn có của Windows Help nhằm thực hiện một số tác vụ trợ giúp. Các marco có thể được gọi vào lúc mở tập tin help, nảy đến một
chủ đề, hay chọn hot spot, nút trợ giúp help, menu. Hệ thống Help có sẵn 52 marco chuẩn.
Jump : Là chuyển đến một chủ đề khác theo ý muốn của người dùng
Tập tin RTF : Đây là các tập tin Rich Text Format có thể được soạn thảo nhờ
chương trình soạn văn bản có hỗ trợ file RTF. Microsoft Word for Windows có thể tạo ra file RTF. Tập tin RTF chứa văn bản nguồn để tạo ra hệ thống Help, thông qua trình biên dịch để chuyển thành tập tin .HLP
Tập Tin HPJ : (Help Project) - Đây là tập tin chủ đề chứa các lệnh liên quan
đến tập tin .RTF nhằm chuyển đến trình biên dịch Help các quan hệ của chuỗi ngữ cảnh, ảnh bipmap, các tùy chọn cấu hình nhằm điều khiển Help Compiler. Tập tin .HPJ dạng mã ASCII thông thường.
Help ContextID : Số nguyên kết hợp với chuỗi ngữ cảnh được liệt kê trong
phần [MAP] của tập tin .HPJ. Các số nguyên này sẽ được dùng như giá trị của thuộc tính Help ContextID của control hay biểu mẫu.
Hình 1 : Các thành phần của hệ thống help Help File HELPFILE.HLP (File thực thi) Bitmap File(s) *.BMP Graphics Help Project File HELPFILE.HPJ SHED File(s) *.SHG Graphics và Hot spot Topics File(s) *.RTF
Save dưới dạng file Rich Text Format
Help Compiler HCRTF.EXE
2- Các Thành Phần Trong File Help Project
Phần Mục đích và mô tả
[OPTION] Xác định các tùy chọn để điều khiển quá trình biên dịch
[FILES] Liệt kê tất cả các file tiêu đề văn bản RTF chứa trong chương trình đã được dịch, phần này là bắt buộc.
[BUILDTAGS] Xác định các build để sử dụng trong chương trình dịch. Phần này là tùy chọn
[CONFIG] Tạo ra các menu của tác giả và các nút bấm trong file help [BITMAP] Chỉ định các file bitmap chứa trong chương trình được dịch.
Phần này không bắt buộc phải có nếu file help project đã liệt kê danh sách các đường dẫn cho các file bitmap trong phần [OPTION] bằng cách sử dụng tùy chọn BMROOT.
[MAP] Phần này tổ chức các chuỗi nội dung với các số nguên HelpContextID. Phần này là tùy chọn
[ALIAS] Gán một hay nhiều chuỗi nội dung đến tiêu đề Help mẫu, phần này là tùy chọn.
[WINDOWS] Định nghĩa các tính chất của cửa sổ Help cùng với kiểu và các tính chất của mọi cửa sổ thứ hai có thể được sử dụng trong hệ thống Help. Phần này là bắt buộc nếu bạn có sử dụng cửa sổ thứ 2
Các thành phần của tham số Option trong file .HPJ :
+ BMRoot : Chỉ thư mục chứa các file hình ảnh được sử dụng trong file .rtf
+ CharSet : Chỉ định tập hợp các ký tự default + Compress : Chỉ định cách thức nén của file help. + Content : Chỉ định Topic ID
+ CNT : Chỉ định file content của file help.
+ Copyright : Dùng để thêm thông tin về version và tác giả của file help. + BDCS : Dùng chỉ định Topic ID sử dụng mã 1 byte hay 2 byte.
+ HLP : Chỉ định tên của file help
Xác định rõ đối tượng sử dụng Help, chỉ rõ trình độ, kỹ năng và định hướng tác vụ của người dùng Help. Nếu cần phải thành lập nhiều hệ thống help để áp dụng cho các loại người sử dụng khác nhau.
Thiết kế kiến trúc của chủ đề thể hiện các quan hệ giữa các chủ đề mà bạn sẽ đưa vào hệ thống Help. Bắt đầu bằng phần tổng quát nhất của kiến trúc rồi thêm các tầng kế tiếp ở mức thấp hơn.
Thiết kế kịch bản minh họa các nét chính cho mỗi chủ đề help, các từ khóa cho mỗi chủ đề hay các từ được tham chiếu đến các chủ đề.
Nếu mỗi kịch bản có nhiều nét chính (3 hay 4) thì nên chú ý cẩn thận việc tách một chủ đề lớn thành các chủ đề nhỏ hơn.
Mục tiêu thống nhất là cố gắng làm cho mỗi chủ đề nằm gọn trong một trang Help (Toàn màn hình không cần có thanh cuốn).