3. Skribilo User Manual — Standard Markups
Contents↑ Skribilo User Manual

This chapter describes the forms composing Skribilo texts that use the Skribe syntax (see Section 2.1). In XML/HTML jargon these forms are called markups. In LaTeX they are called macros. In Skribilo these forms are called functions. In this manual, we will say that we call a function when a function is used in a form. The values used in a function call are named the actual parameters of the function or parameters in short. When calling a function with parameters we say that we are passing arguments to the function.

In this document function names are typeset in boldface. We call keyword argument a named argument, i.e., an argument whose name, starting with a colon (:), must be specified when the function is called. Other arguments are called plain arguments or arguments for short. An optional argument is represented by a list, starting with the character "[" and ending with the character "]", whose first element is a keyword argument and the optional second (#f when not specified) element is the default value used if the optional argument value is not provided on a function call. Arguments that are not optional are said mandatory. If a plain argument is preceded by a . character, this argument may be used to accumulate several values. There are two ways to pass actual arguments to a function:

Example: Let us consider the function section defined as follows:
(section :title [:number #t] [:toc #t] . body)
The argument :title is a mandatory keyword argument. The keyword arguments :number and :toc are optional. The plain argument body is preceeded with a . character so it may receive several values. All the following calls are legal section calls:
(section :title "A title" "This is the body of the section")
(section :title "A title" "This" " is" " the body of the section")
(section :title "A title" :number 3 "This" " is" " the body of the section")
(section :title "A title" :toc #f :number 3 "This" " is" " the body of the section")
(section :title "A title" :number 3 :toc #f "This" " is" " the body of the section")

The remainder of this chapter describes ``standard'' markups or functions that are commonly used in documents. By ``standard'', we mean two things: first, you will quickly notice that they look familiar if you have ever written, say, HTML or LaTeX documents; second, they are standard because these markups are always available by default to Skribilo documents, unlike those bundled in separate packages such as pie charts, slides, etc. In fact, these markups are also bundled in a package, called base, but this package is always available to Skribilo documents1.

Markup Index

! * A B C D E F H I K L M N P R S T U V ~


!
!
*
*bib-table*
A
abstract (acmproc)
abstract (jfp)
abstract (lncs)
author
B
bib-sort/authors
bib-sort/dates
bib-sort/first-author-last-name
bib-sort/idents
bib-table?
bibliography
blockquote
bold
breakable-space
C
center
chapter
char
code
color
D
default-index
description
document
document (letter)
E
emph
enumerate
eq
eq-display
F
figure
flush
font
footnote
frame
H
hrule
I
image
index
it
item
itemize
K
kbd
L
language
linebreak
lout-illustration
M
mailto
make-bib-table
make-index
mark
N
noabbrev
numref
P
p
paragraph
pie
pre
prog
R
ref
references (lncs)
roman
S
sc
section
sf
slice
sliceweight
slide
slide-embed
slide-pause
slide-subtopic
slide-topic
slide-vspace
source
sub
subsection
subsubsection
sup
symbol
T
table
td
th
the-bibliography
the-index
toc
tr
tt
U
underline
V
var
~
~




1 When creating Skribilo documents within Guile Scheme programs (see Section 2.4), these standard markups can be made available by using the following clause: (use-modules (skribilo package base)).
(made with skribilo)