Bài giảng Nhập môn Công nghệ phần mềm: Viết tài liệu hướng dẫn sử dụng

Đại Học Sư Phạm Tp. Hồ Chí Minh Đại Học Sư Phạm Tp. Hồ Chí Minh Tin Học Khoa Toán –– Tin Học Khoa Toán

NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM

Viết tài liệu hướng dẫn

Người trình bày: Trần Ngọc Bảo Email: baotn@hcmup.edu.vn

Giai đoạn triển khai

• Đóng gói sản phẩm

ó ả

ó

ẩ

Khảo sát Khảo sát

• Cài đặt thử nghiệm với dữ liệu

thực tế của khách hàng thực tế của khách hàng

Phân tích Phân tích

• Hướng dẫn sử dụng

Thiết kế Thiết kế Thiết kế Thiết kế

Nội dung Nội dung

Cài đặt Cài đặt

• Chương trình cài đặt • Chương trình cài đặt • Tài liệu Hướng dẫn cài

Kiểm tra Kiểm tra

đặt

• Tài liệu Hướng dẫn cấu

ẫ

Triển khai Triển khai

Kết quả Kết quả

hình hệ thống

Bảo trì Bảo trì

TIN HỌC (cid:148)(cid:148) ĐẠI HỌC SƯ PHẠM TP.HCM ( TIN HỌC (cid:148)(cid:148) ĐẠI HỌC SƯ PHẠM TP.HCM ( ĐẠI HỌC SƯ PHẠM TP.HCM (22)) ĐẠI HỌC SƯ PHẠM TP.HCM (22)) TRẦN NGỌC BẢO (cid:148)(cid:148) KHOA TOÁN TRẦN NGỌC BẢO (cid:148)(cid:148) KHOA TOÁN TRẦN NGỌC BẢO TRẦN NGỌC BẢO 22 KHOA TOÁN --TIN HỌC KHOA TOÁN --TIN HỌC

hoc Su Pham TP.HCM Tran Ngoc Bao DaiDai hoc Su Pham TP.HCM Tran Ngoc Bao

MỤC TIÊU

• Biết được các loại tài liệu

i ài liệ

iế đ

á l

N • Cấu trúc cơ bản của tài liệu hướng • Cấu trúc cơ bản của tài liệu hướng

dẫn

• Biết được cách sử dụng một số công

cụ để tạo tài liệu hướng dẫn cài đặt,

i i

G G N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

sử dụng,…(CHM, Web, HTML,…) )

