summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/tex-virtual-academy-pl/latex2e/macro/framed.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex-virtual-academy-pl/latex2e/macro/framed.html')
-rw-r--r--Master/texmf-dist/doc/generic/tex-virtual-academy-pl/latex2e/macro/framed.html102
1 files changed, 102 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/tex-virtual-academy-pl/latex2e/macro/framed.html b/Master/texmf-dist/doc/generic/tex-virtual-academy-pl/latex2e/macro/framed.html
new file mode 100644
index 00000000000..fbc827ad616
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/tex-virtual-academy-pl/latex2e/macro/framed.html
@@ -0,0 +1,102 @@
+<html>
+<head>
+<title> Zastaw ciekawych makroinstrukcji </title>
+<LINK REL="stylesheet" TYPE="text/css" HREF="mycss.css"/>
+<meta http-equiv="content-type" content="text/html; charset=iso-8859-2"/>
+<meta http-equiv="Content-language" content="pl"/>
+<meta name="Author" content="Włodzimierz Macewicz"/>
+<meta name="Keywords" content="tex, latex, makroinstrukcje, pakiety makroinstrukcji, Wirtualna Akademia, dokumentacja pakietów"/>
+</head>
+<body bgcolor=#a0f0a0>
+<h2><a name="framed">framed</a></h2>
+
+<p>Pakiet definiuje środowiska <code>framed</code>, <code>shaded</code> i
+<code>leftbar</code>, które umożliwiają: ujęcie tekstu w ramkę, podłożenie
+kolorowego (lub szarego) tła (pakiet korzysta z pakietu <a href="color.html">color</a>, <b>ale należy</b> go samemu dołączyć)
+oraz umieszczenie linii na brzegu (p. też <a
+href="changebar.html">changebar</a>). Opisywane konstrukcje <b>nie zaburzają</b>
+procesu łamania na strony, ale wewnątrz nie można definiować obiektów ruchomych (rysunki, tabele, noty na marginesie --
+sygnalizowany jest błąd, przypisy (footnote) -- pojawia się odsyłacz, ale nie
+pojawia się treść przypisu, inkrementowany jest numer; nie jest sygnalizowany błąd). Oprócz tego
+zawartość środowiska nie jest rozciągana w pionie w przypadku użycia poleceń
+wymuszających przejście do nowej strony.</p>
+
+<h3>Opis środowisk</h3>
+<h4><code>leftbar</code></h4>
+Tekst zamknięty w środowisku będzie oznaczony linią pionową z lewej strony (w
+polu kolumny).
+Linia ma 3pt grubości i odległość między linią a tekstem wynosi 10pt (wartości
+te są ,,zaszyte'' w definicji środowiska, ale łatwo zdefiniować własne, inne na
+jego podstawie
+<pre>
+\newenvironment{leftbar}{%
+ \def\FrameCommand{\vrule width 3pt \hspace{10pt}}%
+ \MakeFramed {\advance\hsize-\width \FrameRestore}}%
+ {\endMakeFramed}
+</pre>
+np. definicja
+<pre>
+\renewenvironment{leftbar}{%
+ \def\FrameCommand{{\color{red}\vrule width 6pt} \hspace{10pt}}%
+ \MakeFramed {\advance\hsize-\width \FrameRestore}}%
+ {\endMakeFramed}
+</pre>
+da w efekcie linie o grubości 6pt w kolorze czerwonym (należy dołączyć pakiet
+<tt>color</tt>).
+
+<h4><code>framed</code></h4>
+<p>Do konstrukcji ramki używane jest standardowo makro <code>fbox</code>, jeśli nie zostało
+zdefiniowane inaczej to grubość ramki ustala się na wartość
+<code>fboxrule</code>, a odległość tekstu od ramki na <code>3 x \fboxsep</code>.
+Powyższe parametry możemy określić nadając wartości rejestrom
+<code>\FrameRule</code> oraz <code>\Framesep</code> np.
+<code>\setlength{\FrameSep}{2pt}</code></p>
+
+<p>Można łatwo zmienić makro konstrukcyjne z <code>fbox</code> na inne i
+uzyskać dodatkowe efekty; np:
+ efekt kolorowej ramki i tła; należy użyć makra
+<code>\fcolorbox</code> z pakietu <a href"color.html">color</a> zamiast
+konstrukcji <code>\fbox</code> np:
+<pre>
+\def\FrameCommand{\fboxrule=\FrameRule \fboxsep=\FrameSep \fcolorbox{red}{green}}
+</pre>
+w tym wypadku określiłem kolor tła na zielony, a kolor ramki na czerwony,
+możemy również przy okazji zmienić kolor czcionki:
+<pre>
+\def\FrameCommand{\fboxrule=\FrameRule \fboxsep=\FrameSep \color{blue}\fcolorbox{red}{green}}
+</pre>
+niebieski w tym wypadu.</p>
+<p>Przy realizacji tego środowiska używane jest ostatnio zdefiniowane makro
+<code>\FrameCommand</code>, które w powyższych przykładach było definiowane
+,,na zewnątrz''. Można zdefiniować sobie kilka środowisk o różnych cechach
+(zachowując grubość linii i jej odległość od tekstu) np.:
+<pre>
+\newenvironment{myframed}{%
+ \def\FrameCommand{\fboxrule=\FrameRule \fboxsep=\FrameSep \color{yellow}\fcolorbox{green}{red}}
+ \MakeFramed{\advance\hsize-\width \FrameRestore}}%
+ {\endMakeFramed}
+</pre>
+
+<h4><code>shaded</code></h4>
+<p>Środowisko służy, w zamyśle, do podłożenia kolorowego tła pod tekst (powyżej
+efekt ten został osiągnięty dzięki modyfikacjom w definicji środowiska
+<code>framed</code>). Używanym kolorem tła jest <tt>shadecolor</tt>; <b>musi on
+być</b> wcześniej zdefiniowany poleceniem <code>\definecolor</code> (p. <a href"color.html">color</a>) np:
+<pre>
+\definecolor{shadecolor}{rgb}{0.1,0.2,0.8}
+</pre>
+
+
+<h4><code>MakeFramed</code></h4>
+<p>Wspominam o nim jedynie dla porządku -- jest ono używane do definiowania
+przedstawionych wcześniej środowisk -- wnikliwy TeX-owiec zapewne sam pozna
+jego tajniki, innym radzę jego użycie, analogicznie jak w podanych
+przykładach.</p>
+
+<hr>
+<em>Włodzimierz Macewicz</em>
+<hr>
+Ostatnie zmiany: 05.05.2014.
+
+</body>
+</html>