mkjobtexmf - Online in de cloud

PROGRAMMA:

NAAM

mkjobtexmf - Genereer een texmf-boom voor een bepaalde taak

VERSIE

2011-11-10 v0.8

KORTE INHOUD

het programma mkjobtexmf voert een programma uit en probeert de gebruikte bestandsnamen te vinden. Twee methoden
zijn beschikbaar, optie "-recorder" van TeX (Web2C) of het programma spoor.

Vervolgens genereert het een map met een texmf-boom. Het controleert de gevonden bestanden en probeert te sorteren
ze in deze texmf-boom.

Het kan worden gebruikt voor archiveringsdoeleinden of om de volgende TeX-runs te versnellen.

mkjobtexmf [opties]

Hiermee wordt TeX uitgevoerd dat kan worden geconfigureerd met opties. Beide methoden om het gebruikte bestand te verkrijgen
namen zijn beschikbaar.

mkjobtexmf [opties] -- [argumenten]

Deze laatste vorm voert het programma uit cmd met argumenten betoogt in plaats van TeX. Alleen als methode
programma spoor beschikbaar is.

Opties:

--jobnaam Naam van de functie (verplicht).
Meestal is dit het TeX-bestand
zonder verlenging
--texnaam Invoerbestand voor TeX. Standaard is de
functienaam met extensie '.tex'
--tekstopt Optie voor TeX-run
--destdir Doelmap,
standaard is ` .mjt'
--output Voeg ook uitvoerbestanden toe
--strace Gebruik strace in plaats van TeX's
optie -recorder
--copy Kopieer bestanden in plaats van ze te maken
symbool links
--flat Ongewenste paden, maak geen mappen aan
in de doelmap
--(no)texhash Voer texhash uit, gebruik --notexhash voor MiKTeX
--uitsluiten-ext Bestanden met extensie uitsluiten .
--cmd-tex Commando voor de TeX-compiler
--cmd-kpse Which Commando voor kpse Which
--cmd-texhash Commando voor texhash
--cmd-strace Commando voor statie
--verbose Uitgebreide uitvoer
--help Kort hulpbericht
--man Volledige documentatie
--version Identificatie van de printversie

PRODUCTBESCHRIJVING

Hardlopen de programma

Voornaam* mkjobtexmf voert een programma uit, meestal TeX. De TeX-compiler wordt per optie geconfigureerd
"--cmd-tex". De optie "--texname" kan worden gebruikt als de bestandsnaamextensie afwijkt van .tex:

mkjobtexmf --jobnaam foo --texnaam foo.ltx

Er zijn zelfs nog ingewikkelder gevallen mogelijk:

mkjobtexmf --jobnaam foo --texnaam '\def\abc{...}\input{foo}'

Indien een ander programma dan TeX gebruikt moet worden (dvips, ...), dan kan dit programma gegeven worden
na "--":

mkjobtexmf --jobnaam foo -- dvips foo

Dien in opname

Er zijn twee methoden beschikbaar om de gebruikte bestandsnamen te verkrijgen:

Recorder van TeX
Sommige TeX-distributies (bijvoorbeeld Web2C) ondersteunen deze optie -recorder voor zijn TeX
compilers. Vervolgens genereert de TeX-compiler een bestand met extensie .fls dat registreert de
gebruikte invoer- en uitvoerbestanden.

Programma spoor
Dit programma traceert systeemoproepen en signalen. Het wordt hier gebruikt om de gebruikte bestanden te loggen.

Analyseren en linken/kopiëren gevonden bestanden

De resultatenmap functienaam.mjt is gegenereerd. Binnen het resultaat wordt een TEXMF-boom gemaakt.
Elk gevonden bestand wordt vergeleken met een lijst met paden van TEXMF-bomen. Als er een match wordt gevonden,
het bestand wordt gekoppeld/gekopieerd naar de TEXMF-boom. De lijst met paden wordt door het programma gegenereerd
kpsedie.

Als het bestand niet kan worden toegewezen aan een TEXMF-boom en het bestand een relatieve bestandsnaam heeft, dan wordt het
wordt direct gekoppeld/gekopieerd naar de resultatenmap functienaam.mjt. Absolute bestandsnamen zijn
niet ondersteund en ook geen paden met links naar bovenliggende mappen.

Er worden standaard symbolische koppelingen gemaakt. De bestanden worden gekopieerd als de optie "--copy" wordt gegeven of
symbolische koppeling is niet beschikbaar.

OPTIES

--taaknaam=<functienaam>
Het is de naam van de baan. `functienaam>.tex' fungeert als standaard voor het TeX-bestand en
<functienaam> wordt gebruikt voor het benoemen van verschillende mappen en bestanden. Zie sectie "BESTANDEN".

