Markdown/org-mode 형식으로 작성된 컴퓨터 프로그램 매뉴얼이 있다고 가정해 보겠습니다. 매뉴얼은 장, 절, 하위 절로 구성된 책으로 작성되었습니다.
Pandoc이 이 Markdown 파일을 HTML로 변환할 수 있다는 것을 알고 있습니다. 하지만 각 장(가령)을 자체 HTML 페이지로 변환하고 다음 및 이전 장이나 섹션에 연결하려면 어떻게 해야 할까요?
예를 들어 SWIG를 문서화한 웹사이트를 생각해 보세요.http://swig.org/Doc3.0/Sections.html이것이 바로 내가 Pandoc의 출력을 내 마크다운 파일에 포함시키려는 구조입니다.
나는 latex2html이 Latex 파일에 대해 이 작업을 수행할 수 있고 Pandoc이 markdown을 latex로 변환할 수 있다는 것을 알고 있지만 결과 출력이 마음에 들지 않습니다. 나는 외부 프로그램을 포함하지 않는 순수한 pandoc 솔루션을 선호합니다.
답변1
이것은 완전히 사소한 것이 아닙니다. 좋은 접근 방식은 pandoc에서 사용할 사용자 정의 HTML 템플릿을 작성하는 것입니다.
% pandoc -D html > my-page-template.html
# edit my-page-template.html to your liking
해당 템플릿에는 이전 페이지와 다음 페이지에 대한 링크가 포함될 수 있습니다.
$if(next-page)$<a href="$next-page$">next</a>$endif$
각 파일 이름은 명령줄을 통해 전달되므로 pandoc이 올바른 값을 삽입할 수 있습니다.
pandoc -M next-page=introduction.html --template=my-page-template.html …
쉘이나 다른 스크립팅 언어로 작성된 래퍼 스크립트가 유용할 것입니다.
보시다시피 이것은 꽤 많은 작업이 될 수 있습니다. 다행히도 누군가 이미 이 모든 작업을 수행하여 R 패키지에 포함시켰습니다.북다운. 보기 좋은 출력을 생성하므로 적극 권장합니다.