Library에 참고 자료 보관하기
Library는 원본 참고 자료와 그 자료에서 추출한 보기를 보관합니다. 프로젝트 브리프, 표, 보고서는 여기에 두고, 팀의 설명은 Context에 작성하세요.
업로드 후 확인
- 워크스페이스를 선택하고 라이브러리를 엽니다.
- 업로드에서 파일을 선택하거나 업로드 영역에 끌어다 놓습니다.
- 업로드 큐의 진행을 확인합니다. 이 빌드는 한 번에 최대 20개 파일을 처리하며 정책과 크기 제한도 적용됩니다.
- 항목을 열고 세부 정보의 상태, 버전, 아티팩트를 확인합니다. 아티팩트는 자료에서 추출한 결과물입니다.
- 가능한 경우 원본과 변환본을 읽고 중요한 문장이나 표의 값이 잘 추출되었는지 비교합니다.
업로드, 미리보기 생성, 검색 가능한 텍스트 준비는 별개입니다. 업로드 성공이 질문 기능에서 파일 전체를 이해할 수 있다는 보장은 아닙니다.
상태 이해하기
| 상태 | 의미와 다음 행동 |
|---|---|
| 대기 중 / 변환 중 / 검색 준비 중 | 처리 중입니다. 나중에 새로 고치고, 계속 멈춰 있으면 관리자에게 문의합니다. 로컬 설치에서는 dtxWiki가 실행 중일 때만 처리됩니다. |
| 준비됨 | 처리가 끝났습니다. 활용 전에 내용을 확인합니다. |
| 제한 사항과 함께 준비됨 | 일부가 생략되거나 잘렸을 수 있습니다. 원본과 비교합니다. |
| 원본 보관됨 | 원본은 보관했지만 사용 가능한 변환 결과가 없습니다. 검색이 필요하면 확인한 텍스트 요약을 추가합니다. |
| 실패 / 시간 초과 | 처리 오류를 확인합니다. 제공되는 경우 변환 다시 시도를 사용합니다. |
어떤 파일을 사용할 수 있나요?
실제 업로드 가능 여부는 서버 기능과 워크스페이스 정책이 결정합니다. v0.2.1의 범위는 다음과 같습니다.
| 형식 | 기대할 수 있는 동작 |
|---|---|
| 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.2.1에서는 업로드가 차단됩니다. 허용 형식으로 내보낸 뒤 업로드하세요. |
변환기가 해당 형식을 안다고 해서 차단된 업로드가 허용되는 것은 아닙니다. 확장자, 실제 파일 내용, 암호화 여부, 저장 공간과 처리 한도도 확인합니다. Owner가 정책을 조정할 수는 있지만, 설정 체크만으로 서버에 없는 변환기가 설치되지는 않습니다.
스캔 PDF의 기본 추출은 PDF 안에 이미 포함된 텍스트를 읽으며 OCR을 하지 않습니다. 사람이 확인한 텍스트를 추가하거나 관리자에게 적절한 변환기를 문의하세요. .hwp 자료는 PDF나 DOCX 등 허용 형식으로 내보내고 결과를 다시 확인합니다.
원본과 버전을 혼동하지 않기
자료가 바뀌면 기존 항목에서 새 버전 업로드를 사용합니다. 같은 항목의 기록에 새 원본 버전이 추가됩니다.
보기 탭에는 최신 버전이 표시됩니다. 기록을 열어도 보기가 이전 버전으로 바뀌지 않으며, 최신 버전의 변환이 실패했다고 이전 버전의 변환 본문을 대신 표시하지도 않습니다. 기록에서는 각 버전의 번호, 처리 상태, 업로드 시각과 내용 식별자를 최신순으로 확인할 수 있고, 어떤 버전을 교체했는지 그래프가 함께 표시됩니다. 원본이 보존되어 있다면 해당 행의 다운로드(보조 기술에서는 이 버전 다운로드)로 내려받아 dtxWiki 밖에서 이전 원본을 확인하세요. 좁은 화면에서는 다운로드 아이콘만 보일 수 있습니다. 원본이 보존되지 않았다면 그 사실이 표시됩니다. Library 기록은 텍스트 비교나 복원을 제공하지 않으며 이전 버전의 텍스트 본문을 열거나 편집할 수도 없습니다.
HTML, JavaScript, DOCX, PPTX, XLSX 원본을 다운로드하기 전에는 실행 가능한 내용이 들어 있을 수 있다는 경고가 표시됩니다. dtxWiki는 미리보기에서 파일을 실행하지 않지만, 내려받은 뒤 다른 프로그램에서 열면 실행될 수 있습니다. 신뢰하는 파일일 때만 진행하세요. 취소하면 파일은 Library에 그대로 남습니다. 기록에서 이전 버전을 다운로드할 때도 같은 경고가 적용됩니다.
권한과 최신 버전의 변환 결과가 허용하는 경우 마크다운 편집으로 그 최신 버전의 검색용 Markdown 텍스트를 수정할 수 있습니다. 빠진 제목이나 잘못 추출된 문장을 바로잡을 때 사용하세요. 원본 PDF나 Office 파일을 수정하거나 이전 버전의 본문을 편집하는 기능은 아닙니다. 원본 파일 자체를 고쳐야 한다면 수정한 파일을 새 버전으로 업로드합니다.
라이브러리 탐색기에서는 항목의 내용이 언제 마지막으로 바뀌었는지 알 수 있습니다. 업로드한 파일이 항목의 현재 버전이 되거나 마크다운 편집에서 바뀐 텍스트를 저장하면 그 행이 72시간 동안 최근 변경으로 표시됩니다. 현재 버전과 똑같은 파일을 다시 올리거나, 바뀌지 않은 텍스트를 저장하거나, 항목의 이름을 바꾸거나 옮기는 것은 내용 변경으로 보지 않습니다. Library 행에는 리뷰 시계 표시가 붙지 않습니다. v0.1.2에서 업그레이드하기 전에 올린 항목은 다음에 내용이 바뀔 때까지 행 도움말에 내용 변경 시각 없음이 표시됩니다. 자주 쓰는 항목은 행 메뉴에서 내 즐겨찾기에 추가를 선택해 표시해 둘 수 있습니다. 탐색기 표시 읽기를 참고하세요.
인용된 자료를 삭제하면 참조하는 페이지에 삭제된 자료 표시가 남고 검토자에게 알려집니다. 근거 이력이 필요하다면 삭제보다 수정한 새 버전을 추가하는 편이 좋습니다.
Library 자료는 이곳에서만 관리합니다. 페이지 첨부 파일이 아니므로 설정 → 첨부 파일에 나타나지 않으며, 페이지의 미사용 업로드를 자동으로 정리하는 기능도 Library 자료는 삭제하지 않습니다.
업로드 실패 시
허용된 형식, 파일 크기와 개수를 확인합니다. 텍스트는 UTF-8로 저장합니다. 암호로 보호된 문서는 지원하지 않습니다. 업로드 중 정책이 바뀌면 정책 다시 불러오기를 사용하고 새 한도에 맞춰 재시도하세요. 결과를 알 수 없는 경우에는 제공된 재시도로 결과를 확인하고, 별개의 업로드를 반복해서 만들지 마세요.
새 항목의 제목은 파일 이름에서 가져옵니다. 파일 이름이 255바이트(한글은 약 85자)보다 길거나, 줄바꿈 같은 제어 문자나 콜론(:)이 들어 있거나, 마침표로 끝나면 업로드가 거부됩니다. 파일 이름을 바꾼 뒤 다시 업로드하세요.
구현 근거: 파일 형식·업로드 허용 범위와 파일 이름, 실행 환경의 기능 판정, PDF 텍스트 추출, 원본 다운로드 안전 확인, 버전 기록과 Markdown 편집, 최신 버전 미리보기, 새 현재 버전과 최근 변경, 탐색기 표시.