IT 도구에 대한 문서를 어떻게 전달합니까?

IT 도구에 대한 문서를 어떻게 전달합니까?

Windows에서 사용할 수 있는 IT 도구를 제공하고 싶습니다. 문제는 ISAPI 필터이며 설치, 운영 및 구성에 대해 설명하고 싶습니다.

현재 이 작업은 텍스트 파일로 이루어지며 상당히 완성되어 있지만 그다지 유용하지는 않은 것 같습니다. 내 생각엔 내가 잘 다루는 것 같아무엇문서에 있어야합니다. 나는에 대한 의견을 듣고 싶습니다.어떻게부분. Windows 웹 서버 관리자에게 문서를 전달하는 가장 좋은 방법은 무엇입니까?

.CHM? .PDF? .DOCX? .HTM ?

편집하다: 나가졌다텍스트 파일이지만 너무 길어지고 연결, 상호 참조, 색인화 및 구성을 위한 기능이 제한되어 있었습니다. 보시다시피, 주요 섹션에는 등호로 밑줄이 그어지고, 하위 섹션에는 대시로 밑줄이 쳐집니다. 그래서 이 방법으로 형식을 지정해 보았지만 결국 .txt 파일의 크기가 조정되지 않았습니다.


업데이트: 저는 SHFB를 선택했습니다. 여기에HTML 도움말 출력. 어떻게 생각하나요? 쓸 수 있는?

답변1

내 의견은 다음과 같습니다.

  • ASCII 텍스트는 훌륭합니다. 어디서나 읽을 수 있습니다.
  • HTML은 차선책입니다. 대부분 어디서나 읽을 수 있습니다.
  • PDF는 허용되지만 PDF 리더가 설치되지 않은 서버에서 참조해야 할 수도 있으므로 다소 짜증스럽습니다.
  • CHM은 어리석은 HTML 도움말 제어(HTML 도움말 제어 버그/취약성 덕분에!) 때문에 고통스럽고 잘라내기/붙여넣기에 매우 친숙한 형식이 아닙니다.
  • DOCX는 정말 짜증나는 일입니다. 서버에 "Office"가 설치되어 있지 않으며 그곳에서 문서를 참조해야 하는 경우에는 로드하지 않을 것입니다.

답변2

올바른 형식의 ASCII 텍스트 파일을 사용해야 합니다. 랩톱, 서버, Windows, Unix, Linux 등에서 읽을 수 있습니다.

서버에 무언가를 설치하는 방법을 읽기 위해 웹 브라우저, Adobe Reader, Office 또는 기타 프로그램에 의존할 필요가 없습니다. 그것은 간단하고 고통스럽지 않아야 합니다.

사실은... 급하게... 필요할 경우 휴대폰에서 텍스트 파일을 읽을 수도 있었습니다.

나는 바람직하지 않은 상황(즉, 바에서 호출을 받거나 노트북이 없는 등)으로 오전 3시에 콜로 시설에 갇힌 사람이라면 누구나 동의할 것이라고 확신합니다. ;-)

내 2센트만...

답변3

꼭 확인해 보세요아시독. 나는 그것으로 몇 가지 짧은 것들을 만들었고 출력은 매우 선명했습니다(물론 사용자 정의 가능). 일반 텍스트는 디자인상 가독성이 매우 높으며, 문서집, HTML, PDF를 쉽게 출력할 수 있습니다. 다른 변환기를 얼마든지 사용하면 CHM과 같은 다른 형식으로 변환할 수도 있습니다.

매우 다재다능한 패키지이지만 UNIX 중심 패키지이기 때문에 Windows 지원이 어떤지 모르겠습니다.

답변4

귀하가 이미 답변을 수락했다는 것을 알고 있지만 추천하고 싶습니다.스핑크스. reStructuredText로 문서를 작성하지만 검색 가능한 HTML(작은 자바스크립트)을 쉽게 생성할 수 있습니다. /

관련 정보