웹 응용 프로그램의 상황에 맞는 도움말을위한 확장 가능한 프레임 워크

Question

현재 진행중인 웹 응용 프로그램에 대해서는 여러 다른 사용자 그룹에 롤아웃하는 방법을 미리 생각해야합니다. 기능면에서 동일한 소스 파일에서 사용자 안내서 및 상황 별 도움말을 생성하는 데 사용할 수있는 문서 시스템을 갖추는 것이 중요합니다.

우리는 문서 시스템으로 DITA를 사용할 계획을 세우고 있으며 개발자가 상황에 맞는 도움말을 제공하고 기술 작성자와 강사가 채울 수있는 요소를 개발자가 지정할 수 있도록 쉽고 확장 가능한 방법을 고려 중입니다.

DITA를 기반으로 PDF 기반의 사용자 안내서와 JSP 기반 웹 응용 프로그램에 통합 된 상황 별 도움말을 생성하고자합니다. 어떤 권고 사항이 있습니까?

우리는 도움말 정보로 채워집니다 웹 페이지의 요소를 식별하는

• 제작 도구를 다음과 같은 기능을 가지고 상용 응용 프로그램을 평가하는 과정에서 이미
• 학습 관리 시스템과의 통합 웹 기반 당신이 어떤 프레임 워크 권장 사항이 있습니까

되지 않는 응용 프로그램에 대한

지원? 위뿐만 아니라, 다음 (생각할 수있는 모든 방법으로) DITA와

사용자 그룹 특정 콘텐츠 (웹 응용 프로그램에서 검색 한 사용자)

간단한 내에서 사용할 수있는 통합

• 좋은 것 다음 계층 구조에 대한 도움말 컨텍스트의 웹 응용 프로그램 쇼 (HTML) 도구 설명
• 협회 : 응용 프로그램> 페이지> 요소 (HTML 아이디?)

Answer 1

DITA 문서 구조가 아니라 도구입니다. 따라서 DITA 소스에서 PDF 또는 온라인 도움말을 제작할 때 제작 도구에 대한 선택을 제한하지 않습니다. 당신이 염두에두고있는 온라인 도움말의 종류는 명확하지 않지만 CHM과 같은 tripane보다는 응용 프로그램 자체에서 표시 할 수있는 HTML 페이지를 원하는 것처럼 들립니다.

DITA에서 산출물을 생성 할 수있는 몇 가지 도구가 있습니다. DITA-OT (Open Toolkit)는 PDF를 생성 할 수있는 XSL-FO와 HTML, CHM 및 기타 몇 가지를 만들 수있는 Sourceforge의 FOSS 도구입니다. 그렇다면 무료 DITA2Go http://dita2go.com이 HTML RTF for PDF 제작뿐만 아니라 HTML 및 여러 형태의 온라인 도움말을 만듭니다. 주제 ID 속성을 HTML 파일 이름의 일부로 (또는 원한다면 모두) 사용합니다. DITA2Go에 비해 많은 장점이 있지만 상용 프로그램도 있습니다.

PDF는 온라인 도움말 제공 형식이 아니라 고객이 인쇄하여 하드 카피로 사용할 수있는 버전이라고 생각하는 것이 가장 좋습니다. 도구 설명은 도움말 생성 도구 이상으로 웹 응용 프로그램에 달려 있습니다.