위키 - Craken Docs

위키는 워크스페이스의 오래 남는 지식 기반입니다. 결정, 절차, 연구 요약, 사양, 계획처럼 대화가 지나간 뒤에도 찾아야 하는 내용을 둡니다.

페이지 만들기와 이름 바꾸기

Wiki의 +, 전체 위키 목록, 또는 비어 있는 [[Page Title]] 링크를 따라가서 새 페이지를 만들 수 있습니다.

위키 페이지의 정체성은 제목입니다. 같은 워크스페이스에 같은 제목의 페이지는 두 개 만들 수 없습니다. 페이지 이름을 바꾸면 그 제목을 가리키던 워크스페이스 위키 링크도 함께 갱신됩니다.

공동 편집

여러 사람이 같은 페이지를 함께 편집할 수 있고, 원격 커서가 보입니다. 입력 후 잠시 멈추면 자동 저장됩니다. 편집을 끝낼 때는 Done을 눌러 남은 변경을 즉시 저장하고 읽기 모드로 돌아오세요.

에디터에서 [[, [[/, @, #을 치면 페이지, 공유 파일, 사람/에이전트, 채널 자동완성이 열립니다.

Markdown과 링크

위키는 Markdown과 Craken 워크스페이스 링크를 사용합니다.

위키 페이지: [[Launch Plan]], [[Launch Plan|출시 계획]].
공유 파일: [[/briefs/q2-launch.pdf]].
채널: #general.
수식: $E=mc^2$ , $$ ... $$.
표, 할 일 목록, 코드 펜스, 각주, 이미지.

자세한 내용은 문법을 보세요.

기록과 역링크

의미 있는 저장마다 페이지 버전이 만들어집니다. History에서 누가 무엇을 바꿨는지 확인하고 이전 버전을 읽을 수 있습니다. Links 영역은 현재 페이지를 가리키는 다른 페이지와 메시지를 보여 줍니다.

삭제된 페이지

삭제된 위키 페이지는 Wiki More...의 Deleted pages에서 복구할 수 있습니다. 위키 페이지는 삭제된 파일과 같은 30일 휴지통 정책을 쓰지 않습니다.

선택 영역을 Orca에게 묻기

읽기 모드에서 텍스트를 선택하면 Ask Orca를 열 수 있습니다. 선택한 문단이 Orca와의 DM 맥락으로 들어가므로 요약, 번역, 설명, 후속 수정 요청에 유용합니다.

공개 위키 페이지

일부 위키 페이지는 페이지 공개 설정으로 공개할 수 있습니다. 현재 페이지가 명시적으로 공개된 경우에만 독립적인 공개 HTML 또는 Markdown으로 렌더링됩니다. 비공개 페이지와 비공개 링크 대상은 계속 비공개입니다.

워크스페이스의 공개 위키 홈을 만들려면 _Home이라는 제목의 페이지를 만들고 공개로 설정한 뒤 공개 위키 URL을 공유하세요. 방문자는 /public/w/:workspace/wiki에서 이 페이지를 엽니다. 같은 페이지는 /public/w/:workspace/wiki.md에서 Markdown으로도 볼 수 있고, 다른 공개 페이지도 공개 페이지 URL 끝에 .md를 붙이거나 Markdown 요청을 보내면 Markdown으로 읽을 수 있습니다. 페이지 제목 자체가 .md로 끝나면 해당 공개 URL은 그 제목의 페이지를 열며, Markdown은 Accept: text/markdown 헤더로 요청합니다. 워크스페이스 멤버가 일반 /w/:workspace/wiki 앱 URL을 열면 계속 워크스페이스 앱이 보입니다.

일반 Markdown 페이지 두 개로 공개 위키 HTML 주변 레이아웃을 추가할 수 있습니다.

_Sidebar 페이지를 공개하면 공개 내비게이션이 생깁니다. ## 제목은 섹션, 목록은 섹션 안의 항목, 중첩 목록은 접을 수 있는 그룹으로 표시됩니다.

공개 위키 HTML은 미니멀한 문서 레이아웃을 유지합니다. 본문은 읽기 좋은 폭에 놓이고, _Sidebar 내비게이션과 자동 목차는 넓은 화면에서 article 본문 시작선에 맞춘 안정적인 사이드 컬럼을 쓰며 좁은 화면에서는 읽기 흐름 안으로 접힙니다. 좌측 내비게이션과 우측 목차 링크는 같은 절제된 링크 스타일을 쓰고, 목차는 스크롤 위치에 맞춰 현재 섹션을 표시합니다.

이 레이아웃 페이지는 공개 HTML 페이지에만 적용됩니다. /public/w/:workspace/wiki.md 또는 /public/w/:workspace/wiki/Page.md 같은 Markdown 읽기는 요청한 페이지 본문만 반환합니다.

공개 위키 페이지는 익명 방문자가 빠르게 읽을 수 있도록 캐시됩니다. Craken은 서버 측 공개 사본을 재사용하기 전에 현재 공개 페이지와 레이아웃 상태를 확인하지만, 방문자 브라우저가 이미 받아 둔 페이지를 아주 잠시 로컬 캐시에서 재사용할 수는 있습니다.