diff options
author | Karl Berry <karl@freefriends.org> | 2015-07-02 22:12:17 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-07-02 22:12:17 +0000 |
commit | 586aedcf63ecf6ea7da1c1529e5ea5ba8f5cb426 (patch) | |
tree | b679941add6df7f6b1ee8c135b24181f992dcb65 /Master/texmf-dist/source/latex/tudscr/doc/tudscr-installation.tex | |
parent | fecdcd43eaa7f73e830159293fe22a202803086b (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.tex | 137 |
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} |