vim에 대한 도움말 파일 생성


8

현재 문서를 vim 도움말 파일로 직접 작성합니다. 때로는 다른 형식 (예 : PDF)을 생성해야합니다. 내 작업 흐름은 도움말 파일의 내용을 복사하여 필요한 것으로 변환하는 것입니다. 나는 대부분 추가 ​​마크 업을 추가해야하기 때문에 상당히 지루한 작업이다.

Markdown의 접근 방식이 마음에 듭니다 (예 : Pandoc 사용)는 다양한 출력 형식으로 변환 될 수 있습니다. 불행히도 vim 도움말 파일은 아닙니다. 표준 입력 형식 (예 : XML, Markdown, ReStructed Text, 일반 텍스트 등) 사용 하고 vim 도움말 파일을 출력 하는 변환기를 찾고 있습니다. 아니면 그러한 변환기를 직접 작성하지 않고 vim 도움말 파일을 자동으로 생성하는 다른 방법이 있습니까?


몇 시간 내에 XSLT 스타일 시트를 함께 사용할 수 있습니다.
Ignacio Vazquez-Abrams

답변:


11

아주 오래된 실을 부활 시켜서 죄송합니다. 나는 lornix가 이전에 mkd2vimdoc제안한 첫 번째 링크 뒤의 스크립트 작성자입니다 . 나는 최근에 html2vimdoc처음 부터 다시 썼습니다 . 여전히 입력 형식으로 마크 다운을 지원합니다. Markdown을 HTML로 변환 한 다음 해당 HTML을 Vim 도움말 파일로 변환합니다. 재 작성 중 중점은 광범위한 입력 문서를 지원하는 데있었습니다.mkd2vimdoc

새 스크립트는 본인과 다른 여러 플러그인 작성자가 사용하므로 일반적인 용도로 사용됩니다. 다시 시도해보고 싶다면 지금 사용하려는 문서에 더 잘 작동하는지 듣고 싶습니다. 그래도 작동하지 않으면 GitHub에 문제를 작성하십시오.


3
수퍼 유저에 오신 것을 환영합니다! 오래된 질문에 대답하는 것은 여기에 감사합니다. 일부 사람들은 여전히 ​​그에 대한 답변을 찾고있을 수 있으며 이전 질문을 개선하는 것이 좋습니다.
gronostaj 2016 년

4

필자가 마크 다운을 vim 문서로 변환하기 위해 만든 스크립트를 찾았 습니다. 찾고있는 것과 매우 흡사합니다.

동안 vim.org 스크립트 ( GitHub의 REPO ) 변환 인하 거의 모든하지만 vimdoc의 모습에. (한숨) 너무 가까이 ... 아마도 약간의 수정?


첫 번째 스크립트는 일반적인 용도로는 사용할 수 없습니다. 저자 마크 업 스타일에서는 작동하지만 내 (유효한) 마크 다운 파일 중 하나를 올바르게 변환하지 않았습니다. 두 번째 옵션은 pandoc입니다. 제가 좋아하는 매우 유능한 변환기입니다. 불행히도, 그것은 vimhelp를 지원하지 않습니다. 메일 링리스트에 지원을 추가해달라고 요청했지만, vimhelp는 다른 지원되는 형식과 달리 범용 출력 형식이 아니라 vim 문서 용으로 특수화 된 형식이라는 응답이있었습니다. 어쨌든 팁을 주셔서 감사합니다.
Marco

vimdoc의 대부분은 형식화 및 특수 마커 문자 인 반면, helptags 명령 및 vim 도움말 뷰어 자체에서 마술이 수행되므로 markdown에서 vimdoc로 변환기를 만드는 것이 무엇인지 궁금합니다. 물론, 나는 내 발을 내 입에 넣을 수 있었다.
lornix 2016 년

메일 링리스트에서 제안 된 현명한 해결 방법은 유효한 마크 다운 인 vimhelp를 만드는 것입니다. 단점은 마크 다운이 vim 구문으로 약간 어수선하고 vimhelp 파일이 형식 지정 규칙을 따르지 않는다는 것입니다. 그러나 그 외에는 사용할 수 있습니다.
Marco
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.