summaryrefslogtreecommitdiff
path: root/doc/user/colframe.skb
blob: 307b95cbaf1538ff3fb547987dd78a3d75c08f33 (plain)
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
;;; colframe.skb  --  Skribe color and frame
;;;
;;; Copyright 2003, 2004  Manuel Serrano
;;;
;;;
;;; This program is free software; you can redistribute it and/or modify
;;; it under the terms of the GNU General Public License as published by
;;; the Free Software Foundation; either version 2 of the License, or
;;; (at your option) any later version.
;;;
;;; This program is distributed in the hope that it will be useful,
;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;; GNU General Public License for more details.
;;;
;;; You should have received a copy of the GNU General Public License
;;; along with this program; if not, write to the Free Software
;;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
;;; USA.

;*---------------------------------------------------------------------*/
;*    Frame and color                                                  */
;*---------------------------------------------------------------------*/
(section :title "Frame and color" :file #t

(p [The function ,(code "frame") embeds a text inside a frame. 
The function ,(code "color") may also use the same purpose when it is
specified a ,(code "bg") option. This is why both functions are included
in the same Skribe manual section.])

;*--- Frame -----------------------------------------------------------*/
(subsection :title "Frame"

(doc-markup 'frame
	    `((:width ,[The ,(ref :mark "width") of the frame.])
	      (:margin [The margin pixel size of the frame.])
	      (:border [The border pixel of the frame.])
              (#!rest node... "The items of the enumeration."))
	    :see-also '(color table))

(example-produce
 (example :legend "The frame markup" (prgm :file "src/api12.skb"))
 (disp (include "src/api12.skb"))))

;*--- color -----------------------------------------------------------*/
(subsection :title "Color"

(p [The ,(code "color") markup enables changing ,(emph "locally") the
text of the document. If the ,(code "bg") color is used, then, ,(code "color")
acts as a container. Otherwise, it acts as an ,(ref :section "Ornaments").])

(doc-markup 'color
	    `((:width ,[The ,(ref :mark "width") of the frame.])
	      (:margin [The margin pixel size of the frame.])
	      (:bg [The background color])
	      (:fg [The foreground color])
              (#!rest node... "The items of the enumeration."))
	    :see-also '(frame table))
(example-produce
 (example :legend "The color markup" (prgm :file "src/api13.skb"))
 (disp (include "src/api13.skb")))))