마크다운으로 작성한 사이트 매뉴얼웍스로 가져오기

매뉴얼웍스 6.0.15 버전부터 마크다운으로 작성한 사이트를 매뉴얼웍스의 문서로 전환하는 기능을 제공합니다.

마크다운 사이트를 문서로 전환하는 전체 과정은 다음과 같습니다.

  1. 사이트 등록: 사이트 URL과 마크다운 패턴을 설정합니다.

  2. 크롤링: 사이트를 크롤링하여 링크를 수집합니다.

  3. 링크 선택: 문서로 만들 링크를 선택합니다.

  4. 문서 생성: 선택한 링크를 장으로 하는 문서를 만듭니다.

마크다운으로 작성한 사이트란?

마크다운으로 작성한 사이트는 HTML과 마크다운 URL이 존재하고, 둘 사이의 관계를 정규표현식으로 나타낼 수 있음을 의미합니다. 예를 들어 GitHub Docs가 대표적입니다.

https://docs.github.com/en/get-started

https://docs.github.com/en/get-started.md

두 URL의 관계는 정규표현식으로 다음과 같이 표현됩니다.

(.+)

$1.md

(.+)은 URL 전체를 캡처하고, $1.md는 캡처한 값 뒤에 .md를 붙입니다. 사이트마다 HTML URL과 마크다운 URL의 관계가 다르므로, 패턴은 환경에 맞게 수정합니다.

사이트 만들기

다음 순서로 사이트를 만듭니다.

  1. <도구 | 사이트> 메뉴로 이동합니다.

    • "관리" 권한이 필요합니다.

  2. <사이트 생성> 링크를 클릭합니다.

  3. "기본 정보"를 입력한 후 버튼을 클릭합니다.

다음을 참고합니다.

1사이트 이름을 입력합니다.

2사이트 URL을 입력합니다. 크롤링의 기준이 됩니다.

3크롤링을 시작할 시작 URL을 입력합니다. 입력하지 않으면 사이트 URL에서 시작합니다.

4정규표현식으로 마크다운 패턴과 5치환을 입력합니다.

6너무 큰 사이트의 경우 전체를 크롤링하는 데 긴 시간이 걸립니다. 따라서 크롤링 범위를 제한해야 합니다. URL 필터에 그 값을 입력합니다.

크롤링하여 링크 수집하기

사이트 설정이 끝나면 <1링크 가져오기> 링크를 클릭해서 크롤링으로 링크를 수집합니다. 사이트 규모에 따라 오랜 시간이 걸릴 수 있습니다. 그래서 URL 필터를 설정하는 것을 권장합니다. 크롤링을 멈추려면 <2크롤링 중지> 링크를 클릭합니다.

크롤링이 끝나면 그리드 목록에 링크가 나타납니다. 마크다운 URL이 없다면 마크다운 치환이 실패한 것으로 이 링크는 매뉴얼웍스로 가져올 수 없습니다. 마크다운 URL이 있어도 클릭했을 때 마크다운 문서를 찾지 못해도 마찬가지입니다.

문서 만들기

그리드 목록에서 문서로 만들 링크를 선택합니다. 선택이 끝나면 <책 만들기> 링크를 클릭해서 선택한 링크를 장으로 하는 문서를 만듭니다. 다음을 참고합니다.