summaryrefslogtreecommitdiffstats
path: root/template/en/default/global/docslinks.html.tmpl
blob: c2cc830fa8268e8f37b6f5fa495dfbbbb8a2ce5f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
[%# This Source Code Form is subject to the terms of the Mozilla Public
  # License, v. 2.0. If a copy of the MPL was not distributed with this
  # file, You can obtain one at http://mozilla.org/MPL/2.0/.
  #
  # This Source Code Form is "Incompatible With Secondary Licenses", as
  # defined by the Mozilla Public License, v. 2.0.
  #%]

[%# INTERFACE:
  # docslinks: hash. Hash keys will be used as text of the documentation links,
  #            hash values will be used as links to the document, relative to
  #            the main Bugzilla documentation directory.
  #            Example: If you want a 'FAQ' link to point to, the "faq-general"
  #            named anchor on faq.html, assign
  #               { 'FAQ' => "faq.html#faq-general" }
  #            to docslinks.
  #            You may only link to sections by their given ID; it is not allowed
  #            to link to a section which is not given an ID (thus getting
  #            assigned an automatically generated ID). Otherwise, the link
  #            would break on a recompilation of the documentation.
  # admindocslinks: hash. Same as docslinks, but will only be displayed to
  #                 members of the admin group.
  #%]

[% IF Param('docs_urlbase') &&
      docslinks.keys.size || (admindocslinks.keys.size && user.in_group('admin')) %]
  <div id="docslinks">
    <h2>Related documentation</h2>
    <ul>
      [% IF user.in_group('admin') %]
        [% PROCESS docslinkslist docstype = admindocslinks %]
      [% END %]
      [% PROCESS docslinkslist docstype = docslinks %]
    </ul>
  </div>
[% END %]

[% BLOCK docslinkslist %]
  [% FOREACH docslink = docstype.keys %]
    <li>
      <a href="[% docs_urlbase FILTER html %]
               [% docslink FILTER none %]">[% docstype.$docslink FILTER html %]</a>
    </li>
  [% END %]
[% END %]