(CHM W b HTML

ử d

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

TRẦN NGỌC BẢO (cid:148)(cid:148) KHOA TOÁN TRẦN NGỌC BẢO (cid:148)(cid:148) KHOA TOÁN TRẦN NGỌC BẢO TRẦN NGỌC BẢO KHOA TOÁN --TIN HỌC KHOA TOÁN --TIN HỌC TIN HỌC (cid:148)(cid:148) ĐẠI HỌC SƯ PHẠM TP.HCM ( TIN HỌC (cid:148)(cid:148) ĐẠI HỌC SƯ PHẠM TP.HCM ( ĐẠI HỌC SƯ PHẠM TP.HCM (33)) ĐẠI HỌC SƯ PHẠM TP.HCM (33))

NỘI DUNG TRÌNH BÀY

• Các loại tài liệu

i ài liệ

Cá l

N • Các định dạng tài liệu thường dùng • Các định dạng tài liệu thường dùng

Giới thiệu một số công cụ sử dụng • Giới thiệu một số công cụ sử dụng

• Hướng dẫn tạo tài liệu hướng dẫn cài

đặt, sử dụng với định dạng CHM,

i

G G N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

i Web Help

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Các loại tài liệu

(1) (1)

User Guide User Guide

(2) (2)

……

Installation Installation Guide Guide

Documentation Documentation

(6) (6)

(3) (3)

Release Notes Release Notes

Technical Technical Documents Documents

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

(5) (5)

(4) (4)

I I

Brochures Brochures

yy Version History Version History

À À BB B B

Các định dạng tài liệu thường dùng

• Dạng tập tin PDF tậ ti PDF

D

• Dạng tập tin CHM

• Dạng tập tin HLP

• Dạng tập tin DOC, DOCX

• ….

i i

G G N N N N Ụ Ụ D D Ử Ử S S N • Dạng tập tin HTML (Web help) • Dạng tập tin HTML (Web help) N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin CHM

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin CHM

hí h t

(cid:135) Các thành phần chính trong tập tin CHM (cid:135) Cá thà h hầ tậ ti CHM

• Content

• Index

• Search • Search

• Favorite

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin CHM

(cid:135) Thành phần: Content (cid:135) Thà h hầ C t t

Topic

i i

G G N N N N Ụ Ụ D D Ử Ử S S N Heading Heading N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin CHM

I d

(cid:135) Thành phần: Index (cid:135) Thà h hầ

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Keyword Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin CHM

S

(cid:135) Thành phần: Search (cid:135) Thà h hầ h

NhậpNhập cần tìm từtừ cần tìm

i

I I

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế i KếtKết quả quả V V tìm kiếm tìm kiếm

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin CHM

it

F

(cid:135) Thành phần: Favorites (cid:135) Thà h hầ

Danh sách Danh sách Topic CácCác Topic thường dùng thường dùng thường dùng thường dùng

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Đại Học Sư Phạm Tp. Hồ Chí Minh Đại Học Sư Phạm Tp. Hồ Chí Minh Tin Học Khoa Toán –– Tin Học Khoa Toán

NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM

Minh họa tập tin CHM

Tập tin HLP

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin HLP

hí h t

(cid:135) Các thành phần chính trong tập tin HLP (cid:135) Cá thà h hầ tậ ti HLP

• Content

• Index

• Find • Find

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin HLP

t

(cid:135) Thành phần: Contents (cid:135) Thà h hầ C t

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin HLP

I d

(cid:135) Thành phần: Index (cid:135) Thà h hầ

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin HLP

(cid:135) Thành phần: Find (cid:135) Thà h hầ Fi d

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Đại Học Sư Phạm Tp. Hồ Chí Minh Đại Học Sư Phạm Tp. Hồ Chí Minh Tin Học Khoa Toán –– Tin Học Khoa Toán

NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM

ọ Minh họa HLP

Web Help

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Web Help

hí h t

b H l

(cid:135) Các thành phần chính trong web Help (cid:135) Cá thà h hầ

• Content

• Index

• Search • Search

• Favorite

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Web Help

(cid:135) Thành phần: Content (cid:135) Thà h hầ C t t

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Web Help

I d

(cid:135) Thành phần: Index (cid:135) Thà h hầ

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Web Help

S

(cid:135) Thành phần: Search (cid:135) Thà h hầ h

NhậpNhập cần tìm từtừ cần tìm

i

I I

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế i KếtKết quả quả V V tìm kiếm tìm kiếm

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Đại Học Sư Phạm Tp. Hồ Chí Minh Đại Học Sư Phạm Tp. Hồ Chí Minh Tin Học Khoa Toán –– Tin Học Khoa Toán

NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM

Minh họa Web Help

Các công cụ hỗ trợ

• Dạng tập tin DOC, PDF tậ ti DOC PDF

D

• Dạng tập tin CHM

(cid:57) HTML Help

(cid:57) Robo Help, DocToHelp (C1) (cid:57) Robo Help DocToHelp (C1)

• Dạng tập tin HLP

(cid:57) Help Workshop

Robo Help, DocToHelp (C1) (cid:57) Robo Help, DocToHelp (C1)

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

• Dạng tập tin HTML (Web help)

I I

À À BB B B

(cid:57) Robo Help, DocToHelp (C1)

Công cụ HTML Help

• Được sử dụng để tạo các tập tin CHM từ HTML • Được sử dụng để tạo các tập tin CHM từ HTML

• Được sử dụng để tạo tập tin CHM từ tập tin HLP

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ HTML Help – Project file (*.HHP)

• Các thành phần của Project (.HHP): t ( HHP)

Cá thà h hầ

ủ P j

(cid:57) Tập tin Contents (*.HHC): chứa Heading và Topic

(cid:57) Tập tin Index (*.HHK): chứa các Keyword

(cid:57) Danh sách các tập tin HTML liên kết với Heading, (cid:57) Danh sách các tập tin HTML liên kết với Heading

Topic, và Keyword

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ HTML Help – Project file (*.HHP)

• Để tạo tập tin project (*.HHP) thực hiện theo các

t (* HHP) thự hiệ th

tậ ti

Để t

á

j

bước sau:

(cid:57) Chọn File/New/Project

(cid:57) Chọn Next, đường dẫn và tên tập tin project Chọn Next, đường dẫn và tên tập tin project

(cid:57) Thực hiện theo các bước Project Wizard

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ HTML Help – Tổ chức TOC

• Tập tin TOC (*.HHC) – Table of Contents:

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ HTML Help – Tổ chức TOC

• Tập tin TOC (*.HHC) – Table of Contents:

Thêm Heading mới Thêm Heading mới

Thêm Topic mới

Cập nhật Heading/Topic

Thay đổi Level của Heading/Topic

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ HTML Help – Tổ chức TOC

• Để tạo tập tin TOC: tậ ti TOC

Để t

(cid:57) Chuyển qua Tab Contents

(cid:57) Chọn option “Create a new contents file”

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ HTML Help – Tổ chức Index

• Tập tin chỉ mục (*.hhk) - Index

(* hhk)

Tậ ti

I d

hỉ

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ HTML Help

• Để tạo tập tin (.CHM) từ tập tin project (.HHP) t (* HHP) (* CHM) từ tậ ti

tậ ti

Để t

j

thực hiện theo các bước sau:

(cid:57) Chọn File/Compile

(cid:57) Nhập đường dẫn và tên tập tin HHP cần biên dịch Nhập đường dẫn và tên tập tin HHP cần biên dịch

(cid:57) Chọn Complile

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ HTML Help

Kết

• Kết quả biên dịch tập tin HHP (cid:198) tập tin CHM ả biê dị h tậ ti HHP (cid:198) tậ ti CHM

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ RoboHelp

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ RoboHelp

• Project trong RoboHelp (*.mpj) j)

