문서 사이트 가져오기 및 내보내기

기존 헬프 센터를 Clevera 문서 사이트로 이동하거나 사이트의 모든 데이터를 zip 파일로 다운로드하세요. 가져오기를 통해 페이지, 이미지, 구조, 번역 및 이전 주소를 그대로 가져올 수 있으며, 내보내기를 통해 콘텐츠를 HTML 또는 마크다운 파일로 받을 수 있습니다. 두 기능 모두 무료입니다.

시작하기 전에#

• 문서 사이트를 열고 설정 → Import & export로 이동하세요.
• 워크스페이스 소유자만 가져오기 또는 내보내기를 수행할 수 있습니다. 관리자는 탭을 열어 확인할 수는 있지만, "워크스페이스 소유자만 콘텐츠를 가져오거나 내보낼 수 있습니다."라는 메시지와 함께 제어 기능은 비활성화됩니다.
• 모든 플랜에서 가져오기 및 내보내기 시 크레딧이 차감되지 않습니다.
• 가져온 페이지는 게시하기 전까지는 라이브 상태가 아니므로 먼저 검토할 수 있습니다.

문서 가져오기#

1. 플랫폼 선택#

   콘텐츠 가져오기에서 문서가 있는 플랫폼을 클릭하세요. 목록에 없는 경우 기타 문서 사이트를 선택하세요.

   

2. 연결#

   연결 방법에서 연결 방식을 선택하고 필드를 입력한 다음 연결 확인을 클릭하세요. 각 항목에 필요한 정보는 플랫폼 및 방법을 참조하세요.

3. 미리보기#

   Clevera가 발견한 섹션과 페이지 목록을 표시합니다. 원하지 않는 페이지는 체크를 해제하세요. 사이트 규모가 크면 "모든 섹션과 페이지를 나열하는 중입니다."라는 메시지와 함께 시간이 조금 걸릴 수 있습니다.

4. 옵션 선택#

   페이지를 배치할 위치와 가져올 언어를 선택하세요. 가져오기 옵션을 참조하세요.

5. 확인 및 시작#

   예를 들어 "120개의 페이지를 새 섹션 “Help center”로 복사합니다."와 같은 요약 정보와 예상 소요 시간을 확인한 후 가져오기 시작을 클릭하세요.

작업이 진행되는 동안 창을 닫아도 됩니다. "이 창을 닫아도 됩니다. 가져오기가 완료되면 이메일로 알려드립니다." 진행 상황은 페이지 가져오는 중, 이미지 복사 중, 페이지 연결, 리다이렉트 추가 중으로 표시되며 페이지, 이미지, 실패 건수가 함께 나타납니다.

완료되면 "platform에서 가져오기가 준비되었습니다"라는 이메일이 발송되며 보고서 보기 버튼이 포함됩니다. 이후 페이지를 검토하고 사이트를 게시하세요.

플랫폼 및 방법#

각 플랫폼 카드에는 지원되는 방법인 API, 공개 사이트, 리포지토리 / zip이 표시됩니다.

방법#

공개 사이트. 공개 문서의 주소(홈페이지 또는 문서 페이지)를 사이트 주소에 붙여넣으세요. Clevera는 robots.txt을 준수하는 적절한 속도로 내비게이션이나 사이트맵에 나열된 페이지를 읽어옵니다. 해당 주소 하위의 페이지만 읽으며, 비공개 아티클이나 초안은 포함되지 않습니다.

API 토큰 또는 키. 다른 플랫폼에서 생성한 토큰을 붙여넣으세요. 각 플랫폼 카드에는 단계와 생성 위치로 연결되는 링크가 있습니다. Clevera는 읽기 전용으로만 접근합니다. 토큰은 가져오기가 진행되는 동안만 사용되며 24시간 이내에 삭제됩니다. 가져오기가 완료되면 다른 플랫폼에서 토큰을 취소할 수 있습니다.

Git 리포지토리. 리포지토리 주소(GitHub, GitLab 또는 Bitbucket)를 붙여넣으세요. 비공개 GitHub 리포지토리의 경우, 콘텐츠에 대한 읽기 전용 권한이 있는 액세스 토큰을 추가하세요. Clevera는 기본 브랜치를 아카이브로 다운로드하며 코드를 실행하지 않습니다.

zip 업로드. 최대 200MB까지 문서를 .zip로 업로드하세요. Clevera는 마크다운, MDX, JSON, YAML 및 이미지를 읽고 나머지는 무시합니다. 기타 문서 사이트의 경우 zip 파일에 .md, .mdx 또는 .html 파일이 포함될 수 있으며, 각 최상위 폴더는 섹션이 됩니다.

플랫폼 참고 사항#

