HTML에서 HelpFile 생성

Question

큰 프로젝트를위한 도움말 파일을 만드는 재미있는 작업에 직면하고 있습니다. 제약 조건으로 인해 CHM 파일을 폐기했으며 이제 HTML 기반 파일을 조사하고 있지만 여전히 형식에서 결정되지 않았습니다 ....

초점을 맞추고있는 3 가지 영역이 있습니다.

섹션의 재사용 가능성 (많은 페이지가 하나의 텍스트를 참조 할 수 있음) 일부 섹션은 HelpFile에서 두 번 이상 사용되므로 마스터 섹션을 작성한 다음 각 하위 섹션의 마스터 섹션에 링크해야합니다. 이것은 편집 할 때 캡션을 여러 장소로 변경하지 않아도됩니다.

SearchFunctionality 파일에서 무료 텍스트를 검색하고 싶습니다.

인쇄 성. 사용자는 섹션 또는 Wholde 문서를 인쇄하도록 선택할 수 있습니다.

나는 위키를 배포하기 위해 정적 페이지로 내보내기 위해 플러그인을 갖는 위키 접근법에 먼저 기대했지만 그 솔루션을 찾지 못했습니다 ...

이 문제에서 여러분의 제안이 있습니까? 복잡하게 헬프 파일을 만들고 있습니까?

미리 감사드립니다!

Answer 1

재사용 성

나는 두 가지 접근법을 본다. 재사용하려는 섹션의 개별 페이지를 작성한 다음 적절한 곳에서 단순히 링크 할 수 있습니다. 이것은 HTML에서 사소합니다.

대안으로 해당 섹션의 정보와 함께 스 니펫 또는 HTML 조각을 만들 수있는 다음 서버 측 포함 (또는 유사한 기술)을 사용하여 필요한 곳이면 인라인을 포함시킬 수 있습니다. 이런 식으로 컨텐츠는 모든 개별 페이지에서 작성된 것으로 보이지만 편집을해야 할 때는 여전히 한 곳에 있습니다.

검색

사이트가 공개되면 Google에 색인을 표시하고 Google 검색 창을 제공하십시오. 당신은 그보다 더 나은 결과를 얻지 못할 것입니다.

인쇄 성

CSS의 "인쇄 스타일 시트"는 조립하기 쉽고 웹에서 사이트를 매력적으로 만드는 모든 그래픽 요소를 제거하여 종이에 사용할 컨텐츠를 모두 보존 할 수 있습니다.

전체 문서를 한 번에 인쇄하려면 인쇄 목적으로 모든 내용을 단일 페이지로 결합하기 위해 약간의 프로그래밍이 필요합니다. 개인적으로, 나는 사람들이 신문을 낭비하지 못하게하기 위해 그 서비스를 제공하는 것을 선호합니다.

물론, 우리는 이러한 것들을 달성하는 방법에 대한 모든 통찰력을 제공 할 수 있지만, 현재 일반적인 조언을 받고있는 것처럼 들리기 때문에 그것은 내 것입니다.

Answer 2

나는 Wikis가 특히 두 명 이상의 사람이 프로젝트에 참여할 때 문서화에 완벽하다고 생각합니다. Wiki 페이지 또는 네임 스페이스 사이의 링크가 쉽게 달성됩니다. 페이지를 바꾸면 다른 문서의 모든 하이퍼 링크가 변경됩니다. 그래도 가능한 한 컨텐츠의 복제를 피할 수 있습니다.

나는 사용한다 도쿠키 페이지 내보내기를 지원합니다. 전체 Wiki를 일반 텍스트, XHTML 또는 XHTML 본체에 버릴 수 있습니다 (자신의 템플릿 내부에 넣거나 인쇄를 위해 단일 파일에 추가).

도움이되기를 바랍니다!