Diskussion zu: "Tip: Fehlersuche"

Druckbare Version

40 Beiträge dieses Themas auf einer Seite anzeigen

04-04-2010, 18:28
rais

Moin Xenara,

Zitat:

Zitat von Xenara

Es war durchaus Absicht, \usepackage{filecontents} mir reinzunehmen, _damit_ es überschrieben wird. [...]

ah, Ok.
Konsequent wäre dann, \usepackage{filecontents} einkommentiert zu lassen.;-)

Zitat:

Zitat von lockstep

An dieser Stelle sollte wohl auch makeindex erwähnt werden. Formulierungsvorschlag: "Ähnliches gilt für die Erstellung von Stichwortverzeichnissen, Glossaren und Abkürzungsverzeichnissen: Hier muss auch mit makeindex kompiliert werden - wie oft und in welcher Reihenfolge, entnimmst du den Dokumentationen zu den jeweiligen Verzeichnissen."

vllt
"Ähnliches gilt für die Erstellung von Stichwortverzeichnissen, Glossaren und Abkürzungsverzeichnissen: Hier muss meistens auch mit makeindex kompiliert werden -- wie oft, in welcher Reihenfolge und womit (wenn überaupt) genau, entnimmst du den Dokumentationen zum jeweiligen Paket, mit dem du das entsprechende Verzeichnis erstellen willst."

Bei Verwendung von acronym käme man ohne makeindex aus (und muß dafür selbst für die Sortierung sorgen), bei glossaries wird eigentlich das paketeigene makeglossaries-Skript empfohlen (und auch xindy oder makeindex erwähnt) und bei gloss wird BibTeX für die Sortierung verwendet.

Frohe Ostern
04-04-2010, 18:44
lockstep

@rais: Danke für den Hinweis! Mir war zwar bewusst, dass Pakete wie glossaries oder splitidx mit eigenen Skripten arbeiten (die MakeIndex/xindy mehrfach und/oder mit speziellen Parametern aufrufen), ich hatte es jedoch für vorrangig gehalten, MakeIndex überhaupt zu erwähnen. Angesichts der Arbeitsweise der Pakete acronym und gloss ist deine Formulierung sicher besser als meine.

lockstep
04-04-2010, 19:45
Xenara

Habs entsprechend abgeändert.

(Mal sehen, ob das Ding jemals absolut perfekt wird :D )
04-04-2010, 20:06
rais

Naja, für mich ist `Perfektion' analog zu einer e-Funktion, bei der das `Ziel' nie erreicht wird.;-)

MfG
22-06-2010, 09:57
Xenara

Hab noch einen Absatz eingefügt "Reihenfolge der Pakete überprüft?", vor allem in Hinblick auf hyperref.
22-06-2010, 10:43
lockstep

Der Hinweis auf hyperref ist essenziell! Hinzufügen könnte man noch - falls du das für wichtig genug hältst - folgendes (nach "(direkt vor \begin{document})"):

"Wichtigste Ausnahme (nach hyperref laden!) ist das Paket glossaries."

lockstep
22-06-2010, 10:59
Xenara

Danke für den Hinweis, ich habe es etwas umformuliert eingebaut.
22-06-2010, 13:36
voss

Zitat:

Zitat von Xenara

Danke für den Hinweis, ich habe es etwas umformuliert eingebaut.

es wäre besser, hier auf die README des hyperref-Pakets hinzuweisen,
in der alle bekannten Pakete aufgelistet werden, die mit
hyperref zusammenarbeiten und deren Ladereihenfolge dort angegeben
ist.

Herbert
22-06-2010, 14:19
lockstep

Das Paket glossaries wird allerdings in der hyperref-README nicht erwähnt. (Diese stammt aus März 2010, die glossaries-Einführung mit dem hyperref-Ladehinweis aus Mai 2010.)

lockstep
22-06-2010, 15:09
voss

Zitat:

Zitat von lockstep

Das Paket glossaries wird allerdings in der hyperref-README nicht erwähnt. (Diese stammt aus März 2010, die glossaries-Einführung mit dem hyperref-Ladehinweis aus Mai 2010.)

