1
0
Fork 0
doc/devel/style/presentation/src-present-local.de.tm

119 lines
5.1 KiB
Plaintext
Raw Normal View History

2011-08-28 15:59:50 +08:00
<TeXmacs|1.0.4.5>
<style|tmdoc>
<\body>
<tmdoc-title|Lokale Anpassung>
Auch wenn <TeXmacs> versucht, den Quellcode mit den globalen
Darstellungsoptionen <20>bersichtlich zu pr<70>sentieren, mu<6D> die Lesbarkeit des
Codes lokal verbessert werden. Im Quellmodus kann man das mit den Optionen
in den Men<65>s <menu|Source|Activation> und <menu|Source|Presentation>
erreichen. Alle lokalen Anweisungen, die die Darstellung des Quellcodes
betreffen, werden automatisch entfernt, wenn die Datei als Basis-Stil oder
als Stil-Paket verwendet wird.\
Insbesondere wenn es um ganz bestimmte Inhalte wie mathematische Symbole
oder um eingebettete Bilder geht, wird man lieber das Ergebnis des
Konstrukts, also die \Raktivierte`` Form, als das inaktive
Quellcode-Konstrukt sehen wollen. Beispielsweise wollen Sie m<>glicherweise
lieber in Ihrem Quellcode
<\tm-fragment>
<with|mode|math|<inactive*|<assign|R|<macro|<active*|\<bbb-R\>>>>>>
</tm-fragment>
als den inaktiven Code
<\tm-fragment>
<inactive*|<with|mode|math|<assign|R|<macro|\<bbb-R\>>>>>
</tm-fragment|>
sehen.
\;
<\samp>
Beispiel
</samp>
Besonders in komplizierteren Makros wie
<\tm-fragment>
<inactive*|<with|mode|math|<assign|diag|<macro|var|dim|<active*|<matrix|<tformat|<table|<row|<cell|<inactive*|<arg|var>><rsub|1>>|<cell|>|<cell|\<b-0\>>>|<row|<cell|>|<cell|\<ddots\>>|<cell|>>|<row|<cell|\<b-0\>>|<cell|>|<cell|<inactive*|<arg|var>><rsub|<inactive*|<arg|dim>>>>>>>>>>>>>
</tm-fragment>
\;
kann eine teilweise Aktivierung des Codes beispielsweise zu folgender
Darstellung\
<\tm-fragment>
<with|mode|math|<inactive*|<assign|diag|<macro|var|dim|<active*|<matrix|<tformat|<table|<row|<cell|<inactive*|<arg|var>><rsub|1>>|<cell|>|<cell|\<b-0\>>>|<row|<cell|>|<cell|\<ddots\>>|<cell|>>|<row|<cell|\<b-0\>>|<cell|>|<cell|<inactive*|<arg|var>><rsub|<inactive*|<arg|dim>>>>>>>>>>>>>
</tm-fragment>
\;
die Lesbarkeit des Codes sehr verbessern.
Teile des Codes k<>nnen aktiviert werden, indem man es mit der Maus ausw<73>hlt
und dann das Men<65> <menu|Source|Activation|Activate> oder die
Tastenkombination <shortcut|(make-mod-active 'active*)> verwendet. Entsprechend kann Code nach
Markierung mit \ <key|<group|M->-> deaktiviert werden. Im obigen Beispiel
haben wir das f<>r die Darstellung der Argumente benutzt und zwar zur
Darstellung der Variablen <src-arg|var> and <src-arg|dim> in beiden
gezeigten Codefragmenten. Aktivierung und Deaktivierung k<>nnen sich auf den
ganzen (markierten) Baum <menu|Source|Activation|Activate> beziehen oder
auch nur auf die Wurzel \ <menu|Source|Activation|Activate once>.
Ein anderer Weg , um die Darstellung an spezielle Bed<65>rfnisse anzupassen,
liegt darin, globale Darstellungsoptionen lokal zu ersetzen. Das ist vor
allem dort von Interesse, wo es darum geht, die Gliederung durch
Zeilenumbr<62>che zu ver<65>ndern. Beispielsweise kann das
<markup|concat>-Konstrukt dazu benutzt werden, Textinhalte
aneinanderzuf<75>gen oder auch dazu einen Block bestehend aus einer Folge von
Anweisungen/Befehlen zu erzeugen - oder auch einer Kombination aus beiden.
So haben wir in folgendem Beispiel
<\tm-fragment>
<inactive*|<assign|my-section|<macro|title|<style-with|src-compact|none|<style-with|src-compact|none|<header-hook|<arg|title>><toc-hook|<arg|title>><my-section-title|<arg|title>>>>>>>
</tm-fragment>
das Konstrukt <markup|concat> mit seinen Argumenten derartig dargestellt,
da<64> er sich <20>ber mehrere Zeilen erstreckt. dazu haben wir den Befehl
<menu|Source|Presentation|Stretched> benutzt. Das setzt <20>brigens voraus,
da<64> das Konstrukt \ <markup|concat> explizit auftaucht, da sonst eine
Verwechslung mit dem Konstrukt <markup|document> m<>glich w<>re. Wenn dagegen
ein Teil dieses Konstrukts wie <20>blich dargestellt werden sollen, kann man
<menu|Source|Presentation|Compact> benutzen:
<\tm-fragment>
<inactive*|<assign|my-section|<macro|title|<style-with|src-compact|all|<style-with|src-compact|none|<header-hook|<arg|title>><toc-hook|<arg|title>><style-with|src-compact|all|<with|font-series|bold|Section:>
<arg|title>>>>>>>
</tm-fragment>
Zur Zeit ist es noch nicht vorgesehen, Argumente als \ <em|inline> or
<em|block> zu markieren. M<>glicherweise tun wir das aber noch.
Schlie<69>lich kann die Darstellung von Code aus dem Men<65>
<menu|Source|Presentation|Apply macro> oder <menu|Source|Presentation|Apply
macro once> mit einem beliebigen Makro angepasst werden. Solche Makros
werden automatisch entfernt, wenn das Dokument als Basis-Stil oder als
Stil-Paket genutzt wird.
<tmdoc-copyright|1998--2004|Joris van der Hoeven>
<tmdoc-license|Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU Free
Documentation License".>\
</body>
<\initial>
<\collection>
<associate|language|german>
<associate|preamble|false>
</collection>
</initial>