Sunucuda olmayan ve bir depoda olmayan dokümantasyon: panoya sürükleyin. Dosyalar, yapılarıyla birlikte tüm klasörler ve arşivler sunucu tarafında açılır ve saklanır.
Bu, birinin size e-postayla gönderdiği bir zip, başka bir araçtan bir export, ya da dizüstünüzde başka bir yeri olmayan bir klasör için doğru kaynaktır.
Bir tane eklemek
Add source → Upload files
| Alan | Notlar |
|---|---|
| Name | Mount öneki. Değiştirilemez |
| Content type | Plain Markdown / text, bir Notion Export → Markdown & CSV zip’i için Notion export, ya da yüklenen spesifikasyonlar için OpenAPI / Swagger |
| File types | Varsayılan olarak .md ve .mdx; .txt, .html/.htm, .csv, .docx ve .pdf de seçilebilir — yüklemedeki başka her şey düşürülür |
Sonra dosyaları dropzone’a sürükleyin, ya da Choose folder / Choose files’ı kullanın. Klasörler yapılarını korur. İlerleme dosya başına gösterilir, ve büyük klasörler otomatik olarak birkaç isteğe bölünür.
Son olarak yüklemenin nasıl uygulanacağını seçin:
| Mod | Etki |
|---|---|
| Add to existing files | Kaynağın zaten tuttuğuyla birleştirir; aynı yoldaki dosyaların üzerine yazılır |
| Replace all files | Kaynağın içeriği, tam olarak yüklediğiniz şey olur |
Kaydetmek yüklemeyi işler ve bir indeksleme çalıştırmasını kuyruğa alır.
Arşivler
.zip, .tar, .tar.gz / .tgz ve .rar sunucuda açılır. Çıkarma kasıtlı olarak sıkıdır:
- hedefin dışına kaçacak girdiler reddedilir;
- gizli klasörler (
.git/,.obsidian/, …) düşürülür; - platformlar arasında taşınabilir olmayan adlar reddedilir;
- kaynağın indekslemediği uzantıdaki dosyalar atlanır;
- girdi sayısı ve toplam boyut sınırlandırılır (
ARCHIVE_MAX_ENTRIES,ARCHIVE_MAX_TOTAL_BYTES); - arşivin içindeki arşivler bir seviye açılır — bu, bir Notion export’unun ihtiyaç duyduğu şeydir,
çünkü zip’in içinde
Part-1.zipgönderir.
Atlanan her şey sessizce düşürülmek yerine size raporlanır, böylece tam olarak neyin alınıp neyin alınmadığını görebilirsiniz.
Dosyaları yönetmek
Bir upload kaynağı satırındaki Files, kaynağın şu anda ne tuttuğunu listeler. Tek tek dosyalar oradan silinebilir, bu da projeyi yeniden indeksler.
Dosyalar, konteynerin içinde DATA_DIR altında (varsayılan olarak /data), o kaynağa ait bir
klasörde yaşar. Kaynakla ve projeyle birlikte silinirler — nasıl yedekleneceği için bkz.
Yedekleme ve Veri.
Bir upload kaynağı, içeriğinin tek kopyasıdır. Bir git kaynağının (yeniden klonlanabilir) ya da bir Notion kaynağının (yeniden çekilebilir) aksine, silinen bir upload kaynağının dosyaları gider.
contextator-datavolume’unu yedeklerinize dahil edin.
Güncel tutmak
Senkronize edilecek bir şey yoktur — içerik değiştiğinde, Add ya da Replace seçerek yeniden yükleyin.
Aynı içerik bir depoda ya da sunucuda da yaşıyorsa, bunun yerine bir git kaynağı ya da bir yerel klasör tercih edin: ikisi de kendini günceller.
Sınırlar
| Ayar | Varsayılan |
|---|---|
UPLOAD_MAX_FILE_BYTES |
Dosya başına 50 MB |
UPLOAD_MAX_FILES_PER_REQUEST |
İstek başına 500 dosya (pano daha büyük klasörleri böler) |
UPLOAD_MAX_ARCHIVE_BYTES |
Arşiv başına 256 MB |
ARCHIVE_MAX_ENTRIES |
20.000 girdi |
ARCHIVE_MAX_TOTAL_BYTES |
Açıldığında 1 GB |
Hepsi yapılandırılabilir — bkz. Yapılandırma.
Bir vault ya da export yüklemek
- Obsidian vault — özel Obsidian vault sekmesini kullanın; bu, doğru content type’ı zaten seçili bir upload kaynağıdır. Bkz. Obsidian Vault’ları.
- Notion export zip’i — content type olarak Notion export ile Upload files’ı kullanın; bu, Notion’ın her dosya ve klasör adına eklediği 32 karakterlik sayfa id’lerini temizler. Bkz. İçerik Türleri.