253 lines
10 KiB
HTML
253 lines
10 KiB
HTML
|
<!DOCTYPE html>
|
||
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" class="h-100">
|
||
|
|
<head>
|
||
|
|
<meta charset="utf-8" />
|
||
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||
|
|
<!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
|
||
|
|
<meta name="robots" content="noindex, follow" />
|
||
|
|
|
||
|
|
<title>templates - ilot.io</title>
|
||
|
|
|
||
|
|
<!-- cargo-culted from https://realfavicongenerator.net/ -->
|
||
|
|
<!-- for the record: it is absolutely ridiculous that new browsers
|
||
|
|
*and* operating systems each want their own little precious
|
||
|
|
snowflake just for a frigging icon -->
|
||
|
|
<link rel="apple-touch-icon" sizes="180x180" href="../apple-touch-icon.png">
|
||
|
|
<link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png">
|
||
|
|
<link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png">
|
||
|
|
<link rel="manifest" href="../site.webmanifest">
|
||
|
|
<meta name="msapplication-TileColor" content="#da532c">
|
||
|
|
<meta name="theme-color" content="#ffffff">
|
||
|
|
|
||
|
|
<!-- ikiwiki CSS -->
|
||
|
|
<link href="../css/style.css" rel="stylesheet" />
|
||
|
|
|
||
|
|
<!-- Bootstrap core CSS -->
|
||
|
|
<!-- those checksums can be verified with: shasum -b -a 384 $file | xxd -r -p | base64 -->
|
||
|
|
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-rbsA2VBKQhggwzxH7pPCaAqO46MgnOM80zW1RWuH61DGLwZJEdK2Kadq2F9CUG65" crossorigin="anonymous">
|
||
|
|
|
||
|
|
<!-- Custom styles for this template -->
|
||
|
|
<link href="../css/bootstrap.local.css" rel="stylesheet" />
|
||
|
|
|
||
|
|
<!-- Custom styles for derivatives -->
|
||
|
|
|
||
|
|
<link rel="stylesheet" href="../css/local.css" type="text/css" />
|
||
|
|
|
||
|
|
|
||
|
|
</head>
|
||
|
|
<body class="d-flex flex-column h-100">
|
||
|
|
<header>
|
||
|
|
<nav class="navbar fixed-top navbar-expand-lg navbar-light bg-light border">
|
||
|
|
<div class="container-fluid">
|
||
|
|
<a class="navbar-brand me-auto" href="../">
|
||
|
|
<img alt="ilot.io" src="../favicon.png" width="48" height="48" />
|
||
|
|
</a>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<button class="navbar-toggler collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbarScroll" aria-expanded="false" aria-label="Toggle navigation">
|
||
|
|
<span class="navbar-toggler-icon"></span>
|
||
|
|
</button>
|
||
|
|
|
||
|
|
<div id="navbar" class="collapse navbar-collapse">
|
||
|
|
<!-- the anchors force ikiwiki to use a tags instead of spans. hopefully. -->
|
||
|
|
<ul class="navbar-nav nav-link align-items-center ms-auto">
|
||
|
|
<li><a href="../index.en.html">Home</a></li>
|
||
|
|
<li><a href="../platforms/index.en.html">Platforms</a></li>
|
||
|
|
<li><a href="../join/index.en.html">Join</a></li>
|
||
|
|
<li>
|
||
|
|
<button class="btn sign-in" onclick="window.location.href='https://ilot.io/apps/files';">
|
||
|
|
Your Files
|
||
|
|
</button>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<ul class="nav navbar-nav">
|
||
|
|
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</nav>
|
||
|
|
</header>
|
||
|
|
|
||
|
|
<main class="flex-shrink-0">
|
||
|
|
<div class="container" id="content">
|
||
|
|
<p><a href="../ikiwiki/">Ikiwiki</a> uses many templates for many purposes. By editing its templates,
|
||
|
|
you can fully customise its appearance, and avoid duplicate content.</p>
|
||
|
|
|
||
|
|
<p>Ikiwiki uses the HTML::Template module as its template engine. This
|
||
|
|
supports things like conditionals and loops in templates and is pretty
|
||
|
|
easy to learn. All you really need to know to modify templates is this:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>To insert the value of a template variable, use <code><TMPL_VAR variable></code>.</li>
|
||
|
|
<li>To make a block of text conditional on a variable being set use
|
||
|
|
<code><TMPL_IF variable>text</TMPL_IF></code>.</li>
|
||
|
|
<li>To use one block of text if a variable is set and a second if it's not,
|
||
|
|
use <code><TMPL_IF variable>text<TMPL_ELSE>other text</TMPL_IF></code></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<h2>template pages</h2>
|
||
|
|
|
||
|
|
<p>Template pages are regular wiki pages containing a
|
||
|
|
<a href="http://ikiwiki.info/ikiwiki/directive/templatebody/">templatebody directive</a>,
|
||
|
|
used as templates for other pages. The parts of the template
|
||
|
|
page outside the directive can be used to document it.</p>
|
||
|
|
|
||
|
|
<p>The <a href="http://ikiwiki.info/ikiwiki/directive/template/">template directive</a> allows
|
||
|
|
template pages to be filled out and inserted into other pages in the wiki.</p>
|
||
|
|
|
||
|
|
<p>These template pages are currently available:</p>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
|
||
|
|
<a href="./note/">note</a>
|
||
|
|
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
|
||
|
|
<a href="./note.fr/">note.fr</a>
|
||
|
|
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
|
||
|
|
<a href="./popup/">popup</a>
|
||
|
|
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
|
||
|
|
<a href="./popup.fr/">popup.fr</a>
|
||
|
|
|
||
|
|
</p>
|
||
|
|
|
||
|
|
|
||
|
|
<p>If the template does not contain a <code>templatebody</code> directive, the entire
|
||
|
|
source of the page is used for the template. This is deprecated.</p>
|
||
|
|
|
||
|
|
<h2>template files</h2>
|
||
|
|
|
||
|
|
<p>Template files are unlike template pages in that they have the extension
|
||
|
|
<code>.tmpl</code>. Template files are used extensively by Ikiwiki to generate html.
|
||
|
|
They can contain html that would not normally be allowed on a wiki page.</p>
|
||
|
|
|
||
|
|
<p>Template files are located in <code>/usr/share/ikiwiki/templates</code> by default;
|
||
|
|
the <code>templatedir</code> setting can be used to make another directory be
|
||
|
|
searched first. Customised template files can also be placed inside the
|
||
|
|
"templates/" directory in your wiki's source -- files placed there override
|
||
|
|
ones in the <code>templatedir</code>.</p>
|
||
|
|
|
||
|
|
<p>Here is a full list of the template files used:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><p><code>page.tmpl</code> - Used for displaying all regular wiki pages. This is the
|
||
|
|
key template to customise to change the look and feel of Ikiwiki.</p></li>
|
||
|
|
<li><p><code>rsspage.tmpl</code> - Used for generating rss feeds for blogs.</p></li>
|
||
|
|
<li><code>rssitem.tmpl</code> - Used for generating individual items on rss feeds.</li>
|
||
|
|
<li><code>atompage.tmpl</code> - Used for generating atom feeds for blogs.</li>
|
||
|
|
<li><code>atomitem.tmpl</code> - Used for generating individual items on atom feeds.</li>
|
||
|
|
<li><code>inlinepage.tmpl</code> - Used for displaying a post in a blog.</li>
|
||
|
|
<li><code>archivepage.tmpl</code> - Used for listing a page in a blog archive page.</li>
|
||
|
|
<li><code>titlepage.tmpl</code> - Used for listing a page by title in a blog archive page.</li>
|
||
|
|
<li><code>microblog.tmpl</code> - Used for showing a microblogging post inline.</li>
|
||
|
|
<li><code>blogpost.tmpl</code> - Used for a form to add a post to a blog (and rss/atom links)</li>
|
||
|
|
<li><code>feedlink.tmpl</code> - Used to add rss/atom links if <code>blogpost.tmpl</code> is not used.</li>
|
||
|
|
<li><code>aggregatepost.tmpl</code> - Used by the aggregate plugin to create
|
||
|
|
a page for a post.</li>
|
||
|
|
<li><code>searchform.tmpl</code>, <code>googleform.tmpl</code> - Used by the search plugin
|
||
|
|
and google plugin to add search forms to wiki pages.</li>
|
||
|
|
<li><code>searchquery.tmpl</code> - This is a Omega template, used by the
|
||
|
|
search plugin.</li>
|
||
|
|
<li><code>comment.tmpl</code> - Used by the comments plugin to display a comment.</li>
|
||
|
|
<li><code>change.tmpl</code> - Used to create a page describing a change made to the wiki.</li>
|
||
|
|
<li><code>recentchanges.tmpl</code> - Used for listing a change on the RecentChanges page.</li>
|
||
|
|
<li><code>autoindex.tmpl</code> - Filled in by the autoindex plugin to make index pages.</li>
|
||
|
|
<li><code>autotag.tmpl</code> - Filled in by the tag plugin to make tag pages.</li>
|
||
|
|
<li><code>calendarmonth.tmpl</code>, <code>calendaryear.tmpl</code> - Used by ikiwiki-calendar to
|
||
|
|
make calendar archive pages.</li>
|
||
|
|
<li><code>trails.tmpl</code> - Used by the trail plugin to generate links on each page
|
||
|
|
that is a member of a trail.</li>
|
||
|
|
<li><code>notifyemail.tmpl</code> - Used by the notifymail plugin to generate mails about
|
||
|
|
changed pages.</li>
|
||
|
|
<li><code>editpage.tmpl</code>, <code>editconflict.tmpl</code>, <code>editcreationconflict.tmpl</code>,
|
||
|
|
<code>editfailedsave.tmpl</code>, <code>editpagegone.tmpl</code>, <code>pocreatepage.tmpl</code>,
|
||
|
|
<code>editcomment.tmpl</code> <code>commentmoderation.tmpl</code>, <code>renamesummary.tmpl</code>,
|
||
|
|
<code>passwordmail.tmpl</code>, <code>emailauth.tmpl</code>, <code>login-selector.tmpl</code>,
|
||
|
|
<code>revert.tmpl</code> - Parts of ikiwiki's user interface; do not normally need
|
||
|
|
to be customised.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</div> <!-- /container -->
|
||
|
|
</main>
|
||
|
|
|
||
|
|
<footer class="footer mt-auto py-2 bg-light" role="contentinfo">
|
||
|
|
<div class="container">
|
||
|
|
<p class="text-muted">
|
||
|
|
<div class="container">
|
||
|
|
<div class="row">
|
||
|
|
<div class="col-sm-3">
|
||
|
|
<h5>Support</h5>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="https://support.ilot.io/en/hc/706927618">FAQs</a></li>
|
||
|
|
<li><a href="https://forge.ilot.io/ilot/-/projects/3">Known issues</a></li>
|
||
|
|
<li><a href="https://support.ilot.io/help/706927618">Support ticket</a></li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="col-sm-3">
|
||
|
|
<h5>Contribute</h5>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="../join/index.en.html">Become a member</a>
|
||
|
|
<li><a href="https://forge.ilot.io/ilot/-/projects">Git Forge</a></li>
|
||
|
|
<li><a href="https://wiki.ilot.io">Wiki</a></li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="col-sm-3">
|
||
|
|
<h5>About us</h5>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="../meta/code-of-conduct/">Code of conduct</a></li>
|
||
|
|
<li><a href="../meta/license/">Licenses</a></li>
|
||
|
|
<li><a href="https://status.ilot.io/status/ilot">Network Status</a></li>
|
||
|
|
</div>
|
||
|
|
<div class="col-sm-3 listmonk-form">
|
||
|
|
<h5>News</h5>
|
||
|
|
|
||
|
|
<p>Subscribe to our <a href="https://notif.ilot.io/archive">newsletter</a></p>
|
||
|
|
|
||
|
|
<form method="post" action="https://notif.ilot.io/subscription/form" class="listmonk-form">
|
||
|
|
|
||
|
|
<input type="hidden" name="nonce" />
|
||
|
|
<input id="9c490" type="hidden" name="l" value="9c490957-b50b-4162-898d-92259e350cd6" />
|
||
|
|
<div class="t">
|
||
|
|
<input aria-label="Email" class="btn" type="email" name="email" required placeholder="E-mail" />
|
||
|
|
</div>
|
||
|
|
<button aria-label="Subscribe" class="btn" type="submit">Subscribe</button>
|
||
|
|
</form>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</footer>
|
||
|
|
|
||
|
|
<!-- Bootstrap core JavaScript
|
||
|
|
================================================== -->
|
||
|
|
<!-- Placed at the end of the document so the pages load faster -->
|
||
|
|
<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.6/dist/umd/popper.min.js" integrity="sha384-oBqDVmMz9ATKxIep9tiCxS/Z9fNfEXiDAYTujMAeBAsjFuCZSmKbSSUnQlmh/jp3" crossorigin="anonymous"></script>
|
||
|
|
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/js/bootstrap.bundle.min.js" integrity="sha384-kenU1KFdBIe4zVF0s0G1M5b4hcpxyD9F7jL+jjXkk+Q2h455rYXK/7HAuoJl+0I4" crossorigin="anonymous"></script>
|
||
|
|
|
||
|
|
<!-- TODO: Find other ways to setup analytics
|
||
|
|
<script data-goatcounter="https://analytics.anarc.at/count" async src="//analytics.anarc.at/count.js"></script>
|
||
|
|
<noscript>
|
||
|
|
<img src="https://analytics.anarc.at/count?p=templates&t=templates" alt="tracking pixel to count visitors when Javascript is disabled" />
|
||
|
|
</noscript>
|
||
|
|
-->
|
||
|
|
</body>
|
||
|
|
</html>
|