sty2dtx - Online nel cloud

PROGRAMMA:

NOME

sty2dtx -- Converte un file LaTeX .sty in un file .dtx documentato

VERSIONE

Versione: v2.3

COPYRIGHT

Copyright (c) 2010-2012 Martin Scharrer[email protected]>

Questo programma è un software gratuito: puoi ridistribuirlo e/o modificarlo secondo i termini di
la GNU General Public License come pubblicata dalla Free Software Foundation, sia
versione 3 della Licenza o (a tua scelta) qualsiasi versione successiva.

Questo programma è distribuito nella speranza che possa essere utile, ma SENZA ALCUNA GARANZIA;
senza nemmeno la garanzia implicita di COMMERCIABILITÀ o IDONEITÀ PER UN PARTICOLARE SCOPO.
Vedere la GNU General Public License per maggiori dettagli.

Dovresti aver ricevuto una copia della GNU General Public License insieme a questo programma.
In caso contrario, vedihttp://www.gnu.org/licenses/>.

DESCRIZIONE

Converte un file .sty (pacchetto LaTeX) in formato .dtx (fonte LaTeX documentata),
definizioni macro circostanti con ambienti 'macro' e 'macrocodice'. Il nome della macro
viene automaticamente inserito come argomento nell'ambiente 'macro'. Righe di codice all'esterno
le definizioni delle macro sono racchiuse solo negli ambienti 'macrocodice'. Le righe vuote vengono rimosse.
Lo script non è pensato per essere infallibile e accurato al 100%, ma piuttosto come un buon inizio per
convertire file di stile non documentati in file .dtx.

Basic Impiego
perl sty2dtx.pl file interno [file interno ...] file esterno

or

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

Supporto Definizioni
Le seguenti definizioni di macro vengono rilevate quando si trovano all'inizio di una riga (possono essere
preceduto da \global, \long, \protected e/o \outer):

\def \edef \gdef \xdef
\nuovocomando{\nome} \nuovocomando*{\nome}
\nuovocomando\nome \nuovocomando*\nome
\renewcommand{\name} \renewcommand*{\name}
\renewcommand\nome \renewcommand*\nome
\providecommand{\name} \providecommand*{\name}
\providecommand\nome \providecommand*\nome
\@namedef{\nome} \@namedef\nome

Le seguenti definizioni di ambiente vengono rilevate quando si trovano all'inizio di una riga:

\newenvironment{nome} \renewenvironemnt{nome} \provideenvironment{nome}

La definizione della macro e dell'ambiente deve terminare sulla stessa riga o con un '"}"' acceso
proprio su una linea.

USO

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

File
· può essere '"-"' per STDIN o STDOUT, che è l'impostazione predefinita se non vengono forniti file

· più file di input vengono uniti in un file di output

Variabili
Le variabili possono essere definite usando

-- =

or

--

e verrà utilizzato per le sostituzioni nel file modello.

Uncommon variabili:

autore, email, manutentore, anno (per il copyright),
versione, data, descrizione (del pacchetto/classe),
tipo (predefinito 'pacchetto' o 'classe'),
filebase (impostato automaticamente dal nome del file di output o di input),

Opzioni
-h Stampa questo testo di aiuto
-H Stampa la guida estesa
-V Versione cartacea e copyright
-v Sii prolisso
-o produzione Usa il file dato come output
-O Sovrascrivi file di output già esistenti
-B Usa il nome di base del singolo file di input per il file di output
-I Crea anche il file .ins (installa)
-c Usa solo la sezione del codice (come v1.0)
-r Rimuovere gli ambienti 'macro', 'macrocode', ecc. esistenti.
-R Non rimuovere gli ambienti 'macro', 'macrocodice', ecc. esistenti.
-i ins-file Crea un file .ins con il nome dato
-t modello Usa questo file come modello invece di quello predefinito
-T modello Usa questo file come modello per il file .ins
-e filetto Esporta il modello .dtx predefinito in un file ed esci
-E filetto Esporta il modello .ins predefinito in un file ed esci
-D Usa la data corrente come data del file
-F filetto Leggi più opzioni e variabili da file.
-N Non leggere il file di configurazione predefinito; deve essere la prima opzione

Config file
Un file di configurazione predefinito chiamato 'sty2dtx.cfg' o '.sty2dtx.cfg' viene cercato nel
directory corrente, la directory home degli utenti e la directory di questo script, in questo
ordine. Viene caricato il primo trovato. Se non viene trovato nessuno, viene cercato l'albero 'texmf' a
file di configurazione 'sty2dtx.cfg'. Come con i file -F, il file di configurazione dovrebbe contenere un'opzione o
variabile per riga. Le righe che iniziano con '"%"' o '"#"' vengono ignorate.

Esempi

Produci 'file.dtx' da 'file.sty':

sty2dtx.pl < file.sty > file.dtx

or

sty2dtx.pl file.sty file.dtx

or

sty2dtx.pl -B file.sty

Produci 'file.dtx' e 'file.ins' da 'file.sty':

sty2dtx.pl -I file.sty file.dtx

or

sty2dtx.pl file.sty -i file.sty file.dtx

or

sty2dtx.pl -IB file.sty

Imposta i valori delle variabili personalizzate:

sty2dtx.pl --author Io --email [email protected] miopkg.sty miopkg.dtx

Produci file DTX per una classe:

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

Usa sty2dtx online usando i servizi onworks.net