<!--
 -  
 -  This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
 -  project.
 -  
 -  Copyright (C) 1998-2018 OpenLink Software
 -  
 -  This project 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; only version 2 of the License, dated June 1991.
 -  
 -  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 St, Fifth Floor, Boston, MA 02110-1301 USA
 -  
 -  
-->
<?xml version="1.0" encoding="ISO-8859-1"?>
<refentry id="VS-B-2">
  <refmeta>
    <refentrytitle>Basic VSP Programming</refentrytitle>
    <refmiscinfo>tutorial</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>Syntax of a Page</refname>
    <refpurpose>Overview of Virtuoso Server Pages (VSP) syntax</refpurpose>
  </refnamediv>

<refsect1 id="VS-B-2a">
<title>Preliminaries</title>
<itemizedlist mark="bullet">
  <listitem>The pages with active content are named Virtuoso Server Pages, or VSP in short.</listitem>
  <listitem>These pages consist of Virtuoso PL and HTML code.</listitem>
  <listitem>The Virtuoso Web server executes only files (resources) with the ".vsp" extension.</listitem>
  <listitem>The VSP file can contain VSP blocks and HTML blocks</listitem>
  <listitem><para>The VSP block contains the PL code</para>
   <itemizedlist mark="bullet">
    <listitem>The &lt;?vsp marks the beginning of a VSP block.</listitem>  
    <listitem>The ?&gt; marks the end of a VSP block.</listitem>
   </itemizedlist></listitem>
  <listitem>The HTML block is everything outside of a VSP block.</listitem>
  <listitem><para>The VSP shortcut in an HTML block is used to include value.</para>
   <itemizedlist mark="bullet">
    <listitem>The &lt;?= marks the beginning of VSP shortcut.</listitem>  
    <listitem>The ?&gt; marks the end of a VSP shortcut.</listitem>  
   </itemizedlist></listitem>
</itemizedlist>
</refsect1>

<refsect1 id="VS-B-2b">
<title>Example</title>
<para>The demonstration page uses the &lt;?= &lt;?vsp markup and SQL expressions to generate html
content from within a VSP loop.</para>
</refsect1>
</refentry>