이미지, 링크와 인용 넣기

이미지는 사용자가 알아볼 대상을 보여 주고, 링크는 관련 페이지를 이어 주며, 인용은 설명의 출처를 알려 줍니다.

이미지 추가

1. Context 편집기를 열고 설명할 문장 가까이에 커서를 둡니다.
2. 이미지 / 이미지 업로드를 이용하거나 이미지를 편집기에 붙여 넣거나 끌어다 놓습니다.
3. 이미지 업로드 대기열에서 완료될 때까지 기다립니다.
4. 이미지의 대체 텍스트를 “검토자 입력칸을 강조한 출시 체크리스트”처럼 구체적으로 씁니다.
5. 미리보기에서 확인한 뒤 저장합니다.

허용 형식, 파일 크기와 한 번에 올릴 수 있는 양은 현재 워크스페이스 정책을 따릅니다. 모든 이미지 확장자가 된다고 가정하지 말고 표시된 제한을 확인하세요. 페이지에 올린 이미지는 그 페이지의 미디어이며, 참고 파일을 Library에 업로드하는 것과는 다릅니다.

실패하면 다시 시도 또는 제거를 사용합니다. 미완료 업로드는 저장을 막습니다. 이미지가 들어갈 자리에 실패한 상태를 완료된 이미지처럼 저장하지 않기 위해서입니다. 외부 사이트의 이미지는 원본 삭제나 호스트의 접근 차단으로 표시되지 않을 수도 있습니다.

페이지 미디어 관리에서 페이지가 보관하는 이미지를 확인할 수 있습니다. 현재 또는 보존된 과거 버전에서 참조하는 이미지는 삭제할 수 없습니다. 오늘의 본문에서 지웠다고 바로 미사용 이미지가 되는 것은 아닙니다. 미사용 업로드를 삭제하면 복구할 수 없습니다. 워크스페이스 전체의 업로드를 확인하려면 설정 → 첨부 파일을 사용합니다.

업로드한 파일 확인과 정리

설정 → 첨부 파일(이 워크스페이스 아래)에는 이 워크스페이스의 페이지에 업로드한 이미지, 오디오, 동영상이 표시됩니다. 모든 멤버가 열 수 있습니다. 목록에는 내가 읽을 수 있는 페이지의 파일만 나오며, 다른 사람이 아직 저장하지 않은 초안에 올린 비공개 파일은 나오지 않습니다.

역할	필터	표시되는 파일
Owner	전체(기본), 내 파일, 미사용	모든 멤버가 올린 파일
Editor, Viewer	내 파일(기본), 미사용	내가 올린 파일만

각 행에는 파일 이름, 형식과 크기, 상태, 페이지(누르면 열리는 링크), 업로드한 사람과 시각이 표시됩니다. 내가 올린 파일에는 나 표시가 붙습니다. 미리보기 이미지는 볼 권한이 있는 이미지에만 나오고, 나머지 행에는 자리 표시가 나옵니다. 파일 이름으로 검색할 수 있으며, 새로고침으로 목록을 다시 불러오고 더 보기로 이전 파일을 더 볼 수 있습니다.

상태	의미
사용 중	페이지의 현재 게시 버전이나 최신 초안이 이 파일을 사용합니다.
이전 버전에만	페이지의 이전 버전에서만 이 파일을 사용합니다.
작업 중인 초안에만	아직 열려 있는 편집에 올린 파일이라 dtxWiki가 보관합니다.
미사용	페이지의 어떤 버전도 이 파일을 사용하지 않습니다.

미사용 파일 삭제

Editor와 Owner는 어느 페이지 버전도 사용하지 않는 파일을 삭제할 수 있고, Viewer는 볼 수만 있습니다. 사용 중이나 이전 버전에만 상태의 파일에는 삭제 버튼이 없습니다.

1. 파일 하나를 지우려면 그 행의 삭제를 누르고, 되돌릴 수 없다는 확인 안내에서 첨부 파일 삭제를 누릅니다.
2. 여러 파일을 지우려면 미사용을 고릅니다. 파일을 하나씩 체크하거나 전체 선택을 체크해 지금까지 불러온 미사용 파일을 모두 고른 뒤 선택 삭제와 삭제 확인을 누릅니다. 전체 선택은 이미 불러온 파일만 고르므로, 이전 파일까지 지우려면 먼저 더 보기를 누르세요.

