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

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

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

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

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

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

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

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

마크다운으로 작성한 사이트는 HTML URL과 마크다운 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이 있어도 클릭했을 때 마크다운 문서를 찾지 못하면 마찬가지로 매뉴얼웍스로 가져올 수 없습니다.

문서 만들기

<3책 만들기> 링크를 클릭해 문서를 만듭니다. 선택한 링크가 장이 됩니다.

다음을 참고합니다.