ilot-io/ikiwiki/directive/index.html

232 lines
8.6 KiB
HTML
Raw Permalink Normal View History

2024-09-17 19:02:39 +00:00
<!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>directive - 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-md navbar-light bg-light border">
2024-09-17 19:02:39 +00:00
<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>
2024-10-08 19:09:03 +00:00
<li class="btn p-0 border sign-in"><a href="https://ilot.io/apps/files">Your Files</a></li>
2024-09-17 19:02:39 +00:00
</ul>
<ul class="nav navbar-nav">
</ul>
</div>
</div>
</nav>
</header>
<main class="flex-shrink-0">
<div class="container" id="content">
<p>Directives are similar to a <a href="../wikilink/">WikiLink</a> in form, except they
begin with <code>!</code> and may contain parameters. The general form is:</p>
<pre><code>[[!directive param="value" param="value"]]
</code></pre>
<p>This gets expanded before the rest of the page is processed, and can be used
to transform the page in various ways.</p>
<p>The quotes around values can be omitted if the value is a simple word.
Also, some directives may use parameters without values, for example:</p>
<pre><code>[[!tag foo]]
</code></pre>
<p>A directive does not need to all be on one line, it can be
wrapped to multiple lines if you like:</p>
<pre><code>[[!directive foo="baldersnatch"
bar="supercalifragilisticexpialidocious" baz=11]]
</code></pre>
<p>Also, multiple lines of <em>quoted</em> text can be used for a value.
To allow quote marks inside the quoted text, delimit the block
of text with triple-double-quotes or triple-single-quotes:</p>
<pre><code>[[!directive text="""
1. "foo"
2. "bar"
3. "baz"
""" othertext='''
1. 'quux'
2. "foo"
''']]
</code></pre>
<p>If you want to put text with triple quotes into a parameter value, you can
use perl-style here-doc syntax, even nesting it like this:</p>
<pre><code>[[!directive text=&lt;&lt;OUTER
[[!otherdirective &lt;&lt;INNER
inner text
INNER]]
outer text
OUTER]]
</code></pre>
<p>ikiwiki also has an older syntax for directives, which requires a space in
directives to distinguish them from <a href="../wikilink/">wikilinks</a>. This
syntax has several disadvantages: it requires a space after directives with
no parameters (such as <code>[[pagecount ]]</code>), and it prohibits spaces in
<a href="../wikilink/">wikilinks</a>. ikiwiki now provides the <code>!</code>-prefixed
syntax shown above as default. However, ikiwiki still supports wikis using
the older syntax, if the <code>prefix_directives</code> option is disabled.</p>
</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://opencollective.com/ilot">Donate</a></li>
2024-09-17 19:02:39 +00:00
<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">
2025-03-13 21:41:16 +00:00
<!-- Converts enter key to tab -->
<script>
document.addEventListener('keydown', function (event) {
if (event.keyCode === 13 && event.target.nodeName === 'INPUT') {
var form = event.target.form;
var index = Array.prototype.indexOf.call(form, event.target);
form.elements[index + 1].focus();
event.preventDefault();
}
});
</script>
<input type="hidden" name="nonce" />
2025-03-23 20:10:03 +00:00
<input id="39425" type="hidden" name="l" value="39425113-44b5-46f7-9897-91151467b05f" />
2025-03-13 21:41:16 +00:00
<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="button" data-bs-toggle="modal" data-bs-target="#hcaptchamodal">Subscribe</button>
<div class="modal fade" id="hcaptchamodal" tabindex="-1" aria-labelledby="haptcha" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="hcapatchamodallabel">Are you a robot?</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<div class="h-captcha" data-sitekey="be08a59e-ae24-472e-8a80-22d07016ee90" data-callback="submitSubscribe"></div>
<script src="https://js.hcaptcha.com/1/api.js" async defer></script>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
<button aria-label="Subscribe" class="btn" type="submit">Subscribe</button>
</div>
</div>
</div>
</div>
2024-09-17 19:02:39 +00:00
</form>
2025-03-13 21:41:16 +00:00
2024-09-17 19:02:39 +00:00
</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=ikiwiki/directive&t=directive" alt="tracking pixel to count visitors when Javascript is disabled" />
</noscript>
-->
</body>
</html>