예상 결과: 삭제한 행이 목록에서 사라지고, 여러 개를 지우면 3개 삭제, 0개 실패처럼 결과가 표시됩니다. 목록을 불러온 뒤 다른 사람이 파일을 사용하거나 바꿨다면 dtxWiki는 그 파일의 삭제를 거부하고 이유를 알린 뒤 목록을 다시 불러옵니다. 내가 볼 수 없는 비공개 초안을 포함해 어떤 페이지 버전이든 아직 사용하는 파일은 삭제되지 않습니다. 삭제는 되돌릴 수 없으며, 서버 백업으로만 파일을 되살릴 수 있습니다.

미사용 파일 자동 회수

미사용 파일 자동 회수 카드에는 이 워크스페이스의 규칙이 표시됩니다. 예를 들어 미사용 파일 보존 기간: 7일과 함께 서버 기본값 사용 중 또는 워크스페이스 설정이 보이거나, 미사용 파일 자동 회수 꺼짐이 보입니다. 자동 회수가 켜져 있으면 업로드 시각부터 보존 기간이 지난 미사용 파일이 정기 정리 때 영구 삭제됩니다. 어떤 페이지 버전이든 사용하는 파일과 열려 있는 편집이 보관 중인 파일은 이 방식으로 삭제되지 않습니다. 편집 중에 올렸지만 페이지에 저장하지 않은 이미지는 그 편집을 제출, 게시 또는 폐기하면 미사용이 되고, 보존 기간이 지나면 삭제됩니다.

Owner는 규칙을 바꿀 수 있습니다.

1. 카드에서 설정 변경을 엽니다.
2. 자동 회수 사용을 체크하거나 해제합니다. 자동 회수를 켜 둘 때는 보존 기간에 정수를 입력하고 단위에서 일 또는 시간을 고릅니다. 다시 서버 기본값을 따르려면 서버 기본값 사용을 누릅니다.
3. 정책 저장을 누릅니다. 자동 회수를 켜거나 보존 기간을 줄이면 기존 미사용 파일도 다음 정리 때 삭제될 수 있다는 확인이 나오며, 계속하려면 저장 및 적용을 누릅니다.

예상 결과: 카드에 새 규칙과 워크스페이스 설정이 표시되고, 서버 기본값으로 돌아가면 서버 기본값 사용 중이 표시됩니다. 새 규칙은 저장한 뒤 시작하는 정리부터 적용됩니다. 서버 관리자가 바꾸지 않았다면 서버 기본값은 7일입니다.

서버 관리자는 이 화면에서 전체 워크스페이스 범위도 사용할 수 있습니다. 이 범위는 미리보기 없이 모든 워크스페이스의 첨부 파일 정보를 보여 줍니다. 개인정보와 안전한 공유를 참고하세요.

Context 페이지 연결

FAQ 페이지를 만들고 Launch plan에서 연결해 봅니다.

