sty2dtx — Online w chmurze

PROGRAM:

IMIĘ

sty2dtx — Konwertuje plik LaTeX .sty na udokumentowany plik .dtx

WERSJA

Wersja: v2.3

PRAWA AUTORSKIE

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

Ten program jest darmowym oprogramowaniem: możesz go redystrybuować i/lub modyfikować na warunkach
Powszechna Licencja Publiczna GNU opublikowana przez Free Software Foundation,
wersja 3 Licencji lub (według Twojego wyboru) dowolna nowsza wersja.

Ten program jest rozpowszechniany w nadziei, że będzie przydatny, ale BEZ ŻADNEJ GWARANCJI;
bez dorozumianej gwarancji PRZYDATNOŚCI HANDLOWEJ lub PRZYDATNOŚCI DO OKREŚLONEGO CELU.
Więcej szczegółów znajdziesz w Powszechnej Licencji Publicznej GNU.

Wraz z tym programem powinieneś otrzymać kopię Powszechnej Licencji Publicznej GNU.
Jeśli nie, zobaczhttp://www.gnu.org/licenses/>.

OPIS

Konwertuje plik .sty (pakiet LaTeX) na format .dtx (udokumentowane źródło LaTeX), poprzez
otaczające definicje makr ze środowiskami „makro” i „makrokod”. Nazwa makra
jest automatycznie wstawiany jako argument środowiska „makro”. Linie kodu na zewnątrz
definicje makr są pakowane tylko w środowiskach „makrokodu”. Puste linie są usuwane.
Scenariusz nie jest uważany za niezawodny i w 100% dokładny, ale raczej za dobry początek
konwertuj nieudokumentowane pliki stylu na pliki .dtx.

Basic Stosowanie
perl sty2dtx.pl plik wejściowy [plik wejściowy ...] plik wyjściowy

or

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

Utrzymany Definicje
Następujące definicje makr są wykrywane, gdy znajdują się na początku wiersza (może to być
poprzedzone przez \global, \long, \protected i/lub \outer):

\def \edef \gdef \xdef
\nowe polecenie{\nazwa} \nowe polecenie*{\nazwa}
\nowepolecenie\nazwa \nowe polecenie*\nazwa
\renewcommand{\nazwa} \renewcommand*{\name}
\renewcommand\name \renewcommand*\name
\providecommand{\name} \providecommand*{\name}
\providecommand\nazwa \providecommand*\nazwa
\@namedef{\nazwa} \@namedef\nazwa

Następujące definicje środowiska są wykrywane, gdy znajdują się na początku wiersza:

\newenvironment{nazwa} \renewenvironemnt{nazwa} \provideenvironment{nazwa}

Definicja makra i środowiska musi kończyć się tą samą linią lub włączoną opcją „”}”.
swój własny na linii.

ZASTOSOWANIE

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

Akta
· może być '"-"' dla STDIN lub STDOUT, co jest ustawieniem domyślnym, jeśli nie podano żadnych plików

· wiele plików wejściowych jest łączonych w jeden plik wyjściowy

Zmienne
Zmienne można definiować za pomocą

-- =

or

--

i zostaną użyte do podstawień w pliku szablonu.

wspólny zmienne:

autor, adres e-mail, opiekun, rok (w zakresie praw autorskich),
wersja, data, opis (pakietu/klasy),
typ (albo „pakiet” domyślny, albo „klasa”),
baza plików (ustawiana automatycznie na podstawie nazwy pliku wyjściowego lub wejściowego),

Opcje
-h Wydrukuj ten tekst pomocy
-H Wydrukuj rozszerzoną pomoc
-V Wersja do druku i prawa autorskie
-v Bądź gadatliwy
-o wydajność Użyj podanego pliku jako wyniku
-O Zastąp już istniejące pliki wyjściowe
-B Użyj nazwy podstawowej pojedynczego pliku wejściowego dla pliku wyjściowego
-I Utwórz także plik .ins (install).
-c Używaj tylko sekcji kodu (np. v1.0)
-r Usuń istniejące środowiska „makro”, „makrokod” itp.
-R Nie usuwaj istniejących środowisk „makro”, „makrokod” itp.
-i plik ins Utwórz plik .ins o podanej nazwie
-t szablon Użyj tego pliku jako szablonu zamiast domyślnego
-T szablon Użyj tego pliku jako szablonu dla pliku .ins
-e filet Eksportuj domyślny szablon .dtx do pliku i wyjdź
-E filet Eksportuj domyślny szablon .ins do pliku i wyjdź
-D Użyj bieżącej daty jako daty pliku
-F filet Przeczytaj więcej opcji i zmiennych z pliku.
-N Nie czytaj domyślnego pliku konfiguracyjnego; musi być pierwszą opcją

Config pliki
Domyślny plik konfiguracyjny o nazwie „sty2dtx.cfg” lub „.sty2dtx.cfg” jest przeszukiwany w
bieżący katalog, katalog domowy użytkownika i katalog tego skryptu, w this
zamówienie. Pierwszy znaleziony zostanie załadowany. Jeśli żaden nie zostanie znaleziony, przeszukiwane jest drzewo „texmf” w poszukiwaniu pliku
Plik konfiguracyjny „sty2dtx.cfg”. Podobnie jak w przypadku plików -F, plik konfiguracyjny powinien zawierać jedną opcję lub
zmienna na linię. Linie zaczynające się od „%” lub „#” są ignorowane.

Przykłady

Utwórz „plik.dtx” z „pliku.sty”:

sty2dtx.pl < plik.sty > plik.dtx

or

sty2dtx.pl plik.sty plik.dtx

or

sty2dtx.pl -B plik.sty

Utwórz „file.dtx” i „file.ins” z „file.sty”:

sty2dtx.pl -I plik.sty plik.dtx

or

sty2dtx.pl plik.sty -i plik.sty plik.dtx

or

sty2dtx.pl -IB plik.sty

Ustaw wartości zmiennych niestandardowych:

sty2dtx.pl --autor Ja --e-mail ja@there.com mójpkg.sty mójpkg.dtx

Utwórz plik DTX dla klasy:

sty2dtx.pl --typ klasy mycls.sty mycls.dtx

Użyj sty2dtx online, korzystając z usług onworks.net