이미지, 링크와 인용 넣기
이미지는 사용자가 알아볼 대상을 보여 주고, 링크는 관련 페이지를 이어 주며, 인용은 설명의 출처를 알려 줍니다.
이미지를 크게 보기
가상 연습 자료를 사용한 dtxWiki 실제 화면입니다. 항목 이름은 따라 하기 예제와 다를 수 있습니다. 가상 페이지 위에 이미지, 파일 첨부와 링크 기능이 표시된 편집 도구 모음.
이미지 추가
- Context 편집기를 열고 설명할 문장 가까이에 커서를 둡니다.
- 이미지 / 이미지 업로드를 이용하거나 이미지를 편집기에 붙여 넣거나 끌어다 놓습니다.
- 이미지 업로드 큐에서 완료될 때까지 기다립니다.
- 이미지의 대체 텍스트를 “검토자 입력칸을 강조한 출시 체크리스트”처럼 구체적으로 씁니다.
- 미리보기에서 확인한 뒤 저장합니다.
허용 형식, 파일 크기와 한 번에 올릴 수 있는 양은 현재 워크스페이스 정책을 따릅니다. 모든 이미지 확장자가 된다고 가정하지 말고 표시된 제한을 확인하세요. 페이지에 올린 이미지는 그 페이지의 미디어이며, 참고 파일을 Library에 업로드하는 것과는 다릅니다.
실패하면 다시 시도 또는 제거를 사용합니다. 미완료 업로드는 저장을 막습니다. 이미지가 들어갈 자리에 실패한 상태를 완료된 이미지처럼 저장하지 않기 위해서입니다. 외부 사이트의 이미지는 원본 삭제나 호스트의 접근 차단으로 표시되지 않을 수도 있습니다.
페이지 미디어 관리에서 페이지가 보관하는 이미지를 확인할 수 있습니다. 현재 또는 보존된 과거 버전에서 참조하는 이미지는 삭제할 수 없습니다. 오늘의 본문에서 지웠다고 바로 미사용 이미지가 되는 것은 아닙니다. 미사용 업로드를 삭제하면 복구할 수 없습니다.
Context 페이지 연결
FAQ 페이지를 만들고 Launch plan에서 연결해 봅니다.
- 위키링크를 선택하거나 본문에
[[를 입력합니다. - 제안 목록에서 FAQ를 선택합니다.
- 저장하고 필요하면 게시한 뒤 본문에서 링크를 열어 봅니다.
자주 묻는 질문은 [[faq|FAQ]]를 참고하세요.
위의 슬러그는 예시입니다. 식별자를 추측하지 말고 실제 페이지 제안을 선택하세요. 인터넷 주소를 연결할 때는 링크 도구에 URL을 넣습니다. 위키링크는 워크스페이스 지식을 연결하며 백링크와 로컬 그래프에 나타날 수 있습니다.
같은 이름의 페이지가 여러 개면 원하는 대상을 확인합니다. 내부 링크를 받았더라도 그 사람의 워크스페이스 접근 권한은 그대로 적용됩니다.
Library 자료 인용
- Library에 출시 브리프를 올리고 내용을 확인합니다.
- Context 편집기에서 설명 옆에 인용을 넣거나
@cite{를 입력합니다. - 제안 목록에서 자료를 선택하고 자동 생성된 인용 키를 유지합니다.
- 저장한 뒤 본문의 인용과 페이지의 인용 정보를 확인합니다.
@cite{…} 안에 임의의 제목이나 데이터베이스 UUID를 넣으면 연결된다고 가정하지 마세요. 편집기가 자료에 맞는 키를 제공합니다. 인용은 출처 연결을 남기는 기능이며 문장이 사실임을 보증하지는 않습니다. 원문을 열어 주장과 직접 비교하세요.
간단한 설명 그림
항목 비교는 표로, 짧은 연결 관계는 Mermaid 다이어그램으로 설명하세요. 제품의 버튼이나 실제 장면을 알아봐야 할 때 이미지를 사용합니다. 아래 Mermaid 예제는 코드 작성 없이 블록 전체를 복사해 본문에 붙여 넣을 수 있습니다.
```mermaid
flowchart LR
Brief[출시 브리프] --> Plan[출시 계획]
Plan --> Review[사람의 확인]
```
설명용 그림에는 실제 제품 화면 캡처와 구분할 수 있는 캡션을 붙이세요. 표시되지 않으면 문법과 코드 블록의 시작·끝을 확인합니다. 이미지와 다이어그램 뷰어에는 확대해서 볼 수 있는 기능이 있습니다.
다음: Context 페이지, 리뷰와 히스토리.
구현 근거: 편집기 자동 완성과 인용 키, 페이지 미디어 관리, 이미지 표시.