1. 위키링크를 선택하거나 본문에 [[를 입력합니다.
2. 제안 목록에서 FAQ를 선택합니다.
3. 저장하고 필요하면 게시한 뒤 본문에서 링크를 열어 봅니다.

자주 묻는 질문은 [[faq|FAQ]]를 참고하세요.

위의 슬러그는 예시입니다. 식별자를 추측하지 말고 실제 페이지 제안을 선택하세요. 인터넷 주소를 연결할 때는 링크 도구에 URL을 넣습니다. 위키링크는 워크스페이스 지식을 연결하며 백링크와 로컬 그래프에 나타날 수 있습니다.

같은 이름의 페이지가 여러 개면 원하는 대상을 확인합니다. 내부 링크를 받았더라도 그 사람의 워크스페이스 접근 권한은 그대로 적용됩니다.

참고문헌 추가하기

가상의 Library 출시 브리프를 출시 계획의 근거로 등록해 보세요.

1. Context 편집기에서 출시 계획을 열고 인용하려는 자료의 실제 내용을 확인합니다.
2. 참고문헌 N개를 열고 참고문헌 추가를 선택합니다. 도구 모음의 인용, /cite, @cite{ 입력도 참고문헌 선택 대화상자를 엽니다.
3. 제목·본문을 검색하거나 문서 주소를 붙여 넣습니다. 문서 종류에서 컨텍스트, 라이브러리, 에이전트를 고르고 정확한 문서를 선택합니다.
4. 왜 참고했는지 설명이 필요하면 메모 (선택) 필드에 설명을 입력합니다.
5. 아래 두 동작 중 하나를 선택하고 참고문헌 패널을 확인합니다.

동작	결과
본문에 인용	커서 위치에 인용을 넣습니다. 읽기 화면에서는 참고문헌으로 연결되는 번호 인용을 표시합니다. 메모가 있으면 참고문헌 등록에 함께 저장합니다.
참고문헌에만 추가	본문에 표시를 넣지 않고 문서와 메모를 등록합니다. 패널에서는 본문 미인용으로 표시합니다.

편집기는 Context의 @cite{/p/<workspace_id>/<page_id>}, Library의 @cite{/workspaces/<workspace_id>/library/items/<item_id>} 같은 문서 주소를 넣습니다. 실제 문서를 선택하고 슬러그·해시·인용 키를 임의로 만들지 마세요. Agent 문서도 참고문헌으로 사용할 수 있습니다. 참고문헌은 어떤 자료를 사용했는지 기록하며, 주장을 뒷받침하는지는 원문을 읽어 확인해야 합니다.

기존 링크를 인용으로 바꾸기

편집기에서 내부 문서 링크를 선택하고 참고문헌 N개 → 선택 링크를 인용으로 표시를 누릅니다. 링크 문구는 유지하고 옆에 주소 기반 인용 표시를 붙입니다. 탐색용 링크를 근거 문헌으로도 표시할 때 사용하세요. 선택한 링크가 없거나 지원하지 않는 대상이면 내부 문서 링크를 먼저 선택하라는 안내가 나옵니다.

저장·게시 후 확인하기

초안을 저장하고 저장 상태를 확인합니다. 참고문헌은 해당 문서 버전에 속하며 등록만으로 페이지가 게시되지는 않습니다. 게시할 때 본문 인용과 명시적으로 추가한 참고문헌을 함께 반영합니다. 읽기 화면에는 번호 인용과 참고문헌 절이 표시되고 본문에 인용하지 않은 항목도 목록에 포함됩니다. 되돌아가기 링크로 인용한 구절을 다시 찾을 수 있습니다.

그래프의 인용 관계는 게시된 버전에 반영한 참고문헌을 사용하며 지원하는 Agent 대상도 포함합니다. 초안 저장만으로 현재 게시 그래프의 선이 추가되지는 않습니다. 출처 문서를 게시한 뒤 문서 그래프나 지식 지도에서 대상의 이용 가능 여부와 필터를 함께 확인하세요. 그래프 선은 자료가 주장을 입증한다는 인증이 아닙니다.

웹에 공개한 페이지에서도 참고문헌은 익명 방문자의 접근 범위를 따릅니다. 공개할 수 없는 대상은 비공개 제목·메모·주소 없이 접근할 수 없는 문서로 표시합니다. 익명 방문자는 별도로 웹 공개한 적격 컨텍스트 문서만 열 수 있습니다. 라이브러리·에이전트 참고문헌은 공개 페이지에서 접근할 수 없는 문서로 남습니다. 인용한 페이지를 공개해도 비공개 원문이 함께 공개되지는 않습니다. 공유의 게시된 버전 미리 보기를 확인하고 로그아웃 상태로 공개 URL을 열어 보세요.

해석되지 않은 인용과 저장 상태 해결하기

본문 인용과 참고문헌을 합쳐 문서마다 서로 다른 대상 최대 500개를 사용할 수 있습니다. 같은 문서를 여러 번 인용해도 참고문헌은 한 항목입니다. 옛 @cite{key}나 지원하지 않는 주소는 실제 문서를 선택해 교체하세요. Lint의 해석되지 않은 인용은 이 워크스페이스의 지원 문서를 가리키지 않는 표시이며 참고문헌에 등록된 인용이 아닙니다.

참고문헌 삭제는 명시적 등록을 지우며 본문의 인용 표시는 직접 제거할 때까지 남습니다. 완전히 제거하려면 패널과 본문을 모두 확인하고 저장한 뒤 필요할 때 변경 버전을 게시하세요. 등록 문헌이나 메모 변경은 검토·이력 비교의 참고문헌 변경에도 표시됩니다.

참고문헌 요청이 실패했거나 결과가 불확실하면 작성 중인 본문을 유지하세요. 참고문헌 변경 다시 시도, 또는 제공되는 상태 확인 후 참고문헌 요청 종료로 결과를 확인한 뒤 저장·게시합니다. 참고문헌은 저장했지만 목록을 다시 읽지 못했다는 안내라면 목록을 다시 불러와 실제 결과를 확인하세요. 재시도 상태 안내와 게시 실패를 구분하세요.

간단한 설명 그림

항목 비교는 표로, 짧은 연결 관계는 Mermaid 다이어그램으로 설명하세요. 제품의 버튼이나 실제 장면을 알아봐야 할 때 이미지를 사용합니다. 아래 Mermaid 예제는 코드 작성 없이 블록 전체를 복사해 본문에 붙여 넣을 수 있습니다.

```mermaid
flowchart LR
  Brief[출시 브리프] --> Plan[출시 계획]
  Plan --> Review[사람의 확인]
```

누가 요청을 보내고 다음에 무엇이 일어나는지 설명할 때는 시퀀스 다이어그램을 사용합니다. 아래는 가상의 리뷰 대화를 설명하는 예제이며, 실제 리뷰 요청을 보내지는 않습니다.

```mermaid
sequenceDiagram
  autonumber
  participant Author as 페이지 작성자
  participant Reviewer as 사람 검토자
  Author->>Reviewer: 리뷰 요청
  Reviewer-->>Author: 수정 요청
  Author->>Reviewer: 수정한 초안 제출
```

위에서 아래로 읽으면 작성자의 리뷰 요청, 검토자의 수정 요청, 작성자의 수정한 초안 제출 순서입니다. autonumber는 메시지에 번호를 붙입니다. v0.2.1에서는 페이지 본문과 확대 뷰어 모두 시퀀스 메시지의 연결선, 화살표 머리와 메시지 번호를 표시합니다.

1. 여는 줄과 닫는 줄의 백틱 세 개까지 포함해 블록 전체를 Context 페이지에 붙여 넣습니다.
2. 읽기 모드로 전환해 게시 전에 그림을 확인합니다. 넓은 편집기에서는 분할도 사용할 수 있지만 편집기가 좁으면 이 선택지가 숨겨집니다.
3. 그림 옆의 확대 아이콘을 눌러 큰 뷰어를 엽니다. 버튼의 접근성 이름은 Mermaid 다이어그램 확대입니다. 뷰어의 아이콘 버튼에는 확대, 축소, 배율 초기화, Mermaid 확대 보기 닫기라는 접근성 이름이 있습니다. +, -, 0 키로 확대·축소·초기화하고 Esc로 닫을 수도 있습니다. 다이어그램 뷰어라는 제목은 스크린 리더에만 제공되며 화면에는 표시되지 않습니다.

설명용 그림에는 실제 제품 화면 캡처와 구분할 수 있는 캡션을 붙이고, 옆에 문장으로도 내용을 설명하세요. Mermaid 다이어그램을 렌더링하지 못했습니다.가 표시되면 원래 코드는 그대로 보입니다. 편집기로 돌아가 문법과 코드 블록의 시작·끝을 확인한 뒤 다시 미리 봅니다.

안정적인 목적지와 인덱스 참조

슬러그를 조합하지 말고 /p/<workspace_id>/<page_id> 형태의 워크스페이스 링크를 복사하세요. 이름 변경으로 고정된 문서 신원이 다른 페이지로 바뀌지는 않습니다. 다른 워크스페이스 링크에는 그 멤버십이 필요하며 접근 불가 참조는 안전한 돌아가기·공간 선택을 안내할 수 있습니다. 공개 페이지는 공개 발행 Context로 확인된 목적지만 활성화합니다.

편집 미리보기는 열린 문서의 알려진 링크를 바로 표시하고 입력이 멈춘 뒤 새로 추가한 링크를 확인합니다. 확인 표시는 저장 완료가 아닙니다. 이 확인은 미저장 본문을 보내거나 교체하지 않습니다. 문서에 접근 가능해도 특정 위치·앵커는 검증되지 않을 수 있습니다.

시스템 인덱스는 dtxwiki://index/<kind>/<id> 목적지를 포함할 수 있습니다. 서식·원문 전환으로 서버 Markdown을 그대로 확인하고 검증된 일치 항목만 탐색하세요. 직접 작성하는 Context 저장과 Agent 초안 작성은 제안 모드·서식 정리 꺼짐에서도 읽을 수 있는 정확한 인덱스 참조를 지원 주소로 바꿉니다. 숨김·누락 대상은 원문과 진단을 남깁니다. 복원·복사된 버전·과거 본문은 원래 텍스트를 유지합니다.

그 밖의 링크 자동 수정은 Lint 설정을 따릅니다. 인용은 문서 선택기로 추가하고 해당 버전을 게시해 그래프 관계에 반영하세요. MCP 클라이언트는 cite로 참고문헌을 등록합니다. API·MCP 안내를 참고하세요.

다음: Context 페이지, 리뷰와 히스토리.

구현 근거: 편집기 자동 완성과 문서 주소, 페이지 미디어 관리, 이미지 표시, Mermaid 표시, 다이어그램 뷰어 도구, 첨부 파일 목록과 삭제, 미사용 파일 자동 회수 설정, 정리 기준, 참고문헌 선택기, 참고문헌 저장·게시.