Keep reference material in Library
Library keeps original reference material and the views extracted from it. A project brief, spreadsheet, or report belongs here; your team's explanation of it belongs in Context.
View full-size image
Actual dtxWiki screen with fictional demo data. Item names can differ from the walkthrough. Library list with one fictional Markdown source marked Ready and the Upload button.
Upload and check a source
- Select the workspace and open Library.
- Choose Upload, select files, or drop files onto the upload area.
- Follow the upload queue. This build limits a batch to 20 files, with additional policy and size limits.
- Open the uploaded item and check Status, Versions, and Artifacts in Details.
- Read the original and converted view when available. Verify that important paragraphs or table values survived extraction.
Uploading, generating a preview, and preparing searchable text are separate operations. A successful upload is not a promise that Ask can understand the whole file.
Understand the status
| Status | Meaning and next step |
|---|---|
| Pending / Converting / Preparing search | Processing is still running. Refresh later; ask an administrator if it stays stuck. |
| Ready | Processing finished. Check the content before relying on it. |
| Ready with limits | Some content may be omitted or truncated. Compare with the original. |
| Original stored | The original is retained, but usable conversion is unavailable. Add a text summary if you need searchable evidence. |
| Failed / Timed out | Processing failed. Inspect the message; use Retry conversion if offered. |
Which files can I use?
The server's capability list and workspace policy determine what you can upload. v0.1.2 has these boundaries:
| Format group | What to expect |
|---|---|
| Markdown, UTF-8 text, HTML, JavaScript | Text conversion where enabled; HTML and JavaScript are treated as source material, not executed as an app. |
| CSV, TSV, JSON, YAML | Structured text or table views with processing limits. |
| PDF, DOCX, PPTX, XLSX | Extraction depends on installed converters. Original layout and generated previews are separate capabilities. |
| JPEG, PNG | Validated image storage and preview; the built-in image converter produces metadata and a safe derivative, not OCR text. |
| MP3, OGG, WAV, MP4, WEBM | Original storage where policy permits; playback depends on the browser and runtime. No built-in speech transcription guarantee. |
| HDF5, Parquet | Bounded data/metadata processing with suitable dependencies; not every dataset is expanded in full. |
| DOC, PPT, XLS; GIF, WEBP, TIFF; HDF4; HWP, HWPX, HWPML | Listed descriptors exist, but upload admission is closed in v0.1.2. Export to an enabled format. |
Converter support alone does not override closed upload admission. File extensions, detected bytes, encrypted files, storage quotas, and safety limits are also checked. A workspace owner can adjust policy, but cannot make a missing server converter appear by changing a checkbox.
For a scanned PDF, built-in PDF extraction reads embedded text and does not perform OCR. Add a reviewed text transcription or ask the administrator about an appropriate converter. For .hwp material, export to an enabled format such as PDF or DOCX and recheck the result.
Correct a source without confusing versions
Use Upload new version on an existing item when the reference has changed. This adds a source version to the same item's history.
The View tab displays the latest version. It does not switch to an older version when you open History, and a failed conversion of the latest version does not silently show an older converted body. History lists each version's number, processing status, upload time, and content identifier. Use Download this version on its row to inspect that version's original file outside dtxWiki, when the original is still retained. If it is no longer retained, the row reports that instead. History does not provide an older text-body viewer or editor.
Where your permissions and the latest version's conversion allow it, Edit Markdown changes that latest version's searchable Markdown text. Use it to correct extracted text, such as a missing heading or an incorrectly read paragraph. It does not edit the original PDF or Office file, and it cannot edit an older version's body. Upload a new version when the original file itself needs correcting.
Deleting a cited source leaves a deleted-source marker in referencing pages and informs reviewers. Prefer adding a corrected version when you need to keep an evidence trail.
If uploading fails
Check the exact enabled format, file-size limit, and batch count. Save text as UTF-8. Password-protected documents are unsupported. If policy changed during upload, use Reload policy and retry with the new limits. When the result is unknown, use the offered retry to reconcile rather than creating repeated unrelated uploads.
Continue with Images and citations or Search and Ask.
Implementation reference: format admission, runtime capabilities, PDF extraction, version history and Markdown editing, latest-version preview.