Location: PHPKode > projects > Open Power Template > docs/Opt/syntax.instructions.prolog.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="pl">
<head>
	<meta http-equiv="content-type" content="text/html; charset=utf-8" />
	<meta name="robots" content="all" />

	<title>opt:prolog - Open Power Template</title>
	
	<link rel="stylesheet" type="text/css" href="design/generic.css" media="all"  />
	<link rel="stylesheet" type="text/css" href="design/print.css" media="print" />
	<!--[if lte IE 6]><link rel="stylesheet" href="design/ie.css" type="text/css" /><![endif]-->	
	<!--[if IE 7]><link rel="stylesheet" href="design/ie7.css" type="text/css" /><![endif]-->
</head>
<body>

<div id="wrap">
	<div id="header">
		<h1>Open Power Template 2.0</h1>
		<h2>opt:prolog</h2>
		<p class="generated">@ 02.09.2010</p>
		<p class="location"><a href="index.html"><strong>User manual</strong></a> &raquo; <a href="syntax.html">Template syntax</a> &raquo; <a href="syntax.instructions.html">Instructions</a> &raquo; <a href="syntax.instructions.prolog.html">opt:prolog</a></p>
	</div>
	
	<div id="content"><dl class="location"><dt><a href="syntax.instructions.html">3.7. Instructions</a><br/>3.7.15. opt:prolog</dt><dd class="prev">3.7.14. opt:literal<br/><a href="syntax.instructions.literal.html">&laquo; Previous</a></dd><dd class="next">3.7.16. opt:put<br/><a href="syntax.instructions.put.html">Next &raquo;</a></dd></dl>	<h1>3.7.15. opt:prolog</h1><p><code>opt:prolog</code> generates the output XML prolog, if the configuration option <code>prologRequired</code> is enabled. In this case the standard XML prologs put in the template are not sent to the browser and this instruction is the only solution then. It may take up to three attributes:</p>

<table>
<thead>
<tr>
  <th>Name</th>
  <th>Type</th>
  <th>Required?</th>
  <th align="left">Description</th>
</tr>
</thead>
<tbody>
<tr>
  <td>version</td>
  <td>Expression</td>
  <td>No</td>
  <td align="left">The XML version. Default value is "1.0"</td>
</tr>
<tr>
  <td>encoding</td>
  <td>Expression</td>
  <td>No</td>
  <td align="left">The encoding, taken by default from the OPT configuration.</td>
</tr>
<tr>
  <td>standalone</td>
  <td>Expression</td>
  <td>No</td>
  <td align="left">The "standalone" attribute in the prolog. The default value is "no".</td>
</tr>
</tbody>
</table>

<p>The instruction has one advantage over a typical prolog - we may read the values from the variables.</p>

<pre class="xml"><span style="color: #009900;"><span style="color: #000000; font-weight: bold;">&lt;?xml</span> <span style="color: #000066;">version</span>=<span style="color: #ff0000;">&quot;1.0&quot;</span> <span style="color: #000066;">encoding</span>=<span style="color: #ff0000;">&quot;UTF-8&quot;</span> <span style="color: #000000; font-weight: bold;">?&gt;</span></span>   <span style="color: #808080; font-style: italic;">&lt;!-- with &quot;prologRequired&quot; enabled, this line won't appear in the browser. --&gt;</span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;">&lt;opt:prolog</span> <span style="color: #000066;">standalone</span>=<span style="color: #ff0000;">&quot;yes&quot;</span><span style="color: #000000; font-weight: bold;">/&gt;</span></span>    <span style="color: #808080; font-style: italic;">&lt;!-- the prolog for the browser will be generated here. --&gt;</span></pre>

<p>There is no requirement to place <code>opt:prolog</code> at the beginning of the template. Even if it is deeply nested in other XML tags, the prolog will always appear before the document content.</p>
<h4>See also:</h4><ul><li><a href="syntax.compiler-modes.html">3.1. Compiler modes</a></li><li><a href="syntax.prolog.html">3.3. XML Prolog and DTD</a></li></ul><dl class="location location-bottom"><dt>3.7.15. opt:prolog<br/><a href="syntax.instructions.html">3.7. Instructions</a></dt><dd class="prev"><a href="syntax.instructions.literal.html">&laquo; Previous</a><br/>3.7.14. opt:literal</dd><dd class="next"><a href="syntax.instructions.put.html">Next &raquo;</a><br/>3.7.16. opt:put</dd></dl>		</div>
	
	<div id="footer">
		<p>Copyright &copy; <a href="http://www.invenzzia.org/">Invenzzia Group 2008-2009</a></p>
		<p>Available under the terms of license: <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License 1.2</a></p>
		<p>Generated by <strong>TypeFriendly 0.1.4</strong> by <a href="http://www.invenzzia.org/">Invenzzia</a></p>
	</div>
</div>

</body>
</html>
Return current item: Open Power Template