texfot - Online în cloud

PROGRAM:

NUME

texfot - rulați TeX, filtrează transcrierea online pentru mesaje interesante

REZUMAT

texfot [opțiune] ... texcmd [texarg...]

DESCRIERE

„texfot” invocă texcmd cu dat texarg argumente, filtrarea ieșirii online pentru
mesaje ``interesante''. Valoarea lui de ieșire este aceea de texcmd. Exemple:

# Exemplu de invocare de bază:
texfot pdflatex file.tex

# De obicei, toată ieșirea este copiată în /tmp/fot înainte de filtrare;
# care poate fi omis:
texfot pdflatex --tee=/dev/null file.tex

# Exemplu de invocare a unui motor mai complex:
texfot lualatex --recorder „\nonstopmode\fișier de intrare”

În afară de propriile opțiuni, descrise mai jos, „texfot” doar rulează comanda dată cu
argumente date (aceeași abordare a sintaxei liniei de comandă ca „env”, „nice”, „time”, „timeout”,
etc.). Astfel, „texfot” funcționează cu orice motor și orice opțiune de linie de comandă.

„texfot” nu se uită la fișierul jurnal sau la orice alt fișier de ieșire posibil; doar arata
la ieșirea standard și eroare standard din comandă. stdout este procesat mai întâi,
apoi stderr. Liniile din stderr au un prefix de identificare. „texfot” scrie toate acceptate
linii la stdout-ul său.

Mesajele afișate sunt destinate să fie cele care probabil necesită acțiune din partea autorului: eroare
mesaje, casete preapline și insuficiente, citări nedefinite, caractere lipsă din
fonturi etc.

FLOW OF OPERAȚIUNEA

Iată ordinea în care sunt verificate liniile de ieșire:

1. Dacă trebuie tipărită „linia următoare” (vezi mai jos), tipăriți-o.

2. În caz contrar, dacă linia se potrivește cu lista încorporată de expresii regulate de ignorat, sau orice utilizator-
a furnizat o listă de expresii regulate de ignorat (dată cu „--ignore”, vezi mai jos), în această ordine,
ignora.

3. În caz contrar, dacă linia se potrivește cu lista de expresii regulate pentru care linia următoare (două linii
în total), ar trebui să fie afișat, afișați această linie și setați steag-ul „linia următoare” pentru următoarea
timpul în jurul buclei. Exemple sunt "!" și eroarea „filename:lineno:”.
mesaje, care sunt în general urmate de o linie cu detalii specifice despre eroare.

4. În caz contrar, dacă linia se potrivește cu lista de expresii regulate de afișat, afișați-o.