• Intercom은 다른 앱과 액세스 토큰 공유를 허용하지 않으므로 Clevera가 공개 헬프 센터를 읽어옵니다.
• Zendesk API 액세스는 Team 플랜 이상의 관리자가 필요합니다. 상담원은 게시된 아티클을 읽을 수 있으며, 가이드 관리자는 초안 및 제한된 아티클도 가져올 수 있습니다.
• Help Scout에서는 게시된 아티클만 또는 게시된 아티클 및 초안을 선택할 수 있습니다. API 키는 읽기 전용으로 설정할 수 없으므로 완료 후 키를 삭제하세요.
• ReadMe API 참조 페이지, 레시피 및 사용자 지정 페이지는 ReadMe에 유지됩니다.
• Document360 API 액세스는 Business 및 Enterprise 플랜에서 제공되며 최신 API 키가 필요합니다.
• Notion은 워크스페이스 소유자가 "콘텐츠 읽기 전용" 권한으로 연결을 생성해야 합니다.
• Confluence는 Confluence Cloud 사이트에서 작동합니다.
• 여러 버전이 있는 문서의 경우 최신 버전만 가져옵니다.

가져오기 옵션#

공개 사이트 방법을 사용하는 경우 시작하기 전에 "본인은 이 콘텐츠를 소유하고 있거나 복사할 권리가 있습니다."에 체크해야 합니다.

구조 가져오기 방식#

• 페이지, 이미지, 섹션, 그룹, 번역, 리디렉션 및 변경 로그 항목이 가져와집니다.
• 문서 사이트에는 섹션 아래에 한 단계의 그룹이 있습니다. 더 깊은 단계는 한 단계 위로 이동하며 보고서에 경고가 표시됩니다.
• 가져온 페이지는 게시할 준비가 되며 다음 게시 시 라이브 상태가 됩니다. 가져온 변경 로그 항목은 초안으로 들어옵니다.
• 이미지는 사이트로 복사됩니다. 복사할 수 없는 이미지는 경고와 함께 제외되며 대체 텍스트는 유지됩니다.
• 가져온 페이지 간의 링크는 새 주소를 가리키도록 변경됩니다. 가져오지 않은 페이지에 대한 링크는 원래 주소를 유지합니다.
• 메뉴가 아닌 사이트맵에서만 발견된 페이지는 "기타 페이지"라는 그룹으로 들어갑니다.

제한 사항#

카드에는 오늘 남은 가져오기 횟수와 페이지 제한이 표시됩니다.

가져오기 보고서#

최근 가져오기에서 보고서 보기를 클릭하세요. 보고서에는 섹션과 가져옴, 건너뜀, 실패, 이미지, 리디렉션의 총계가 표시됩니다. 실패, 경고 포함 또는 건너뜀별로 페이지를 필터링하고 에디터에서 열기를 클릭하여 수정하세요.

경고 예시:

• "이 페이지는 문서 사이트에서 허용하는 것보다 깊게 중첩되어 있어 한 단계 위로 이동되었습니다."
• "이미지를 복사할 수 없어 제외되었습니다."
• "이 주소를 가진 페이지가 이미 존재하여 건너뛰었습니다."
• "건너뜀: robots.txt 또는 사이트 주소 규칙으로 인해 이 페이지를 읽을 수 없습니다."

가져오기 취소 또는 중단#

• 가져오기 취소는 현재 읽고 있는 페이지 이후에 중단됩니다. 이미 가져온 페이지는 유지되며 보고서에서 취소할 수 있습니다.
• 가져오기 취소는 가져오기로 생성된 페이지, 이미지, 리디렉션 및 변경 로그 항목을 삭제하며, 비어 있는 경우 새 섹션도 삭제합니다.

사이트 내보내기#

1. 형식 선택#

   데이터 내보내기에서 내보내기 형식을 선택하세요: HTML(브라우저에서 여는 페이지, 별도 폴더의 이미지) 또는 마크다운(일반 .md 파일, 별도 폴더의 이미지).

   

2. 요청하기#

   내보내기 요청을 클릭하세요. "내보내기가 요청되었습니다. 10분 이내에 귀하의 주소로 다운로드 링크를 이메일로 보내드립니다."라는 메시지가 표시됩니다.

3. 다운로드#

   "site 내보내기가 준비되었습니다" 이메일을 열고 내보내기 다운로드를 클릭하세요. Clevera에 로그인되어 있어야 합니다. 링크는 7일 동안 유효하며, 내보내기 파일은 만료될 때까지 다운로드 카드 아래에도 표시됩니다.

zip 파일에는 다음이 포함됩니다:

• 사이트의 모든 페이지(초안 포함, "Draft"로 표시됨), 모든 언어, 사이트 페이지 포함.
• 변경 로그(초안 포함).
• 이미지(각각 하나씩 저장됨).
• 탐색, 사이트 설정, 리디렉션(redirects.csv) 및 동영상 목록(videos.csv), 파일에 대한 설명이 담긴 README.txt.

사이트당 하루(24시간 기준)에 3번까지 내보내기를 요청할 수 있습니다. 실패한 내보내기는 횟수에 포함되지 않습니다. 내보내기를 요청한 사람만 다운로드할 수 있습니다. 소유자가 내보내기를 수행하면 관리자에게 내보내기가 완료되었다는 알림이 전송됩니다.

동영상#

동영상은 zip 파일에 포함되지 않습니다. 파일 내에서 각 동영상은 "이 동영상 보기 / 내보내기" 링크로 제공됩니다. 동영상 카드에는 사이트 페이지에 있는 모든 Clevera 동영상이 영상 내보내기와 함께 나열되며, 이를 클릭하면 원하는 품질로 동영상을 내보낼 수 있습니다.

문제 해결#

관련 항목#