--texnaam=<naam>
De naam van het TeX-invoerbestand, als deze afwijkt vanfunctienaam>.tex.

--tekstopt=<opteren>
Extra optie voor de TeX-compiler, voorbeelden zijn "--ini" of "--shell-escape". Dit
optie kan meer dan één keer worden gegeven.

--bestemmingsmap=<directory>
Specificeert de naam van de doelmap waar het resultaat wordt verzameld. Als
standaard wordt er een map gegenereerd in de huidige map met de taaknaam en
extensie `.mjt'.

--uitvoer
Voeg ook uitvoerbestanden toe.

--strak
Gebruik methode met programma spoor, zie beschrijving".

--kopiëren
Bestanden worden gekopieerd in plaats van dat er symbolische koppelingen worden gemaakt.

--vlak
Bestanden worden zonder padelementen gekoppeld of gekopieerd. De doelmap zal dat wel doen
bevatten een platte lijst met bestanden of links zonder directory.

De bestanden `ls-R' en `aliassen' worden genegeerd.

--uitsluiten-ext=<ext>
Bestanden met extensieext> zijn uitgesloten. De optie kan meerdere keren worden gegeven of a
een door komma's gescheiden lijst met extensies kan worden gebruikt. Voorbeelden:

--exclude-ext aux --exclude-ext logboek --exclude-ext toc

is hetzelfde als

--exclude-ext aux,log,toc

--(geen) texhash
Standaard wordt het bestand `ls-R' gegenereerd in de `texmf'-boom, omdat dit het bestand is
naamdatabase die in TeX Live kan worden gebruikt. Omdat MiKTeX een ander gebruikt
mechanisme genereert zijn `texhash' niet de `ls-R'-bestanden en "--notexhash"
onderdrukt de roep van `texhash'.

--cmd-tex=<cmd>
Commando voor de TeX-compiler. Standaard is pdflatex.

--cmd-kpswaarvan=<cmd>
Commando voor kpse Which.

--cmd-texhash=<cmd>
Commando voor het bijwerken van de bestandsnaamdatabase van de gegenereerde texmf-boom. Standaard is
tekstmf.

--cmd-strace=<cmd>
Commando voor statie.

--uitgebreid
Uitgebreide berichten.

--help
Geef het helpscherm weer.

-B(-man>
Handleidingpagina afdrukken.

--versie
Identificatie van de printversie en afsluiten.

Voorbeelden

TeX-bestand test.tex met behulp van de recordermethode van TeX:

mkjobtexmf --jobname test

TeX-bestand test.tex LaTeX gebruiken:

mkjobtexmf --jobnaam test --cmd-tex latex

Formaat genereren:

mkjobtexmf --jobnaam test --texopt -ini --texnaam pdflatex.ini

Voorbeeld hoe de nieuwe texmf-boom (Linux/bash) kan worden gebruikt:

TEXMF=!!test.mjt/texmf pdflatex-test

Voorbeeld voor het genereren van een zip-archief (Linux/bash):

(cd test.mjt && zip -9r ../test .)

Voorbeeld voor het genereren van een tar-archief:

tar cjhvf test.tar.bz2 -C test.mjt .

onopgelost PROBLEMEN, WAARSCHUWINGEN, ALLE

Experimentele software
Opties, standaardinstellingen en hoe het programma werkt kunnen in toekomstige versies veranderen.

texmf.cnf
Momenteel is de methode met spoor registreert deze bestanden. De recorder van TeX doet dat niet. Bruikbaar
zijn texmf.cnf bestanden voor variabele instellingen. Omdat we maar één TEXMF-boom hebben, de
padsecties moeten waarschijnlijk herschreven worden.

Instellingen in omgevingsvariabelen
Ze worden helemaal niet opgeslagen.

botsingen
Het programma gebruikt één doelmap en maximaal één TEXMF-boom voor het resultaat.
De bronbestanden kunnen echter uit verschillende mappen en TEXMF-bomen komen.
Daarom zijn naambotsingen mogelijk.

Het programma volgt de strategie om geen bestanden in de doelmap te verwijderen.
Dat maakt het mogelijk om bestanden van verschillende runs te verzamelen. Zo worden botsingen opgelost in de
manier waarop de eerste vermelding in de doelmap wint.

Configuratiebestand
Het zou de gebruiker ervan weerhouden dezelfde opties steeds opnieuw te typen.

Onvolledige opname
Bugs in de bestandsopname van TeX kunnen leiden tot onvolledige bestandsopname (bijv. pdfTeX
1.40.3 neemt geen .pfb- en .pk-bestanden op).

...

Gebruik mkjobtexmf online met behulp van onworks.net-services