GitHub에 아티클 게시

GitHub을 한 번만 연결하면 모든 Clevera 아티클을 문서 사이트, 위키 스타일의 docs/ 폴더 또는 README 모음용 Markdown 파일로 리포지토리에 게시할 수 있습니다. 이 아티클에서는 연결 방법, 리포지토리 및 폴더 선택 방법, 파일 형태, 업데이트 작동 방식을 다룹니다.

시작하기 전에#

• 플랜: GitHub에 게시하는 기능은 Pro 및 Custom 플랜에서 제공됩니다. Free 및 Starter 플랜의 경우 게시 탭에 "도구에 게시하는 기능은 Pro 플랜에 포함되어 있습니다"라는 메시지가 표시됩니다. 플랜 선택을 확인하세요.
• Clevera 내 역할: 워크스페이스 소유자 또는 관리자만 GitHub을 연결하거나 연결 해제할 수 있습니다. 연결이 완료되면 아티클을 편집할 수 있는 누구나 게시할 수 있습니다.
• GitHub 액세스: 연결하는 사용자는 게시하려는 리포지토리에 대한 쓰기 액세스 권한이 있어야 하며, 해당 개인 계정이나 조직에 GitHub 앱을 설치할 권한이 있어야 합니다(또는 조직 소유자의 승인이 필요합니다).
• 아티클: 동영상이나 녹화본에 속한 아티클을 게시합니다. 먼저 생성하세요. 녹화본을 아티클로 변환을 참조하세요.

게시 시 크레딧은 차감되지 않습니다.

GitHub 연결#

1. 연동 열기#

   사이드바에서 워크스페이스 메뉴를 열고 연동을 선택하세요. 사용 가능한 연동(또는 개발 탭)에서 GitHub을 찾아 연결을 클릭하세요. 카드를 가리키면 버튼이 나타납니다.

   

2. GitHub에서 Clevera 승인#

   GitHub에서 Clevera AI 앱을 승인하라는 메시지가 표시됩니다. Clevera가 사용자가 속한 계정 목록을 가져올 수 있도록 조직 멤버십에 대한 읽기 액세스 권한을 요청합니다. 승인을 클릭하세요.

3. 리포지토리에 앱 설치#

   그러면 GitHub에서 Clevera AI 앱 설치 페이지가 열립니다. 개인 계정이나 조직을 선택한 다음 모든 리포지토리 또는 선택한 리포지토리만을 선택하세요. 앱은 다음 권한을 요청합니다:

   GitHub 권한	이유
   콘텐츠: 읽기 및 쓰기	Markdown 파일과 이미지를 생성하고 업데이트하기 위해
   메타데이터: 읽기 전용	모든 앱에 대해 GitHub에서 요구하며, Clevera가 리포지토리 목록을 가져올 수 있게 함

   설치를 클릭하세요. 게시하려는 각 조직에 대해 반복합니다.

4. 연결 확인#

   연동 페이지로 돌아오면 GitHub이 GitHub 계정 또는 조직 이름과 연결됨 배지가 표시된 연결됨 목록으로 이동합니다. 아무것도 게시하기 전에는 "아직 게시된 항목 없음"이라고 표시됩니다.

   

나중에 리포지토리 추가 또는 제거#

Clevera는 앱이 설치된 리포지토리만 볼 수 있습니다. 이를 변경하려면 연동을 열고 GitHub을 클릭한 다음 액세스 아래에서 리포지토리 액세스를 클릭하세요. GitHub에서 계정을 열고 구성을 클릭하여 리포지토리 목록을 변경하세요. 새 리포지토리는 게시 탭을 다음에 열 때 나타납니다.

아티클 게시#

1. 게시 탭 열기#

   에디터에서 공유를 클릭하고 게시 탭을 여세요. 아티클 게시 아래에서 게시 준비 완료 항목의 GitHub 타일을 클릭하세요.

   아티클은 에디터에서 열려 있는 언어로 게시됩니다. 번역본을 게시하려면 먼저 상단 바에서 언어를 전환하세요.

2. 계정, 리포지토리 및 폴더 선택#

   게시 위치 아래에서 다음을 선택하세요:

   필드	선택 항목	참고
   계정	개인 계정 또는 조직	리포지토리가 여러 계정에 속한 경우에만 표시됨
   리포지토리	파일을 저장할 리포지토리	최근 업데이트순으로 정렬됨. 첫 번째 항목이 기본으로 선택됨
   폴더	docs 또는 articles/guides과 같은 경로	"Markdown 파일이 생성될 위치입니다. 비워두면 리포지토리 루트에 생성됩니다." 기본값은 docs입니다. 존재하지 않는 폴더는 새로 생성됩니다

   Clevera는 다음 번을 위해 선택한 내용을 기억합니다.

   

