mention and explain high order HTML tags
This commit is contained in:
		
							parent
							
								
									b625901bd1
								
							
						
					
					
						commit
						fbc10a2f63
					
				| 
						 | 
				
			
			@ -8,6 +8,7 @@
 | 
			
		|||
\title{The Servlet Handler of the \textit{SUnet} Web Server}
 | 
			
		||||
 | 
			
		||||
\input{../../../doc/latex/decls}
 | 
			
		||||
\newcommand{\attrib}[1]{\textsf{#1}}
 | 
			
		||||
 | 
			
		||||
\begin{document}
 | 
			
		||||
\maketitle
 | 
			
		||||
| 
						 | 
				
			
			@ -87,8 +88,42 @@ See the examples for further informations.
 | 
			
		|||
    (body (h1 "Welcome to my homepage!")
 | 
			
		||||
          (p "How are you?")))
 | 
			
		||||
  \end{alltt}
 | 
			
		||||
 | 
			
		||||
  The SXML object is translated into plain HTML by the
 | 
			
		||||
  procedures. They recognize higher the following order tags. You may
 | 
			
		||||
  specify your own tags using the SSAX library.
 | 
			
		||||
\end{desc}
 | 
			
		||||
 | 
			
		||||
\dfn{URL}{target \ovar{SXML ...}}{link}{tag}
 | 
			
		||||
\begin{desc}
 | 
			
		||||
  The \ex{URL} tag creates a hyper link to \semvar{target}, described
 | 
			
		||||
  with \semvar{SXML}. This corresponds to the \ex{a} tag in HTML.
 | 
			
		||||
\end{desc}
 | 
			
		||||
 | 
			
		||||
\dfn{plain-html}{\ovar{text ...}}{HTML}{tag}
 | 
			
		||||
\begin{desc}
 | 
			
		||||
  This is for quoting text, that you want to be put into the resulting
 | 
			
		||||
  HTML page as-is. Of course, you can blow up the created HTML page
 | 
			
		||||
  with this, you've been warned.
 | 
			
		||||
\end{desc}
 | 
			
		||||
 | 
			
		||||
\dfn{servlet-form}{address \ovar{method} \ovar{attributes} \ovar{SXML
 | 
			
		||||
  ...}}{form}{tag}
 | 
			
		||||
\begin{desc}
 | 
			
		||||
  This creates an HTML form. Its \attrib{action} attribute will be
 | 
			
		||||
  \semvar{address}---\ie{} the browser will send the form data to
 | 
			
		||||
  \semvar{address}. With \semvar{method} you can specify how the form
 | 
			
		||||
  data will be sent: \ex{'get} or \ex{'GET} denote a \ex{GET} request,
 | 
			
		||||
  \ex{'post} or \ex{'POST} denote a \ex{POST} request. Any other value
 | 
			
		||||
  will cause en error. \semvar{attributes} Are further attributes you
 | 
			
		||||
  want to add to the form---\eg{}\attrib{target}. Note if you specify
 | 
			
		||||
  the \attrib{enctype} to be something else than
 | 
			
		||||
  \ex{application/x-www-form-urlencoded} you have to decode the
 | 
			
		||||
  response on yourself---\ie{} you must not use the helper functions
 | 
			
		||||
  listed below.
 | 
			
		||||
\end{desc}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
\defun{form-query}{string}{bindings}
 | 
			
		||||
\defunx{get-bindings}{req}{bindings}
 | 
			
		||||
| 
						 | 
				
			
			@ -106,7 +141,7 @@ See the examples for further informations.
 | 
			
		|||
  \semvar{get-bindings} accesses the search part, if \ex{req} is a
 | 
			
		||||
  \ex{GET} request. If it is a \ex{POST} request, though, it reads the
 | 
			
		||||
  string from the associated input port. In both cases, \ex{GET} or
 | 
			
		||||
  \ex{POST} request it returns an association list of bindings as
 | 
			
		||||
  \ex{POST} request, it returns an association list of bindings as
 | 
			
		||||
  \ex{form-query} does. Note that as \ex{get-bindings} reads from the
 | 
			
		||||
  associated input port, you must not invoke it more than once for a
 | 
			
		||||
  specific \ex{POST} request---doing so on a \ex{GET} request does not
 | 
			
		||||
| 
						 | 
				
			
			@ -188,10 +223,10 @@ See the examples for further informations.
 | 
			
		|||
  filling of \semvar{default}, that may be a string, a symbol or a
 | 
			
		||||
  number. \ex{make-textarea-input-field} creates a textarea input
 | 
			
		||||
  field, optionally filled out with \semvar{default-text}. You may
 | 
			
		||||
  want to give the \ex{cols} and \ex{rows} attributes
 | 
			
		||||
  want to give the \attrib{cols} and \attrib{rows} attributes
 | 
			
		||||
  explicitly. \ex{make-select-input-field} creates a select input
 | 
			
		||||
  field of the items given in \semvar{options}. Depending on a given
 | 
			
		||||
  \ex{size} attribute the select input field will be displayed as a
 | 
			
		||||
  \attrib{size} attribute the select input field will be displayed as a
 | 
			
		||||
  scrollable list or a dropdown list (see a reference to HTML for
 | 
			
		||||
  details). If \semvar{multiple?} is true, the select input field will
 | 
			
		||||
  allow multiple selections. In this case, \ex{input-field-value} will
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
		Reference in New Issue