R b H l

P j

t t

(*

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ RoboHelp

• TOC trong RoboHelp

R b H l

TOC t

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Công cụ DocToHelp

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

40 4040

Bài giảng Nhập môn Công nghệ phần mềm: Viết tài liệu hướng dẫn sử dụng - TS. Trần Ngọc Bảo

Đại Học Sư Phạm Tp. Hồ Chí Minh Đại Học Sư Phạm Tp. Hồ Chí Minh Tin Học Khoa Toán –– Tin Học Khoa Toán

NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM NHẬP MÔN CÔNG NGHỆ PHẦN MỀM

Viết tài liệu hướng dẫn

Người trình bày: Trần Ngọc Bảo Email: baotn@hcmup.edu.vn

Giai đoạn triển khai

ó ả

ó

ẩ

Khảo sát Khảo sát

thực tế của khách hàng thực tế của khách hàng

Phân tích Phân tích

Thiết kế Thiết kế Thiết kế Thiết kế

Nội dung Nội dung

Cài đặt Cài đặt

Kiểm tra Kiểm tra

đặt

ẫ

Triển khai Triển khai

Kết quả Kết quả

hình hệ thống

Bảo trì Bảo trì

hoc Su Pham TP.HCM Tran Ngoc Bao DaiDai hoc Su Pham TP.HCM Tran Ngoc Bao

MỤC TIÊU

• Biết được các loại tài liệu

i ài liệ

iế đ

á l

N • Cấu trúc cơ bản của tài liệu hướng • Cấu trúc cơ bản của tài liệu hướng

dẫn

• Biết được cách sử dụng một số công

cụ để tạo tài liệu hướng dẫn cài đặt,

i i

G G N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

sử dụng,…(CHM, Web, HTML,…) )

(CHM W b HTML

ử d

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

NỘI DUNG TRÌNH BÀY

• Các loại tài liệu

i ài liệ

Cá l

N • Các định dạng tài liệu thường dùng • Các định dạng tài liệu thường dùng

Giới thiệu một số công cụ sử dụng • Giới thiệu một số công cụ sử dụng

• Hướng dẫn tạo tài liệu hướng dẫn cài

đặt, sử dụng với định dạng CHM,

i

G G N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

i Web Help

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Các loại tài liệu

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Các định dạng tài liệu thường dùng

• Dạng tập tin PDF tậ ti PDF

D

i i

G G N N N N Ụ Ụ D D Ử Ử S S N • Dạng tập tin HTML (Web help) • Dạng tập tin HTML (Web help) N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin CHM

i i

G G N N N N Ụ Ụ D D Ử Ử S S N N N N Ẫ Ẫ D D G G N N Ớ Ớ Ớ Ớ Ư Ư H H T T Ế Ế V V

I I

M M Ề Ề Ề Ề M M N N Ầ Ầ H H P P P P Ệ Ệ H H G G N N G G G G N N Ô Ô C C N N Ầ Ầ H H H H P P C C Ọ Ọ H H G G G G N N Ả Ả G G

I I

À À BB B B

Tập tin CHM