e75b9bacdf8bb77fdaefb2dc8222d08caac876a3
[exim-website.git] / templates / web / docs.xsl
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
4
5         <!-- WRAPPER -->
6                 <xsl:import href="../wrapper.xsl"/>
7                 <xsl:template match="/"> <xsl:apply-imports/> </xsl:template>
8
9                 <xsl:variable name="docroot" select="'.'"/>
10
11         <!-- Title -->
12                 <xsl:variable name="html.head.title" select="'Documentation for Exim'"/>
13
14
15         <xsl:variable name="html.head.append">
16
17                 <!-- Canonical -->
18                         <link rel="canonical" href="https://www.exim.org/docs.html"/>
19
20                 <!-- CSS -->
21                         <link rel="stylesheet" type="text/css" href="docs.css"/>
22         </xsl:variable>
23
24         <!-- JavaScript -->
25                 <xsl:variable name="html.body.append">
26                         <script type="text/javascript" src="docs.js"/>
27                 </xsl:variable>
28
29         <!-- CONTENT -->
30                 <xsl:template name="content">
31
32                         <!-- Title -->
33                                 <h2>
34                                         <xsl:value-of select="$html.head.title"/>
35                                 </h2>
36
37                         <!-- General Doc Info -->
38                                 <p>Exim has a set of documentation released with it. A text file of the main documentation is released as part of the Exim tar archive. Additionally, postscript and texinfo forms of the documentation are available in separate tar archives on the ftp sites. There is also a <a href="https://www.uit.co.uk/all-books/the-exim-smtp-mail-server.html">book</a>.</p>
39
40                                 <p>User supported documentation, FAQs and hints can be found in the <a href="https://wiki.exim.org/">wiki</a>.</p>
41
42                                 <p>There are 3 main sets of documentation for Exim, all of which are also available below in html form.</p>
43
44                                 <p>The main user and configuration manual is the specification document</p>
45
46                                 <p class="manual_info">
47                                         <a href="{$docroot}/exim-html-current/doc/html/spec_html/index.html">
48                                                 <xsl:text>The Exim Specification - Version </xsl:text>
49                                                 <xsl:value-of select="/content/current_version"/>
50                                                 <xsl:text> (HTML)</xsl:text>
51                                         </a>
52                                         <xsl:text> </xsl:text>
53                                         <a href="{$docroot}/exim-pdf-current/doc/spec.pdf">(PDF)</a>
54
55                                         <xsl:text> - The master documentation for Exim containing all required detail to install, configure and use Exim. </xsl:text>
56                                         <span class="changed">Changes to the documentation (normally reflecting changes to the functionality of Exim) are shown on a green background like this segment.</span>
57                                         <br/><select name="spec_old_version">
58                                                 <option value="">View Older Versions</option>
59                                                 <xsl:for-each select="/content/old_versions">
60                                                         <option value="{text()}"><xsl:value-of select="text()"/></option>
61                                                 </xsl:for-each>
62                                         </select>
63                                 </p>
64
65                                 <p class="manual_info">
66                                         <a href="{$docroot}/exim-html-current/doc/html/spec_html/filter.html">
67                                                 <xsl:text>The Exim Filter Specification - Version </xsl:text>
68                                                 <xsl:value-of select="/content/current_version"/>
69                                                 <xsl:text> (HTML)</xsl:text>
70                                         </a>
71                                         <xsl:text> </xsl:text>
72                                         <a href="{$docroot}/exim-pdf-current/doc/filter.pdf">(PDF)</a>
73                                         <xsl:text> - Additional information on the Exim filter language.</xsl:text>
74                                         <br/><select name="filter_old_version">
75                                                 <option value="">View Older Versions</option>
76                                                 <xsl:for-each select="/content/old_versions">
77                                                         <option value="{text()}"><xsl:value-of select="text()"/></option>
78                                                 </xsl:for-each>
79                                         </select>
80                                 </p>
81
82                         <!-- HOWTOs -->
83                                 <h3>HOWTO Documentation</h3>
84                                 <ul id="howto_list">
85                                         <li>
86                                                 <a href="{$docroot}/howto/rbl.html">Using DNS Block Lists</a>
87                                         </li>
88                                         <li>
89                                                 <a href="{$docroot}/howto/mailman21.html">Using mailman 2.1 lists with Exim4</a>
90                                         </li>
91                                 </ul>
92
93                         <!-- FAQS -->
94                                 <h3>Frequently Asked Questions - FAQ</h3>
95                                 <p>
96                                         <xsl:text>The wikified </xsl:text>
97                                         <a href="http://wiki.exim.org/FAQ">FAQ for Exim 4</a>
98                                         <xsl:text> can be found </xsl:text>
99                                         <a href="http://wiki.exim.org/FAQ">here</a>
100                                         <xsl:text>. The FAQ for the obsolete Exim 3 releases can be found on the </xsl:text>
101                                         <a href="{$docroot}/ftp/exim3/">FTP site</a>
102                                         <xsl:text> - see the </xsl:text>
103                                         <a href="{$docroot}/mirrors.html">download</a>
104                                         <xsl:text> pages.</xsl:text>
105                                 </p>
106
107                         <!-- Copies -->
108                                 <h3>Copies of Documentation</h3>
109                                 <p>Copies of the main Exim documentation in HTML format as used on this site in a compressed tar file are available from the main ftp site and mirrors (see file exim-html-*).</p>
110
111                 </xsl:template>
112
113 </xsl:stylesheet>