5. În caz contrar, implicit: dacă linia a venit de la stdout, ignorați-o; dacă linia venea de la
stderr, imprimați-l (la stdout). (Această distincție se face deoarece motoarele TeX scriu
relativ puține mesaje către stderr și nu este puțin probabil ca așa ceva să fie
considerat.

Ar fi ușor să adăugați mai multe opțiuni pentru a permite adăugarea utilizatorilor la diferite expresii regex
liste, dacă asta vi se pare util vreodată. Sau îmi e-mail (vezi sfârșit).

Odată ce o anumită verificare se potrivește, programul trece la procesarea următoarei linie.

Nu ezitați să citiți cu atenție sursa scenariului, care este, în esență, un simplu
potrivirea buclei cu diferitele liste ca mai sus. Puteți vedea expresiile regulate exacte
potrivite în diferitele categorii din sursă.

De altfel, deși nimic din această operațiune de bază nu este specific motoarelor TeX, toate
expresiile regulate incluse în program sunt specifice TeX. Deci, în practică
programul nu este util decât cu motoarele TeX, deși ar fi destul de ușor să-l adaptezi
(dacă mai era ceva la fel de verbos ca TeX pentru a face asta util).

OPŢIUNI

Următoarele sunt opțiunile pentru „texfot” în sine (nu este invocat motorul TeX;
consultați documentația TeX sau ieșirea „--help” a motorului pentru asta).

Prima non-opțiune termină parsarea opțiunii „texfot”, iar restul
linia de comandă este invocată ca comandă TeX, fără o analiză suplimentară. De exemplu, „texfot
--debug tex --debug" va scoate informații de depanare atât de la "texfot" cât și de la "tex".

Opțiunile pot începe cu - sau -- și pot fi prescurtate fără ambiguitate. Este cel mai bine
pentru a utiliza numele complet al opțiunii în scripturi, totuși, pentru a evita posibilele coliziuni cu noile
opțiuni în viitor.

"--debug"
„--no-debug”
Ieșiți (sau nu) ceea ce se face pe eroare standard. Oprit implicit.

"--ignora" expresie regulată
Ignorați liniile în potrivirea ieșirii TeX (Perl) expresie regulată. Poate fi repetat. Se adaugă la
set implicit de expresii regulate de ignorare în loc de înlocuire. Aceste expresii regulate nu sunt
ancorat automat (sau modificat în alt mod), pur și simplu folosit așa cum este.

"--interactiv"
„--nu-interactiv”
În mod implicit, intrarea standard în procesul TeX este închisă, astfel încât modul interactiv al TeX
(se așteaptă intrarea în caz de eroare, promptul „*”, etc.) nu este introdus niciodată. Dăruind
„--interactive” permite interacțiunea.

"--Liniște"
"--nu-liniște"
În mod implicit, comanda TeX invocată este raportată pe ieșirea standard. "--Liniște"
omite acea raportare.

"--stderr"
"--no-stderr"
Valoarea implicită este ca „texfot” să raporteze tot ce este scris în stderr prin comanda TeX
(pe stdout). „--no-stderr” omite această raportare. (Unele programe, „dvisvgm” este unul,
poate fi destul de pronunțat pe stderr.)

"--trică" fişier
În mod implicit, rezultatul filtrat este „tee”-ed, înainte de filtrare, la „$TMPDIR/fot”
("/tmp/fot" dacă "TMPDIR" nu este setat), pentru a facilita verificarea ieșirii complete atunci când
filtrarea pare suspectă. Această opțiune permite specificarea unui fișier diferit. Utilizare
„--tee /dev/null” dacă nu doriți deloc rezultatul original.

"--versiune"
Ieșiți informații despre versiune și ieșiți cu succes.

"--Ajutor"
Afișați acest ajutor și ieșiți cu succes.

FUNDAMENTARE

Am scris asta pentru că, în munca mea ca editor TUGboat (http://tug.org/TUGboat>, jurnal
trimiterile sunt întotdeauna binevenite!), ajung să rulez și să reluez multe lucrări, de multe ori fiecare.
Era prea ușor să pierd avertismentele pe care trebuia să le văd în masa nevariabilă și
rezultate neinteresante din TeX, cum ar fi fișierele de stil citite și fonturile folosite. eu
am vrut să văd toate și numai acele mesaje care au nevoie de ceva acțiune din partea mea.

Am găsit alte programe de natură similară, pachetul LaTeX „silence” și multe
a altor ambalaje (La)TeX, dar se părea că niciunul nu a făcut ceea ce mi-am dorit. Ori au citit
fișierul jurnal (am vrut doar ieșirea online) sau au scos mai mult sau mai puțin decât am vrut,
sau au necesitat invocarea TeX diferit (am vrut să păstrez procesul meu de construire exact
același lucru, cel mai critic invocarea TeX, care se poate complica). De aceea am scris asta.

Iată câteva cuvinte cheie dacă doriți să explorați alte opțiuni: texloganalyser, pydflatex,
logfilter, latexmk, rubber, arara și căutarea „log” lahttp://ctan.org/search>.

„texfot” este scris în Perl și rulează pe Unix și nu funcționează pe Windows. (Dacă de către unii
șansa că cineva dorește să folosească acest program pe Windows, vă rugăm să vă faceți propria furcă; nu sunt
interesat să sprijine acel sistem.)

Numele provine de la fișierele „trip.fot” și „trap.fot” care fac parte din călătoria lui Knuth și
teste de tortură cu capcană, care înregistrează rezultatele online din programe. Nu sunt sigur ce
„fot” înseamnă în trip și trap, dar pot pretinde că înseamnă „filtru online
transcriere" în cazul de față :).

AUTORI AND DREPTURI DE AUTOR

Acest scenariu și documentația sa au fost scrise de Karl Berry și ambele sunt eliberate către
domeniu public. E-mail "[e-mail protejat]" cu rapoarte de erori. Nu are nicio pagină de pornire dincolo
pachetul pe CTAN:http://www.ctan.org/pkg/texfot>.

Utilizați texfot online folosind serviciile onworks.net