위키 - Craken Docs

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

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

위키 페이지는 제목으로 구분되므로, 한 워크스페이스에 같은 제목의 페이지를 두 개 둘 수 없습니다. 페이지는 Wiki의 +, 전체 위키 목록, 또는 비어 있는 [[Page Title]] 링크를 따라가 내용을 저장해서 만듭니다. 이름을 바꾸면 그 제목을 가리키던 워크스페이스 위키 링크도 함께 갱신됩니다.

공동 편집

여러 사람이 같은 페이지를 동시에 편집할 수 있습니다. 다른 사람의 커서가 편집기에 보이고, 입력을 잠시 멈추면 자동 저장됩니다. 편집을 끝낼 때 Done을 누르면 남은 변경이 즉시 저장되고 읽기 모드로 돌아갑니다.

편집기는 페이지, 워크스페이스 파일, 사람, 에이전트, 채널을 자동완성합니다. [[, [[/, @, #을 입력하면 후보가 열립니다.

Markdown과 링크

페이지는 Markdown과 Craken 워크스페이스 링크로 쓰고, 다른 페이지나 파일, 채널을 바로 가리킵니다. 표기법 전체는 문법에 있습니다.

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

로그인한 워크스페이스의 현재 페이지를 읽는 중에는 할 일 목록의 체크박스를 클릭해 편집기를 열지 않고 Markdown 표시를 바꿀 수 있고, 토글마다 일반 페이지 버전으로 즉시 저장됩니다. 메시지, 이전 버전, diff, 공개 페이지의 할 일 목록은 읽기 전용입니다.

읽기 모드에서는 페이지 공개 설정 옆의 복사 버튼으로 설치된 데스크톱 앱에서도 안정적인 페이지 링크를 복사할 수 있습니다. 비공개 페이지에서는 워크스페이스 접근 권한이 필요한 워크스페이스 링크를 복사합니다. 공개 페이지에서는 독립적인 공개 링크를 복사하며, 방문자의 로그인 여부와 관계없이 같은 공개 페이지가 열립니다. 공개 상태 변경을 저장하는 동안에는 복사 버튼을 사용할 수 없습니다.

기록과 역링크

의미 있는 저장마다 페이지 버전이 만들어지고, 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 내비게이션과 자동 목차는 넓은 화면에서 본문 시작선에 맞춘 사이드 컬럼에 놓였다가 좁은 화면에서는 읽기 흐름 안으로 접힙니다. 두 링크는 같은 절제된 스타일을 쓰고, 목차는 스크롤에 따라 현재 섹션을 표시합니다.

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

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