dann sollte man Heiko entsprechend darauf hinweisen!

Herbert
23-06-2010, 07:21
Xenara

Zitat:

Zitat von voss

es wäre besser, hier auf die README des hyperref-Pakets hinzuweisen, in der alle bekannten Pakete aufgelistet werden, die mit
hyperref zusammenarbeiten und deren Ladereihenfolge dort angegeben
ist.

Ok, ist entsprechend umformuliert und ich hab wieder was gelernt. Aber wieso steht das in der README und nicht in der eigentlichen Doku? Auf die Idee, in einer README zu suchen, wäre ich pesönlich nicht gekommen.
23-06-2010, 07:27
sommerfee

Ich mag dem Hinweis "So muss etwa das häufig verwendete Paket "hyperref" in 95% der Fälle als allerletztes Paket direkt vor "\begin{document}" geladen werden." nicht zustimmen.

Es ist zwar richtig, daß hyperref - von Ausnahmen abgesehen - als letztes Paket geladen werden sollte, allerdings nicht direkt vor \begin{document}. Ganz im Gegenteil, in der Regel müssen die Makros der anderen Pakete NACH dem Laden von hyperref angewandt werden.

Beispiel "float-hyperref": Die richtige Reihenfolge ist \usepackage{float} - \usepackage{hyperref} - \newfloat{...}

Beispiel "chngcntr-hyperref": Die richtige Reihenfolge ist \usepackage{chngcntr} - \usepackage{hyperref} - \counterwithin{figure}{...}"

usw.

Der Grund sollte einleuchtend sein: Mit \usepackage{xyz} stellt das Paket xyz seine Makros bereit. Mit \usepackage{hyperref} patcht hyperref einige dieser Makros, wie z.B. \newfloat, \counterwithin usw. Erst danach sollten die (von hyperref gepatchten) Befehle angewandt werden.

Liebe Grüße,
Axel
23-06-2010, 07:38
Xenara

Nächster Versuch der Formulierung ;)

Und weitergehende Frage: Könnte man dann eigentlich pauschal sagen, dass als erstes alle usepackages geladen werden müssen, und anschliessend erst die ganzen Makros wie (re)newcommands, counterwithins, newfloats?

In manchem Code stehen die Makros direkt nach dem Paket, was insofern sinnvoll ist, dass alles, was zum Paket gehört, beisammen ist. Sollte man das dann auf jeden Fall vermeiden?
24-06-2010, 06:46
sommerfee

Zitat:

Zitat von Xenara

Und weitergehende Frage: Könnte man dann eigentlich pauschal sagen, dass als erstes alle usepackages geladen werden müssen, und anschliessend erst die ganzen Makros wie (re)newcommands, counterwithins, newfloats?

Wenn man hyperref lädt oder vorhat, es später mal hinzuzufügen, wäre es IMHO eine gute Idee. Wenn man nicht durchschaut, welches Kommando von welchem Paket (oder gar dem Kernel) hyperref genau warum patcht (und wer tut das schon außer Heiko Oberdiek ;) ), wäre man IMHO so zumindest auf der sichereren Seite, als wenn man es nicht so macht. "Bullet Proof" ist aber aber (natürlich) nicht.

Zitat:

In manchem Code stehen die Makros direkt nach dem Paket, was insofern sinnvoll ist, dass alles, was zum Paket gehört, beisammen ist. Sollte man das dann auf jeden Fall vermeiden?

Ich zumindest mache das so. Für die Beantwortung "Sollte man das denn auf jeden Fall vermeiden?" fühle ich mich nicht kompetent genug, ich kenne auch nur diejenigen hyperref-Internata, die im Zusammenhang mit floats/captions stehen. Ich würde aber mit "ja" antworten, wenn da "in der Regel" statt "auf jeden Fall" stehen würde.

Liebe Grüße,
Axel

P.S.: Die englischsprachige TeX-FAQ empfiehlt auch diese Vorgehensweise:

http://www.tex.ac.uk/cgi-bin/texfaq2...l=hyperdupdest
12-07-2010, 13:54
Loomis

