| 1 |
williamc |
1.2 |
<! Style Sheet Header>
|
| 2 |
|
|
<html>
|
| 3 |
|
|
<head>
|
| 4 |
|
|
<title>urldocs.html</title>
|
| 5 |
|
|
<body bgcolor=beige>
|
| 6 |
|
|
<! End Style Sheet Header -----------Insert Text Here --------------------->
|
| 7 |
|
|
<center>
|
| 8 |
|
|
<h2>ActiveDocs - Web Enabled MarkUp Documents</h2>
|
| 9 |
|
|
<p>
|
| 10 |
|
|
<font color=red>S</font>oftware <font color=red>C</font>onfiguration,
|
| 11 |
|
|
<font color=red>R</font>elease <font color=red>A</font>nd
|
| 12 |
|
|
<font color=red>M</font>anagement
|
| 13 |
|
|
</center>
|
| 14 |
|
|
<hr>
|
| 15 |
sashby |
1.4 |
Within SCRAM is a mechanism for parsing XML-like documents called ActiveDocs.
|
| 16 |
williamc |
1.2 |
ActiveDocs can associate the documents Markup tags with functionality thus
|
| 17 |
sashby |
1.4 |
making an otherwise passive document actively control what SCRAM will do.
|
| 18 |
|
|
This ensures that the real functionality of the system is well documented as
|
| 19 |
|
|
it is the document and not a seperate system, which controls that functionality.
|
| 20 |
williamc |
1.2 |
<p>
|
| 21 |
|
|
ActiveDocs are web enabled, each being associated with a URL download and
|
| 22 |
sashby |
1.4 |
cacheing mechanism which can be called upon as required.
|
| 23 |
williamc |
1.2 |
<p>
|
| 24 |
|
|
<h2>Common ActiveDoc Tags</h2>
|
| 25 |
|
|
ActiveDocs have a number of common features and a default set of tags to
|
| 26 |
|
|
access them. Note that these are the defaults, different activedoc types
|
| 27 |
|
|
may or may not allow the use of these tags as appropriate for their application.
|
| 28 |
|
|
<br>
|
| 29 |
|
|
<h3><doc type=<em>type</em> version=<em>version</em>> </h3>
|
| 30 |
|
|
This tag is a requirement of all documents. Its function is to
|
| 31 |
|
|
indicate the type and version of the document in order that it can
|
| 32 |
|
|
be parsed correctly.
|
| 33 |
|
|
<h3><Base url=<em>baseurl</em>> </Base></h3>
|
| 34 |
sashby |
1.4 |
Used to specify common elements, such as server name, in multiple URLs. Any
|
| 35 |
|
|
URL specified between these base tags will be merged with that specified in
|
| 36 |
williamc |
1.2 |
the base according to the following merge rules:
|
| 37 |
|
|
<ul>
|
| 38 |
|
|
<li>A merge will take place only if the type of the base is identical
|
| 39 |
sashby |
1.4 |
to the URL type.
|
| 40 |
williamc |
1.2 |
<li>The base server name is taken only if not already defined
|
| 41 |
sashby |
1.4 |
<li>The base URL path is pre-pended to any specified
|
| 42 |
williamc |
1.2 |
<li>Variables provided in the base parameter list are only added if
|
| 43 |
|
|
not already defined.
|
| 44 |
|
|
</ul>
|
| 45 |
|
|
<h2>URL Document PreProcessing</h2>
|
| 46 |
|
|
<h3><Include url=<em>docurl</em>></h3>
|
| 47 |
|
|
ActiveDocs provide an equivalent of the C pre-processor <em>#include</em>
|
| 48 |
|
|
directive that is web aware. In this way you can assemble a document from
|
| 49 |
|
|
many components that are maintained at different locations.<p>
|
| 50 |
|
|
To inline a document use the
|
| 51 |
|
|
<font color=green>
|
| 52 |
|
|
<pre>
|
| 53 |
|
|
<include url=<em>url</em>>
|
| 54 |
|
|
</pre>
|
| 55 |
|
|
</font>
|
| 56 |
|
|
tag.
|
| 57 |
|
|
<!Style Sheet Footer ---------------Do not change anything after this line-- >
|
| 58 |
|
|
<hr>
|
| 59 |
|
|
<table border=1 width=100%>
|
| 60 |
|
|
<td align=left>
|
| 61 |
sashby |
1.3 |
<a href=mailto:Shaun.Ashby@cern.ch
|
| 62 |
|
|
>Shaun Ashby</a>
|
| 63 |
williamc |
1.2 |
</td>
|
| 64 |
|
|
<td align=center>
|
| 65 |
sashby |
1.3 |
<SCRIPT LANGUAGE="JAVASCRIPT">document.write("Last Updated "+ document.lastModified );</SCRIPT>
|
| 66 |
williamc |
1.2 |
</td>
|
| 67 |
|
|
<td align=right><a href=/cgi-cmc/pagestat>Show Stats</a>
|
| 68 |
|
|
</td>
|
| 69 |
|
|
</table>
|
| 70 |
|
|
</body> </html>
|
| 71 |
|
|
<! End Style Sheet Footer>
|
