summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-07-02 22:12:17 +0000
committerKarl Berry <karl@freefriends.org>2015-07-02 22:12:17 +0000
commit586aedcf63ecf6ea7da1c1529e5ea5ba8f5cb426 (patch)
treeb679941add6df7f6b1ee8c135b24181f992dcb65 /Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex
parentfecdcd43eaa7f73e830159293fe22a202803086b (diff)
tudscr (2jul15)
git-svn-id: svn://tug.org/texlive/trunk@37736 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex')
-rw-r--r--Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex137
1 files changed, 102 insertions, 35 deletions
diff --git a/Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex b/Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex
index e98a23877d4..5f96164e92b 100644
--- a/Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex
+++ b/Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex
@@ -156,9 +156,9 @@ die genau wissen, aus welchen Gründen dies geschehen soll.
\subsection{Lokale Installation von \TUDScript unter Windows}
\index{Installation!Nutzerinstallation}\index{Nutzerinstallation (lokal)}
-Für eine lokale Nutzerinstallation sowohl des \TUDScript-Bundles als auch der
-dazugehörigen Schriften für die Distributionen \Distribution{\hologo{TeX}~Live}
-oder \Distribution{\hologo{MiKTeX}} werden neben Schriftarchiven die Dateien aus
+Für eine lokale Nutzerinstallation des \TUDScript-Bundles und der dazugehörigen
+Schriften für die Distributionen \Distribution{\hologo{TeX}~Live} oder
+\Distribution{\hologo{MiKTeX}} werden neben den Schriftarchiven die Dateien aus
\hrfn{https://github.com/tud-cd/tudscr/releases/download/\vTUDScript/TUD-KOMA-Script\_\vTUDScript\_Windows\_full.zip}%
{\File*{TUD-KOMA-Script\_\vTUDScript\_Windows\_full.zip}} benötigt. Vor der
Verwendung des Skripts \File{tudscr\_\vTUDScript\_install.bat} sollte
@@ -173,25 +173,26 @@ Verzeichnis befinden:
\item[\File{DIN\_Bd\_PS.zip}]Archiv mit Schriftdateien für \DIN
\item[\File{tudscrfonts.zip}]Archiv mit Metriken für die
Schriftinstallation via \Package{fontinst}
- \item[\File{7za.exe}]Stand-Alone-Version von 7-zip zum Entpacken der Archive%
- \footnote{%
- Windows stellt keine Bordmittel zum Extrahieren von Archiven auf
- Kommandozeilen-/Skript-Ebene zur Verfügung.%
- }%
\end{description}
%
Beim Ausführen des Installationsskripts werden alle Schriften in das lokale
Nutzerverzeichnis der jeweiligen Distribution installiert, falls kein anderes
Verzeichnis explizit angegeben wird. Für Hinweise bei Problemen mit der
-Schriftinstallation sei auf \autoref{sec:install:fonts:win} verwiesen.
+Schriftinstallation sei auf \autoref{sec:install:win} verwiesen.
+\Attention{%
+ Wird die \hologo{LaTeX}"=Distribution \Distribution{\hologo{MiKTeX}} genutzt,
+ sollte in jedem Fall vor der Ausführung der Installationsskripte ein Update
+ der Distribution durchgeführt werden. Andernfalls wird es unter Umständen im
+ Installationsprozess oder bei der Nutzung von \TUDScript zu Problemen kommen.
+}
\subsection{Lokale Installation von \TUDScript unter Linux und OS~X}
\index{Installation!Nutzerinstallation}\index{Nutzerinstallation (lokal)}
-Für eine lokale Nutzerinstallation sowohl des \TUDScript-Bundles als auch der
-dazugehörigen Schriften für die Distributionen \Distribution{\hologo{TeX}~Live}
-oder \Distribution{Mac\hologo{TeX}} werden neben Schriftarchiven die Dateien aus
+Für eine lokale Nutzerinstallation des \TUDScript-Bundles und der dazugehörigen
+Schriften für die Distributionen \Distribution{\hologo{TeX}~Live} oder
+\Distribution{Mac\hologo{TeX}} werden neben den Schriftarchiven die Dateien aus
\hrfn{https://github.com/tud-cd/tudscr/releases/download/\vTUDScript/TUD-KOMA-Script\_\vTUDScript\_Unix\_full.zip}%
{\File*{TUD-KOMA-Script\_\vTUDScript\_Unix\_full.zip}} benötigt. Vor der
Verwendung des Skripts \File{tudscr\_\vTUDScript\_install.sh} sollte
@@ -211,7 +212,7 @@ Verzeichnis befinden:
%
Beim Ausführen des Installationsskripts werden alle Schriften in das lokale
Nutzerverzeichnis der jeweiligen Distribution installiert. Für Hinweise bei
-Problemen mit der Schriftinstallation sei auf \autoref{sec:install:fonts:unix}
+Problemen mit der Schriftinstallation sei auf \autoref{sec:install:unix}
verwiesen.
@@ -254,42 +255,108 @@ empfohlen.
\begin{Declaration*}{\Class{tudscrbookold}}
\begin{Declaration*}{\Class{tudscrreprtold}}
\begin{Declaration*}{\Class{tudscrartclold}}
-\index{Update!Version v1.0}%
-\index{Hauptklassen}
-\index{Version!v1.0}%
%
-Ist \TUDScript in der veralteten und obsoleten Version~v1.0 installiert, so
-wird dringend zu einer Deinstallation dieser geraten. Dafür werden die Skripte
+Ist \TUDScript in der veralteten Version~v1.0 installiert, so wird dringend zu
+einer Deinstallation geraten. Andernfalls wird es zu Problemen kommen. Dafür
+werden die Skripte
\hrfn{https://github.com/tud-cd/tudscr/releases/download/uninstall/tudscr\_uninstall.bat}{\File{tudscr\_uninstall.bat}}
respektive
\hrfn{https://github.com/tud-cd/tudscr/releases/download/uninstall/tudscr_uninstall.sh}{\File{tudscr\_uninstall.sh}}
-bereitgestellt. Andernfalls wird es zu Problemen kommen. Die aktuelle
-Version~\vTUDScript{} kann nach der Deinstallation der Version~v1.0 wie unter
-\autoref{sec:install} beschrieben installiert werden.
+bereitgestellt. Die aktuelle Version~\vTUDScript{} kann nach der Deinstallation
+wie in \autoref{sec:install} beschrieben installiert werden.
Möchten Sie die obsoleten \TUDScript-Klassen in der Version~v1.0 nach einer
Aktualisierung weiterhin nutzen, so müssen diese nach der Deinstallation neu
-installiert werden. Dafür kann das Archiv
+installiert werden. Dafür steht das Archiv
\hrfn{https://github.com/tud-cd/tudscrold/releases/download/v1.0/TUD-KOMA-Script_v1.0old.zip}%
-{\File*{TUD-KOMA-Script\_v1.0old.zip}} verwendet werden, welches sowohl die
-genannten Skripte zur Deinstallation als auch die zur neuerlichen Installation
-der veralteten Klassen benötigten \File{tudscr\_v1.0old\_install.bat} oder
+{\File*{TUD-KOMA-Script\_v1.0old.zip}} bereit, welches sowohl die genannten
+Skripte zur Deinstallation als auch die zur neuerlichen Installation der
+veralteten Klassen benötigten \File{tudscr\_v1.0old\_install.bat} oder
\File{tudscr\_v1.0old\_install.sh} enthält. Nach Abschluss des Vorgangs sind
die alten Klassen der Version~v1.0 mit \Class{tudscrbookold},
-\Class{tudscrreprtold} und \Class{tudscrartclold} verwendbar und können
-parallel zur aktuellen Version~\vTUDScript{} genutzt werden.
+\Class{tudscrreprtold} und \Class{tudscrartclold} parallel zur aktuellen
+Version~\vTUDScript{} verwendbar.
Im Vergleich zur Version~v1.0 hat sich an der Benutzerschnittstelle nicht sehr
viel verändert. Treten nach dem Umstieg auf die Version~\vTUDScript{} dennoch
Probleme auf, sollte der Anwender als erstes in die Beschreibung des Paketes
-\Package{tudscrcomp}'full' sehen,welches eine Schnittstelle bereitstellt, mit
-der es möglich ist, alte und ursprünglich nicht mehr vorgesehene Befehle sowie
-Optionen dennoch zu nutzen. Allerdings werden einige von diesen auch durch das
-Paket \Package{tudscrcomp} nicht mehr bereitgestellt. Aufgeführt sind diese in
-\autoref{sec:obsolete}. Sollten trotz aller Hinweise in besagtem
-\autorefname[sec:obsolete] dennoch Fehler oder Probleme beim Umstieg auf
-die neue \TUDScript-Version auftreten, ist eine Meldung im Forum die beste
-Möglichkeit, um Hilfe zu erhalten.
+\Package{tudscrcomp}'full'(tudscr) sehen, welches eine Schnittstelle zur
+Nutzung alter und ursprünglich nicht mehr vorgesehener Befehle sowie Optionen
+bereitstellt. Allerdings werden einige von diesen auch durch das Paket
+\Package{tudscrcomp}(tudscr) nicht mehr bereitgestellt. Aufgeführt sind diese
+in \autoref{sec:obsolete}. Sollten trotz aller Hinweise dennoch Fehler oder
+Probleme beim Umstieg auf die neue \TUDScript-Version auftreten, ist eine
+Meldung im \Forum die beste Möglichkeit, um Hilfe zu erhalten.
\end{Declaration*}
\end{Declaration*}
\end{Declaration*}
+
+
+
+\section{Installationshinweise für portable Installationen}
+\label{sec:install:portable}
+
+Prinzipiell ist die Installation der PostScript-Schriften bei der Nutzung von
+\Distribution{\hologo{TeX}~Live~Portable}|?| beziehungsweise
+\Distribution{\hologo{MiKTeX}~Portable}|?| äquivalent zur nicht-portablen
+Variante, welche in \autoref{sec:install} beschrieben wird. Alle dort gegebenen
+Hinweise sollten sorgfältig berücksichtigt werden. Darüberhinaus ist bei
+\Distribution{\hologo{MiKTeX}~Portable} darauf zu achten, den Installationspfad
+nicht unbedingt auf der obersten Verzeichnisebene des externen Speichermediums
+zu wählen.
+Zur Installation der Schriften des \CDs wird das Archiv
+\hrfn{https://github.com/tud-cd/tudscr/releases/download/fonts/TUD-KOMA-Script_fonts_Windows.zip}%
+{\File*{TUD-KOMA-Script\_fonts\_Windows.zip}} benötigt. Dieses kann entweder
+auf der lokalen Festplatte oder auf dem externen Speichermedium entpackt
+werden. Danach wird folgendes Vorgehen empfohlen:
+
+\minisec{\NoCaseChange{\hologo{TeX}}~Live~Portable}
+Das folgende Vorgehen wurde mit Windows getestet. Empfehlungen für die portable
+Installation für unixoide Betriebssysteme können gerne an \Email{\tudscrmail}
+gesendet werden.
+\begin{enumerate}
+\item Installation von \Distribution{\hologo{TeX}~Live~Portable} in den Pfad
+ \Path{\PName{Laufwerk}:\textbackslash texlive}
+\item Die Datei \File{tl-tray-menu.exe} im Installationspfad öffnen
+\item Im Infobereich der Taskleiste mit einem Rechtsklick auf das Symbol von
+ \Distribution{\hologo{TeX}~Live~Portable} das Kontextmenü öffnen und ein
+ Update entweder über die grafische Oberfläche (\emph{Package Manager}) oder
+ die Kommandozeile (\emph{Command Prompt}) durchführen
+\item Über das Kontextmenü die Kommandozeile starten und über diese das
+ Installationsskript für die Schriften \File{tudscrfonts\_install.bat}
+ ausführen. Der voreingestellte Installationspfad kann im Normalfall so
+ belassen werden. Wird dieser geändert, so sollte dieser sich logischerweise
+ auf dem externen Speichermedium befinden.
+ \Attention{%
+ Ein Ausführen ohne die über \Distribution{\hologo{TeX}~Live~Portable}
+ geöffnete Kommandozeile führt zu Fehlern.
+ }%
+\end{enumerate}
+
+\minisec{\NoCaseChange{\hologo{MiKTeX}}~Portable}
+\begin{enumerate}
+\item Installation von \Distribution{\hologo{MiKTeX}~Portable} in den Pfad
+ \Path{\PName{Laufwerk}:\textbackslash LaTeX\textbackslash MiKTeXportable}
+\item Die Datei \File{miktex-portable.cmd} im Installationspfad öffnen
+\item Im Infobereich der Taskleiste mit einem Rechtsklick auf das Symbol von
+ \Distribution{\hologo{MiKTeX}~Portable} das Kontextmenü öffnen und ein Update
+ durchführen
+\item Über das Kontextmenü die Kommandozeile starten und über diese das
+ Installationsskript für die Schriften \File{tudscrfonts\_install.bat}
+ ausführen. Der voreingestellte Installationspfad kann im Normalfall so
+ belassen werden. Wird dieser geändert, so sollte dieser sich logischerweise
+ auf dem externen Speichermedium befinden. Bei diesem Schritt werden die
+ Pakete \Package{fontinst}, \Package{cmbright} und \Package{iwona} unter
+ Umständen nachinstalliert.
+ \Attention{%
+ Ein Ausführen ohne die über \Distribution{\hologo{MiKTeX}~Portable}
+ geöffnete Kommandozeile führt zu Fehlern.
+ }%
+\item Bei der erstmaligen Verwendung einer der \TUDScript-Dokumentklassen
+ werden die Pakete \Package{tudscr}, \Package{koma-script},
+ \Package{etoolbox}, \Package{textcase}, \Package{environ},
+ \Package{trimspaces}, \Package{xcolor}, \Package{mptopdf}() durch
+ \Distribution{\hologo{MiKTeX}~Portable} nachinstalliert, falls diese nicht
+ schon vorhanden sind und die automatische Nachinstallation von Paketen
+ aktiviert ist.
+\end{enumerate}