237 lines
9.7 KiB
HTML
237 lines
9.7 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 - Ayakael</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" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<meta name="robots" content="noindex, follow" />
|
|
|
|
|
|
</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="Ayakael" 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="https://ayakael.net/forge/">Forge</a></li>
|
|
<li><a href="../contact/index.en.html">Contact</a></li>
|
|
</ul>
|
|
|
|
<ul class="navbar-nav nav-link align-items-center ms-auto">
|
|
|
|
</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><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.
|
|
(The <a href="http://ikiwiki.info/ikiwiki/directive/pagetemplate/">pagetemplate directive</a>
|
|
can be used to make a page use a different template than <code>page.tmpl</code>.)</li>
|
|
<li><code>rsspage.tmpl</code> - Used for generating rss feeds for blogs.</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>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- legacy Ikiwiki comments.pm section -->
|
|
|
|
|
|
<!-- Mastodon comments -->
|
|
|
|
|
|
<div class="pagedate text-muted">
|
|
<span class="created">Created <time datetime="2024-06-21T02:57:06Z" class="dt-published">Fri Jun 21 02:57:06 2024</time>.</span>
|
|
<span class="edited">
|
|
|
|
Edited <time datetime="2024-06-21T02:57:06Z">Fri Jun 21 02:57:06 2024</time>.
|
|
|
|
</span>
|
|
</div>
|
|
|
|
</div> <!-- /container -->
|
|
</main>
|
|
|
|
<footer class="footer mt-auto bg-light py-2" role="contentinfo">
|
|
<div class="container">
|
|
<div class="row text-muted">
|
|
<div class="col-sm">
|
|
Copyleft © 2024 ayakael <a href="../meta/license/">CC-BY-SA</a>
|
|
</div>
|
|
<div class="col-sm text-sm-end">
|
|
Powered by <a href="http://ikiwiki.info/">ikiwiki</a>.
|
|
</div>
|
|
</div>
|
|
|
|
</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>
|