Tips

Vielen Dank für deine umfassenden Tips und Mühen, damit kann man sicherlich eine ganze Menge anfangen.
Nur ein Kommentar: ich arbeite seit knapp 2 Jahren mit dem TeXnicCenter und hab auch alles mal besser, mal schlechter allein bearbeiten können.
Jetzt habe ich mir leider das BuKoMa-Programm "aufschwatzen" lassen. - und seit dies geladen ist, funktioniert nichts mehr richtig. Bereinige ich einen "Error", kommt der nächste oder das Programm bricht ein.
Da lohnen alle Tips nichts mehr oder irgendwelche Fragen ins Forum zu stellen-ich käme aus der Fragerei gar nicht mehr heraus.
Mein altes File kann nicht mal mehr meine Grafiken lesen und bei den Bibl-Eintragungen gibt es Fehlermeldungen, die gar keine sind. Daraufhin kann man dann bei BuKoMa keine Einträge mehr machen usw. - ein Disaster!
Ich kann also nur allen von BuKoMa abraten!!
Gruß!
Angela

[Edit:Bischi]Post hierher verschoben[/Edit]
10-09-2010, 07:31
sommerfee

Mir ist gerade aufgefallen:

Zitat:

Hinweise und Tipps

a) Bilder:
Anstatt \includegraphics{Dein-Bild} verwendest Du bitte \rule{x}{y}, welches einen schwarzen Kasten einfügt.

Einfacher wäre es vielleicht, dem graphicx-Paket die Option "demo" zu geben.
Mit

Code:

\PassOptionsToPackage{demo}{graphicx}

am Anfang des Dokumentes zeigt das auch in den Fällen Wirkung, wo graphicx nicht selber, sondern in der Dokumentenklasse (z.B. beamer) bzw. durch ein Paket geladen wird.

Liebe Grüße,
Axel
10-09-2010, 07:46
Xenara

Hallo Axel,

stimmt, die demo-Option gibts auch noch. Ich nehmen sie gerne in die Anleitung mit auf, aber was mir nach wie vor nicht klar ist: Wie werden die Maße des "Bildes" bestimmt, wenn es jemand kompiliert, der das Bild eben nicht hat? Denn wenn es mit "scale=.5" oder "width=.3\textwidth" sind das ja keine Absolutwerte.

Den Vorteil von \rule sehe ich darin, dass der Fragesteller Maße wählen kann, die dem eigentlichen Bild nahekommen. (Und es ist ein Paket weniger nötig.)

Viele Grüsse,
Xenara
10-09-2010, 07:59
voss

Zitat:

Zitat von Xenara

stimmt, die demo-Option gibts auch noch. Ich nehmen sie gerne in die Anleitung mit auf, aber was mir nach wie vor nicht klar ist: Wie werden die Maße des "Bildes" bestimmt, wenn es jemand kompiliert, der das Bild eben nicht hat? Denn wenn es mit "scale=.5" oder "width=.3\textwidth" sind das ja keine Absolutwerte.

Den Vorteil von \rule sehe ich darin, dass der Fragesteller Maße wählen kann, die dem eigentlichen Bild nahekommen. (Und es ist ein Paket weniger nötig.)

Die Option demo war von mir vorrangig für den Fall vorgesehen,
wo der Fragesteller vergessen hat, seine Abbildung zur Verfügung zu stellen. demo berücksichtigt alle Angaben, die sich auf eine physikalische Größen beziehen. Alle relativen Größen, wie scale, beziehen sich auf die interne Vorgabe von \rule{..}{...}

Herbert
10-09-2010, 08:53
Xenara

Ok, hab [demo] mit eingebaut, \rule aber als Alternative trotzdem mal noch dringelassen.
11-10-2010, 19:22
sommerfee

Wollte nur einen dicken Dank an Xenara loswerden!

Ich versende den Link zum Thread gerne per E-Mail in (passenden) Supportfällen, und wenn der Empfänger es dann nicht ließt, bin ich ihn trotzdem häufig als Supportfall los! :D

40 Beiträge dieses Themas auf einer Seite anzeigen