3. 게시#

   GitHub에 게시를 클릭하세요. "GitHub에서 기존 복사본을 찾는 중"이라는 메시지가 표시된 후 페이지 작성 중이 나타납니다. 완료되면 "GitHub에 게시됨"이 표시됩니다. GitHub에서 열기를 클릭하여 파일을 확인하세요.

   게시가 진행되는 동안 공유 창을 닫아도 됩니다. 완료되면 알림이 전송됩니다.

파일 저장 위치#

• 브랜치: 리포지토리의 기본 브랜치(보통 main). Clevera는 해당 브랜치에 직접 커밋하며, 풀 리퀘스트를 열거나 다른 브랜치를 선택할 수 없습니다.
• 파일 이름: 제목을 소문자로 변환하고 공백을 하이픈으로 바꾼 뒤 .md로 끝납니다. "Create your first invoice"는 create-your-first-invoice.md가 됩니다. 다른 언어나 악센트가 포함된 제목은 먼저 라틴 문자로 표기됩니다("Créer une facture"는 creer-une-facture.md이 됨). 이모지 등으로만 구성되어 변환할 문자가 없는 제목은 짧은 고정 코드(article-와 8자)가 부여됩니다. 이름은 80자에서 잘립니다.
• 이미지: 아티클의 스크린샷은 같은 커밋 내의 동일한 폴더 안 assets/<file name>/에 저장됩니다.
• 커밋 메시지: Add article: <title> 또는 기존 파일 업데이트 시 Update article: <title>.
• 커밋 작성자: 연동을 연결한 GitHub 계정.

파일 형태#

Clevera는 상단에 짧은 프런트 매터 블록이 포함된 GitHub 스타일의 Markdown을 작성합니다:

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

아티클의 원본 동영상은 파일에 추가되지 않습니다. 아티클 내에 배치된 Clevera 동영상은 해당 동영상의 공유 링크가 켜져 있을 때만 플레이어 링크로 변환됩니다. 아티클에 동영상 표시를 참조하세요.

이미지#

스크린샷은 파일 옆의 리포지토리에 커밋되며, Markdown은 상대 경로(assets/<file name>/…)를 통해 해당 이미지를 참조합니다. Clevera 없이도 작동하며, 비공개 리포지토리에서는 리포지토리의 나머지 부분과 마찬가지로 비공개로 유지됩니다.

아티클에 업로드한 동영상 파일은 커밋되지 않습니다. 일정 시간이 지나면 만료되는 Clevera 링크로 유지되며, 다시 게시하면 갱신됩니다.

문서 사이트와 함께 사용#

리포지토리에서 빌드하는 대부분의 정적 사이트 생성기(Docusaurus, MkDocs, Jekyll, Hugo 등)는 프런트 매터에서 title을 읽고 알 수 없는 필드는 무시합니다. 일반적인 설정은 다음과 같습니다:

1. 폴더를 문서 사이트가 읽는 폴더(예: docs 또는 content/guides)로 지정하세요.
2. 각 아티클을 해당 폴더에 게시하세요. 사이트의 일반 빌드가 새 커밋을 가져옵니다.
3. 생성기가 GitHub 알림, 수식 및 <details>를 렌더링하는지 확인하세요. 일부 생성기는 알림을 일반 인용문으로 표시할 수 있습니다.

이미 게시한 아티클 업데이트#

게시는 단방향으로만 작동합니다. Clevera에서 수정한 내용은 다시 게시하기 전까지 Clevera에만 유지되며, GitHub의 파일을 변경해도 Clevera로 반영되지 않습니다.

동일한 리포지토리와 폴더에 게시하면 Clevera는 같은 이름의 파일을 찾아 "이 아티클은 이미 GitHub에 있습니다"라고 표시합니다. 보기를 클릭하여 기존 파일을 열고 다음 중 하나를 선택하세요:

Clevera에서 제목이 변경되면 파일 이름도 변경되므로, 게시 시 기존 파일 옆에 새 파일이 생성됩니다. GitHub에서 기존 파일을 직접 삭제하거나 이름을 변경하세요.

Clevera의 어떤 기능도 리포지토리에서 파일을 삭제하지 않습니다.

GitHub 연결 해제#

1. 연동을 열고 GitHub 행의 ⋯ 메뉴를 클릭한 다음 연결 해제를 선택합니다(또는 GitHub를 클릭한 후 연결 해제를 클릭합니다).
2. 확인합니다. "이제 편집기에서 해당 위치로 게시할 수 없습니다. 이미 게시한 콘텐츠는 GitHub에 그대로 유지됩니다."

연결을 해제하면 Clevera의 액세스 토큰이 삭제됩니다. GitHub에서도 Clevera의 액세스 권한을 제거하려면 Clevera AI 앱을 제거하고(GitHub 설정 → 애플리케이션 → 설치된 GitHub 앱 → 구성 → 제거), 승인된 GitHub 앱에서 권한을 취소하세요.

문제 해결#

관련 항목#