Súbory a nástroje pre repozitáre

Otvorte Nastavenia → Pluginy a prezrite si zabudovaný plugin files alebo ho nastavte. V chate môže Elowen jeho desiatimi nástrojmi čítať, prehľadávať, vypisovať a meniť súbory na miestach, kam aktuálna konverzácia dosiahne, a kopírovať alebo presúvať jeden súbor medzi dvoma Projektmi. Plugin nemá vlastnú stránku ani príkaz s lomítkom.

Nástroje

Prístup k súborom a bezpečné úpravy

Nástroje pre súbory sa riadia prístupom aktuálnej konverzácie k Projektu a k cestám. V spravovanom Projekte je dostupný súborový systém zdieľaného prostredia Projektu. Cesta mimo povolenej hranice je odmietnutá.

V Projekte typu Počítač pracujú tie isté nástroje so súbormi priamo na tomto počítači. Absolútne cesty mimo priečinka, v ktorom beží jeho pripojenie, sú povolené, ak na ne dosiahne účet operačného systému tohto počítača. Čítanie oprávňuje na neskoršiu úpravu len na tom istom počítači; iný počítač ho neprevezme. Ak pripojenie spadne, nástroj ohlási stratené pripojenie a nikdy sa nepresunie na súbory servera. GitStatus tam nie je dostupný a dá to najavo.

Pred zmenou súboru pomocou Write alebo Edit ho prečítajte. Nástroje úpravu odmietnu aj vtedy, keď sa súbor od prečítania zmenil. Príkaz v shelli, ktorý súbor len vypíše, túto požiadavku nespĺňa; použite Read.

Write nahradí celý súbor. Na cielenú zmenu použite Edit; nahrádza vždy jednu presnú zhodu. Úspešné čítanie veľkého súboru možno stránkovať, ale kontrola prečítania pred zápisom pokrýva celý súbor.

TransferFile určuje Projekt a cestu na oboch stranách a prenáša vždy jeden súbor. Cieľ sa vytvorí, ak prenos nenahrádza verziu, ktorú dostal; presun odstráni zdroj až po zapísaní cieľa a zrušený alebo prerušený prenos sa sám nikdy neopakuje. Rovnako ako Write a Edit vyžaduje v predvolenom nastavení Vaše schválenie.

Zapnite a nastavte plugin

Plugin je súčasťou inštalácie a v novej inštalácii je zapnutý. Administrátori ho môžu zapnúť alebo vypnúť v Nastavenia → Pluginy. Nemožno ho prideľovať jednotlivo. Jeho nastavenia platia pre celú inštanciu a upravujú sa v detaile pluginu v Nastavenia → Pluginy.

Limity a správanie

• Read zobrazí v predvolenom nastavení 2 000 riadkov. Na stránkovanie textového súboru použite offset a limit. Každá textová strana, aj s výslovne zadaným limit, musí splniť nastavený limit čítania aj živý limit vloženého výstupu, vrátane čísel riadkov a oznámení o stránkovaní. Príliš veľké strany sú odmietnuté a neoprávňujú na Write ani Edit; vyžiadajte menšiu stranu. Posuny riadkov nemôžu rozdeliť dlhý riadok: použite cielený štruktúrovaný filter alebo obmedzený výrez cez Bash. Úspešná malá strana napriek tomu spočíta hash celého súboru pre neskoršie kontroly zmien.
• Nestránkované čítanie je odmietnuté, ak jeho odhadovaná cena v tokenoch presiahne 25 000. PDF do 10 strán môže rozsah strán vynechať; väčšie PDF ho potrebuje. Použite rozsahy ako 3, 1-5 alebo 1,3,5. Naskenované strany sa vracajú ako obrázky, najviac päť na volanie.
• Podporované obrázky sú JPG, PNG, GIF, WebP a BMP. Elowen každý obrázok zmenší tak, aby sa zmestil do 2 000 × 2 000 pixelov, a vráti ho ako prílohu. Keď zmenšenie zlyhá, originál sa odošle bez zmeny iba vtedy, ak ide o JPG, PNG, GIF alebo WebP do 3,75 MB; inak sa obrázok vynechá a výsledok to uvedie.
• Write, Edit a TransferFile môžu meniť súbory; ostatné nástroje sú len na čítanie a možno ich použiť v režime Plánovanie.
• Search a Grep vyžadujú ripgrep. Search ignoruje veľkosť písmen; Grep rozlišuje veľkosť písmen, ak nezadáte inak. Nastavte multiline: true na zhody cez viac riadkov. Search preskakuje .git, node_modules, dist, web-dist, .next a .turbo. Grep so zadaným typom spustí hľadanie priamo v jednom vykonaní. Iba bežný návratový kód ripgrepu 2 spustí vyhľadanie zoznamu typov, ktoré vysvetlí neznámy typ; pri známom type zostáva pôvodná chyba hľadania. Výsledky bez zhôd zostávajú prázdne a chýbajúce programy, signály, časové limity ani chyby prenosu toto vyhľadanie nespustia.
• Search má časový limit päť sekúnd. Výsledky Search a strany Grep obmedzuje searchMaxMatches; na pokračovanie výpisu Grep použite offset. Riadky so zhodou sú obmedzené na 500 stĺpcov. Každá strana Grep pojme najviac rovnaký počet výsledkov a jej obsahový režim ukazuje riadky so zhodou.
• Glob vracia v predvolenom nastavení najviac 100 súborov a zastaví sa po prejdení 10 000 súborov. Na hostiteľovi preskakuje nečitateľné podadresáre a výslovne uvedie, že výsledky sú neúplné. Nečitateľný koreň hľadania alebo iná chyba súborového systému hľadanie ukončí chybou. Výpis adresára v spravovanom Projekte je obmedzený na 1 000 položiek. GitStatus ukáže najviac 120 položiek zmenených súborov.
• Úprava súboru väčšieho ako 1 GB je odmietnutá. Čítanie vybraných súborov zariadení a typov súborov, ktoré plugin nevie zobraziť, je odmietnuté.
• Podpora PDF vyžaduje nástroje Poppler (pdfinfo, pdftotext a pdftoppm) na počítači alebo v prostredí, kde súbor leží, s časovým limitom 30 sekúnd na každý príkaz prevodníka. Na spárovanom počítači nainštalujte Poppler príkazom winget install --id oschwartz10612.Poppler -e vo Windows, brew install poppler v macOS alebo apt install poppler-utils / dnf install poppler-utils v Linuxe. Potom na tomto počítači spustite v novom termináli elowen tools install pdf. Ak je Poppler mimo PATH, odovzdajte --bin <directory>. Tým sa nainštalované programy overia a zapamätajú. Naskenované strany sa vracajú ako obrázky, najviac päť na volanie. PDF oprávňuje na nahradenie iba vtedy, keď bol zobrazený celý dokument.

Pozrite Pluginy pre životný cyklus pluginov a Sandbox a prostredia pre prístup k súborom v spravovanom Projekte.