Library에 참고 자료 보관하기
Library는 원본 참고 자료와 그 자료에서 추출한 보기를 보관합니다. 프로젝트 브리프, 표, 보고서는 여기에 두고, 팀의 설명은 Context에 작성하세요.
이미지를 크게 보기
가상 연습 자료를 사용한 dtxWiki 실제 화면입니다. 항목 이름은 따라 하기 예제와 다를 수 있습니다. 준비됨 상태의 가상 Markdown 자료와 업로드 버튼이 있는 Library 목록.
업로드 후 확인
- 워크스페이스를 선택하고 라이브러리를 엽니다.
- 업로드에서 파일을 선택하거나 업로드 영역에 끌어다 놓습니다.
- 업로드 큐의 진행을 확인합니다. 이 빌드는 한 번에 최대 20개 파일을 처리하며 정책과 크기 제한도 적용됩니다.
- 항목을 열고 세부 정보의 상태, 버전, 아티팩트를 확인합니다. 아티팩트는 자료에서 추출한 결과물입니다.
- 가능한 경우 원본과 변환본을 읽고 중요한 문장이나 표의 값이 잘 추출되었는지 비교합니다.
업로드, 미리보기 생성, 검색 가능한 텍스트 준비는 별개입니다. 업로드 성공이 질문 기능에서 파일 전체를 이해할 수 있다는 보장은 아닙니다.
상태 이해하기
| 상태 | 의미와 다음 행동 |
|---|---|
| 대기 중 / 변환 중 / 검색 준비 중 | 처리 중입니다. 나중에 새로 고치고, 계속 멈춰 있으면 관리자에게 문의합니다. |
| 준비됨 | 처리가 끝났습니다. 활용 전에 내용을 확인합니다. |
| 제한 사항과 함께 준비됨 | 일부가 생략되거나 잘렸을 수 있습니다. 원본과 비교합니다. |
| 원본 보관됨 | 원본은 보관했지만 사용 가능한 변환 결과가 없습니다. 검색이 필요하면 확인한 텍스트 요약을 추가합니다. |
| 실패 / 시간 초과 | 처리 오류를 확인합니다. 제공되는 경우 변환 다시 시도를 사용합니다. |
어떤 파일을 사용할 수 있나요?
실제 업로드 가능 여부는 서버 기능과 워크스페이스 정책이 결정합니다. v0.1.2의 범위는 다음과 같습니다.
| 형식 | 기대할 수 있는 동작 |
|---|---|
| Markdown, UTF-8 텍스트, HTML, JavaScript | 허용된 경우 텍스트 변환. HTML과 JavaScript는 자료로 처리하며 앱처럼 실행하지 않습니다. |
| CSV, TSV, JSON, YAML | 처리 한도 내의 구조화된 텍스트나 표 보기 |
| PDF, DOCX, PPTX, XLSX | 설치된 변환기에 따른 추출. 원래 레이아웃과 생성 미리보기는 별도의 기능입니다. |
| JPEG, PNG | 검증된 이미지 보관과 미리보기. 기본 이미지 변환기는 메타데이터와 안전한 표시용 사본을 만들며 OCR 텍스트를 추출하지 않습니다. |
| MP3, OGG, WAV, MP4, WEBM | 정책이 허용하면 원본 보관. 재생은 브라우저와 실행 환경에 따릅니다. 기본 음성 받아쓰기를 보장하지 않습니다. |
| HDF5, Parquet | 필요한 의존성이 있을 때 한도 내의 데이터·메타데이터 처리. 모든 데이터를 전부 펼치지는 않습니다. |
| DOC, PPT, XLS; GIF, WEBP, TIFF; HDF4; HWP, HWPX, HWPML | 형식 항목은 있지만 v0.1.2에서는 업로드가 차단됩니다. 허용 형식으로 내보낸 뒤 업로드하세요. |
변환기가 해당 형식을 안다고 해서 차단된 업로드가 허용되는 것은 아닙니다. 확장자, 실제 파일 내용, 암호화 여부, 저장 공간과 처리 한도도 확인합니다. Owner가 정책을 조정할 수는 있지만, 설정 체크만으로 서버에 없는 변환기가 설치되지는 않습니다.
스캔 PDF의 기본 추출은 PDF 안에 이미 포함된 텍스트를 읽으며 OCR을 하지 않습니다. 사람이 확인한 텍스트를 추가하거나 관리자에게 적절한 변환기를 문의하세요. .hwp 자료는 PDF나 DOCX 등 허용 형식으로 내보내고 결과를 다시 확인합니다.
원본과 버전을 혼동하지 않기
자료가 바뀌면 기존 항목에서 새 버전 업로드를 사용합니다. 같은 항목의 기록에 새 원본 버전이 추가됩니다.
보기 탭에는 최신 버전이 표시됩니다. 기록을 열어도 보기가 이전 버전으로 바뀌지 않으며, 최신 버전의 변환이 실패했다고 이전 버전의 변환 본문을 대신 표시하지도 않습니다. 기록에서는 각 버전의 번호, 처리 상태, 업로드 시각과 내용 식별자를 확인할 수 있습니다. 원본이 보존되어 있다면 해당 행의 이 버전 다운로드로 내려받아 dtxWiki 밖에서 이전 원본을 확인하세요. 보존되지 않았다면 그 사실이 표시됩니다. 기록에서 이전 버전의 텍스트 본문을 열거나 편집할 수는 없습니다.
권한과 최신 버전의 변환 결과가 허용하는 경우 마크다운 편집으로 그 최신 버전의 검색용 Markdown 텍스트를 수정할 수 있습니다. 빠진 제목이나 잘못 추출된 문장을 바로잡을 때 사용하세요. 원본 PDF나 Office 파일을 수정하거나 이전 버전의 본문을 편집하는 기능은 아닙니다. 원본 파일 자체를 고쳐야 한다면 수정한 파일을 새 버전으로 업로드합니다.
인용된 자료를 삭제하면 참조하는 페이지에 삭제된 자료 표시가 남고 검토자에게 알려집니다. 근거 이력이 필요하다면 삭제보다 수정한 새 버전을 추가하는 편이 좋습니다.
업로드 실패 시
허용된 형식, 파일 크기와 개수를 확인합니다. 텍스트는 UTF-8로 저장합니다. 암호로 보호된 문서는 지원하지 않습니다. 업로드 중 정책이 바뀌면 정책 다시 불러오기를 사용하고 새 한도에 맞춰 재시도하세요. 결과를 알 수 없는 경우에는 제공된 재시도로 결과를 확인하고, 별개의 업로드를 반복해서 만들지 마세요.
구현 근거: 파일 형식과 업로드 허용 범위, 실행 환경의 기능 판정, PDF 텍스트 추출, 버전 기록과 Markdown 편집, 최신 버전 미리보기.