1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
|
<html>
<head><title>Hilfe zur TeXShell (Startbild)</title>
</head>
<body>
<a name="main">
<h1>TeXShell (J. Pnisch)</h1>
</a>
Mit folgenden Tasten bewegen Sie sich durch die Hilfe:
<dl>
<code><dt>Tab</code>
<dd> Nchsten Verweis anwhlen
<code><dt>Shift-Tab</code> <dd>Vorigen Verweis anwhlen
<code><dt>Enter</code> <dd>Verweis anspringen
<code><dt>Page-Up</code> <dd>Zurck blttern
<code><dt>Page-Down</code> <dd>Vorwrts blttern
<code><dt>i</code> <dd>Hilfe-Index
<code><dt>m</code> <dd>Anfangsfenster (Main)
<code><dt>Ctrl-c</code> <dd>Beispiel in den Paste-Buffer kopieren
<code><dt>Escape</code> <dd>Hilfe verlassen
</dl>
<p>
Hilfe ist zu folgenden Punkten verfgbar:
<ul>
<li><a href="#call">Aufruf</a>
<li><a href="#steps">Arbeitsweise</a>
<li><a href="tedit.html#main">TeX-Editor</a>
<li><a href="#keys">Tastenbelegung</a>
<li><a href="#config">Einstellungen</a>
<li><a href="#globopt">Globale Einstellungen</a>
<li><a href="#template">Dokumentvorlagen</a>
<li><a href="latex/index.html">LaTeX-Syntax (engl.)</a>
<li><a href="#files">Konfigurationsfiles</a>
<li><a href="#project">Projektverwaltung</a>
</ul>
<a name="call">
<h1>Aufruf</h1>
</a>
Die TeXShell wird mit dem Kommando
<pre>
ts [primaerfile]
</pre>
gestartet. Enthlt der Filename keine Punkte, wird die Extension .tex
automatisch angehngt. Enthlt der Filename Punkte, z.B. a.b.c.tex,
dann darf die Extension nicht weggelassen werden!
<p>
-> <a href="#main">Anfangsbild</a>
<a name="steps">
<h1>Vorgehen bei der Arbeit mit der TeXShell</h1>
</a>
<ol>
<li> Primrfile mit <code>F13</code> bzw. <code>Shift-F3</code> auswhlen
<li> Primrfile mit <code>Alt-0</code> bearbeiten
<li> Weitere Files knnen mit <code>F3</code> parallel bearbeitet werden, die
Umschaltung erfolgt mit <code>Alt-Nummer</code>.
<li> Primrfile mit <code>F6</code> bersetzen. Bei Fehlern wird beim Drcken
von <code>e</code> automatisch der Editor aufgerufen.
<li> Anzeige des DVI-Files mit <code>F8</code>. Wurde der Betrachter nicht
im Hintergrund gestartet (siehe dazu <a href="#config">Einstellungen</a>),
so mu er vor dem nchsten Arbeitsschritt beendet werden.<br>
Bentigt der Betrachter ein PostScript-File, so wird dieses automatisch
erzeugt (sofern <code>dvips</code> vorhanden ist).
<li> Ausdruck des DVI-Files mit <code>F9</code>. Der Dialog wird mit
<code>Ctrl-Enter</code> beendet, das Umschalten zwischen den Feldern
geschieht mit <code>Tab</code>. Nur die Optionen,
die der Druckertreiber versteht, werden wirksam.
<li> Arbeit mit <code>Alt-x</code> beenden.
</ol>
-> <a href="#main">Anfangsbild</a>
<a name="keys">
<h1>Tastenbelegung der TeXShell</h1>
</a>
<dl>
<code><dt>F1</code>
<dd> Hilfe
<code><dt>Shift-F3, F13</code>
<dd> Primrfile auswhlen, das Arbeitsverzeichnis wird gewechselt
<code><dt>F3</code>
<dd> Editorfenster ffnen, vorher Fileauswahl
<code><dt>Alt-0</code>
<dd> Primrfile editieren
<code><dt>Alt-1 ... Alt-9</code>
<dd> Editor fr File 1...9 auswhlen (nur interner Editor)
<code><dt>F4</code>
<dd> Projektfenster ffnen
<code><dt>F5</code>
<dd> Graphikeditor starten
<code><dt>F6</code>
<dd> bersetzen des Dokumentes
<code><dt>F7</code>
<dd> Bearbeiten von Referenzen (Index, Bibliographie)
<code><dt>F8</code>
<dd> Betrachter
<code><dt>F9</code>
<dd> Drucken
<code><dt>F11</code>
<dd> Hilfsprogramme
<code><dt>Alt-F5</code>
<dd> Logfenster anzeigen (zurck mit <code>Alt-#</code>)
<code><dt>Ctrl-F2...Ctrl-F10</code>
<dd> Auswahl und Einstellungen des entsprechenden Programmes
<code><dt>Alt-x</code>
<dd> Beenden
</dl>
<p>
-> <a href="#dlgkeys">Dialogtasten</a><br>
-> <a href="#teditkeys">Tastenbelegung des Editors</a><br>
-> <a href="#main">Anfangsbild</a>
<a name="dlgkeys">
<h1>Tastenbelegung der Dialoge</h1>
</a>
<dl>
<code><dt>Tab, Enter</code>
<dd> Nchstes Feld
<code><dt>Shift-Tab</code>
<dd> Voriges Feld
<code><dt>Ctrl-Enter</code>
<dd> OK
<code><dt>Escape</code>
<dd> Abbruch
<code><dt>Alt-[Buchstabe]</code>
<dd> Auswahl der Aktion mit dem geklammerten Buchstaben
</dl>
<p>
Im Filedialog wird mit der <code>Enter</code>-Taste der Dialog
abgeschlossen, wenn eine Datei ausgewhlt wurde.
Ist in einem Filedialog eine File-Extension spezifiziert, so wird diese
automatisch an den Filenamen angehngt, falls dieser nicht schon eine
hat.
<p>
-> <a href="#main">Anfangsbild</a>
<a name="config">
<h1>Einstellungen fr die Aktionen</h1>
</a>
Mit <code>Ctrl-Funktionstaste</code> wird das Einstellungsmen fr die
entsprechende Aktion gewhlt. Aktionen knnen mit mit <code>Alt-i</code>
oder <code>Alt-a</code> hinzugefgt
und mit <code>Alt-e</code> bearbeitet werden:
<dl>
<strong><dt>Name</strong>
<dd> Kurzer Name fr die Aktion
<strong><dt>Exec Proc</strong>
<dd> Tcl-Prozedur fr die Programmausfhrung:
<dl>
<code><dt>exwin</code>
<dd> Programm luft im Systemfenster ab
<code><dt>exbg</code>
<dd> Programm luft im Hintergrund
<code><dt>tedit</code>
<dd> Interner Editor
</dl>
<strong><dt>Options</strong>
<dd> Optionen fr das Programm, beginnend mit dem Name des zu startenten
Programms bei <code>exwin</code> und <code>exbg</code>.
Diese Zeile kann <a href="#varparams">variable Parameter</a>
fr den Dateinamen, Druckoptionen etc. enthalten.<br>
Sollen Pipes verwendet werden, mu die Programmausfhrung
ber eine Shell erfolgen:<br>
Bsp. Anzeige Logfile: <code>sh -c "cat %p.log | more"</code>
</dl>
<p>
-> <a href="#varparams">Variable Parameter</a><br>
-> <a href="#main">Anfangsbild</a>
<a name="varparams">
<h1>Variable Parameter fr den Programmruf</h1>
</a>
Variable Parameter sind in Dialogen eingegebene oder ausgewhlte Werte,
die beim Programmaufruf bergeben werden mssen. Einige Werte wie
z.B. der Primrfilename mssen immer in der Aufrufzeile stehen, andere
wie z.B. die Option fr Landscape-Druck sollen nur manchmal gesetzt werden.
<p>
%-Parameter werden von der TeXShell stets gesetzt.
<p>
!?...! enthalten Optionen, die nur dann an das Programm bergeben werden,
wenn diese auch bentigt werden. Ein enthaltenes %-Zeichen steht fr einen
bergebenen Wert. Fehlt der Parameter in der Option-Zeile, ist die gewnschte
Option nicht wirksam.
<dl>
<code><dt>%p</code>
<dd> Primrfile (Voller Dateiname). Wenn nicht vorhanden, wird das zuletzt
editierte File benutzt.
<code><dt>%r</code>
<dd> Primrfile-Rootname. Alles ab dem letzten Punkt des Dateinamens wird
abgeschnitten (z.B. "xdvi %r.dvi" oder "xdvi %r").
<code><dt>%e</code>
<dd> Editorfile (Voller Name), wird im Dialog eingegeben. Standardextension
ist .tex und kann im Filedialog gendert werden.
<code><dt>%o</code>
<dd> Sonstiges File (Rootname), wird im Dialog eingegeben. Eine
Extension mu angegeben werden, z.B. <code>"xfig %o.fig"</code>.
<code><dt>%g</code>
<dd> Von ts berechnete Geometry, die fr das zu erzeugende Fenster
verwendet werden kann: <code>"xfig -geometry %g %o.fig"</code>.
<code><dt>!i..%..!</code>
<dd> Option fr die Zeilenauswahl im Editor, das %-Zeichen steht fr die
Zeilennummer
<code><dt>!0..%..!</code>
<dd> Erste auszugebende Seite, % steht fr die Seitennummer
<code><dt>!9..%..!</code>
<dd> Letzte auszugebende Seite, % steht fr die Seitennummer
<code><dt>!l...!</code>
<dd> Landscapeausdruck
<code><dt>!o...!</code>
<dd> Nur ungerade Seiten ausgeben
<code><dt>!e...!</code>
<dd> Nur gerade Seiten ausgeben
</dl>
<p>
-> <a href="#main">Anfangsbild</a>
<a name="globopt">
<h1>Globale Einstellungen</h1>
</a>
Der Dialog fr die globalen Einstellungen wird ber das Men
<code>Options|Global settings ...</code> aufgerufen.
<dl>
<code><dt>Fensterposition</code>
<dd> Der Dialog zeigt die aktuelle Position des Hauptfensters
(ohne Dekoration) an. Dieser Wert kann auf Wunsch verndert
werden. Nach Besttigung des Dialogs werden Haupt- und
Terminalfenster auf diesen Wert positioniert. Dieser
Wert wird auch bei Programmende gespeichert und beim
Neustart wiederverwendet.
<code><dt>Editoroptionen</code>
<dd> Es knnen automatischer Zeilenumbruch, Automatisches
Speichern und das Intervall fr die Autospeicherung
eingestellt werden.
</dl>
<p>
-> <a href="#main">Anfangsbild</a>
<a name="template">
<h1>Dokumentvorlagen (Templates)</h1>
</a>
Fr h"aufig benutzte Dokumentstrukturen knnen Vorlagen erstellt werden.
Dazu werden im globalen Templateverzeichnis bzw. unter <code>$HOME/.ts</code>
LaTeX-Vorlagen mit der Dateierweiterung .tpl nach folgendem Muster erstellt:
<pre>
%! Beschreibung der Vorlage
%! Anfangszeile des Cursors beim Editieren (ohne Vorspann gezhlt)
Dokumentvorlage (Zeile 1)
...
</pre>
Beim ffnen eines neuen Primrfiles zum Editieren werden die vorhandenen
Vorlagen angeboten. Neu erstellte Vorlagen mssen mittels <code>Rescan</code>
eingebunden werden.
<p>
-> <a href="#main">Anfangsbild</a>
<a name="files">
<h1>Dateien</h1>
</a>
Es gibt globale und lokale (nutzerbezogene) Konfigurationsfiles. Das
Verzeichnis der globalen Files wird bei der Installation im Makefile
festgelegt (Voreinstellung: <code>/usr/local/lib/ts</code>, bei
S.u.S.E. <code>/usr/lib/ts</code>). Die lokalen Files befinden sich
unter <code>$HOME/.ts</code>.
<h2>Globale Dateien</h2>
<dl>
<code><dt>texshell.cfg</code>
<dd>Globales Konfigurationsfile, das beim ersten Aufruf verwendet wird.
Beim Verlassen des Programms wird ein Nutzerkonfigurationsfile erzeugt.
<p>
Soll das globale Konfigurationsfile verndert werden, nimmt man am
besten als Nutzer alle ntigen Vernderungen vor und berschreibt
nach Verlassen des Programms das globale File mit dem
Nutzerkonfigurationsfile.
<code><dt>help/*.html</code>
<dd>Help files in HTML 2.0. Die Sprache wird bei der Installation ausgewhlt.
Nutzerabhngige Sprachauswahl wird derzeit nicht untersttzt.
<code><dt>templates/*.tpl</code>
<dd>Globale Dokumentvorlagen. Jeder Nutzer kann diese auswhlen und
verwenden.
</dl>
<h2>Lokale Dateien</h2>
<dl>
<code><dt>ts.cfg</code>
<dd>Konfigurationsfile des Nutzers. Wenn nicht verndert, ist es eine
Kopie des globalen Konfigurationsfiles.
<code><dt>templates.idx</code>
<dd>Index der Dokumentvorlagen (global und lokal). Es wird beim ersten
Programmaufruf angelegt. Nach dem Anlegen neuer Dokumentvorlagen
mssen diese ber den Schalter <code>Rescan</code> der Templateauswahl
in den Index aufgenommen werden.
<code><dt>*.tpl</code>
<dd>Nutzerspezifische Dokumentvorlagen.
<code><dt>includes.cfg</code>
<dd>Scanmuster fr eingebundene Dateien
<code><dt>apps.cfg</code>
<dd>Editoren fr spezielle Dateitypen (noch nicht fertig)
</dl>
<p>
-> <a href="#main">Start</a>
<a name="project">
<h1>Projektverwaltung</h1>
</a>
Mit dem Drcken von <code>F4</code> wird das Projektfenster geffnet, was
die Dateistruktur des Projekts darstellt. Der Scanproze wird mit der Datei
<code>includes.cfg</code> gesteuert.
<p>
Das erste Zeichen einer Zeile zeigt an, ob die gefundene Datei rekursiv
gescannt wird oder nicht, das zweite Zeichen ist ein Leerzeichen.
Der Rest der Zeile enthlt den regulren Ausdruck, wobei die erste Gruppe
das Kommando, die zweite den Dateinamen liefert.
<p>
Das Scannen wird nach 10 Rekursionen abgeschnitten. Wenn das eingebundene
File existiert, kann es aus der Projektverwaltung geffnet werden, sonst
mu das Anlegen durch den expliziten Aufruf des entsprechenden Editors
erfolgen.
<p>
Die Auswahl des Editors wird in der Datei <code>apps.cfg</code> festgelegt.
<p>
-> <a href="#main">Start</a>
</body>
</html>
|
