sty2dtx - Online in de cloud

PROGRAMMA:

NAAM

sty2dtx -- Converteert een LaTeX .sty-bestand naar een gedocumenteerd .dtx-bestand

VERSIE

Versie: v2.3

COPYRIGHT

Auteursrecht (c) 2010-2012 Martin Scharrermartin@scharrer-online.de>

Dit programma is vrije software: u kunt het herdistribueren en/of wijzigen onder de voorwaarden van:
de GNU General Public License zoals gepubliceerd door de Free Software Foundation, ofwel
versie 3 van de Licentie, of (naar uw keuze) een latere versie.

Dit programma wordt verspreid in de hoop dat het nuttig zal zijn, maar ZONDER ENIGE GARANTIE;
zonder zelfs de impliciete garantie van VERKOOPBAARHEID of GESCHIKTHEID VOOR EEN BEPAALD DOEL.
Zie de GNU General Public License voor meer details.

U zou samen met dit programma een kopie van de GNU General Public License moeten hebben ontvangen.
Zo niet, ziehttp://www.gnu.org/licenses/>.

PRODUCTBESCHRIJVING

Converteert een .sty-bestand (LaTeX-pakket) naar .dtx-indeling (gedocumenteerde LaTeX-bron), door
omringende macrodefinities met 'macro'- en 'macrocode'-omgevingen. De macronaam
wordt automatisch ingevoegd als argument voor de 'macro'-omgeving. Codelijnen buiten
macrodefinities worden alleen verpakt in 'macrocode'-omgevingen. Lege regels worden verwijderd.
Het script wordt niet beschouwd als waterdicht en 100% nauwkeurig, maar eerder als een goed begin
converteer niet-gedocumenteerde stijlbestanden naar .dtx-bestanden.

Basic Gebruik
perl sty2dtx.pl inbestand [inbestand ...] uitbestand

or

perl sty2dtx.pl < bestand.sty > bestand.dtx

ondersteunde Definities
De volgende macrodefinities worden gedetecteerd wanneer ze aan het begin van een regel staan ​​(kan zijn
voorafgegaan door \global, \long, \protected en/of \outer):

\def \edef \gdef \xdef
\nieuwcommando{\naam} \nieuwcommando*{\naam}
\nieuweopdracht\naam \nieuweopdracht*\naam
\vernieuwopdracht{\naam} \vernieuwopdracht*{\naam}
\hernieuwcommando\naam \hernieuwcommando*\naam
\geefopdracht{\naam} \geefopdracht*{\naam}
\geefcommando\naam \geefcommando*\naam
\@namedef{\naam} \@namedef\naam

De volgende omgevingsdefinities worden gedetecteerd wanneer ze aan het begin van een regel staan:

\nieuweomgeving{naam} \hernieuwdeomgeving{naam} \provideenomgeving{naam}

De macro- en omgevingsdefinitie moet eindigen op dezelfde regel of met een '"}"' erop
zijn eigen op een lijn.

GEBRUIK

sty2dtx [ ] [-- = ...] [--] [ ] [ ]

Bestanden
· kan '"-"' zijn voor STDIN of STDOUT, wat de standaard is als er geen bestanden zijn opgegeven

· meerdere invoerbestanden worden samengevoegd tot één uitvoerbestand

Variabelen
Variabelen kunnen worden gedefinieerd met behulp van

-- =

or

--

en zal worden gebruikt voor vervangingen in het sjabloonbestand.

Gemeen variabelen:

auteur, e-mail, onderhouder, jaar (voor copyright),
versie, datum, omschrijving (van pakket/klasse),
type ('pakket' standaard of 'klasse'),
bestandsbasis (automatisch ingesteld vanuit uitvoer of invoerbestandsnaam),

Opties
-h Druk deze helptekst af
-H Uitgebreide hulp afdrukken
-V Printversie en copyright
-v Wees uitgebreid
-o uitvoer Gebruik gegeven bestand als uitvoer
-O Reeds bestaand uitvoerbestand(en) overschrijven
-B Gebruik de basisnaam van een enkel invoerbestand als uitvoerbestand
-I Maak ook een .ins (installatie) bestand aan
-c Gebruik alleen codesectie (zoals v1.0)
-r Verwijder bestaande 'macro', 'macrocode', etc. omgevingen.
-R Verwijder geen bestaande 'macro', 'macrocode', etc. omgevingen.
-i ins-bestand Maak een .ins-bestand met de opgegeven naam
-t sjabloon Gebruik dit bestand als sjabloon in plaats van het standaardbestand
-T sjabloon Gebruik dit bestand als sjabloon voor het .ins-bestand
-e filet Exporteer standaard .dtx-sjabloon naar bestand en sluit af
-E filet Exporteer standaard .ins-sjabloon naar bestand en sluit af
-D Gebruik huidige datum als bestandsdatum
-F filet Lees meer opties en variabelen uit het bestand.
-N Lees het standaard configuratiebestand niet; moet de eerste optie zijn

Config bestanden
Er wordt gezocht in een standaardconfiguratiebestand met de naam 'sty2dtx.cfg' of '.sty2dtx.cfg' in de
huidige map, de thuismap van de gebruiker en de map van dit script, hierin
volgorde. De eerst gevonden wordt geladen. Als er geen wordt gevonden, wordt in de 'texmf'-structuur gezocht naar een
configuratiebestand 'sty2dtx.cfg'. Net als bij -F-bestanden moet het configuratiebestand één optie bevatten of
variabel per regel. Regels die beginnen met '"%"' of '"#"' worden genegeerd.

Voorbeelden

Produceer 'file.dtx' uit 'file.sty':

sty2dtx.pl < bestand.sty > bestand.dtx

or

sty2dtx.pl bestand.sty bestand.dtx

or

sty2dtx.pl -B bestand.sty

Produceer 'file.dtx' en 'file.ins' uit 'file.sty':

sty2dtx.pl -I bestand.sty bestand.dtx

or

sty2dtx.pl bestand.sty -i bestand.sty bestand.dtx

or

sty2dtx.pl -IB-bestand.sty

Stel aangepaste variabele waarden in:

sty2dtx.pl --auteur Ik --e-mail ik@daar.com mypkg.stal mypkg.dtx

Produceer een DTX-bestand voor een klasse:

sty2dtx.pl --type klasse mycls.sty mycls.dtx

Gebruik sty2dtx online met behulp van onworks.net-services