From 1ccd4c87136091e7a71f05c8660849552e0dba36 Mon Sep 17 00:00:00 2001
From: Alejandro Sior <aho@sior.be>
Date: Wed, 31 Aug 2022 20:28:57 +0200
Subject: site: add the basis

---
 localhost:8080/docs/index | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 localhost:8080/docs/index

(limited to 'localhost:8080/docs/index')

diff --git a/localhost:8080/docs/index b/localhost:8080/docs/index
new file mode 100644
index 0000000..30610a5
--- /dev/null
+++ b/localhost:8080/docs/index
@@ -0,0 +1,12 @@
+<h3><code>.index</code> is the template of children pages in the subtree</h3>
+
+<p>When a directory contains a file named <code>.index</code>, all files in children directories are going to use it as template.</p>
+
+<p>An <code>.index</code> file is a normal html file, except that a few templates get replaced by the server generated content:
+<ul>
+<li><code>{&zwnj;{ post }}</code> gets replaced by the content of the post resolved by the HTML path</li>
+<li><code>{&zwnj;{ nav }}</code> gets replaced by the server generated navbar, which is to be placed anywhere. This template places it next to the title</li>
+</ul>
+</p>
+
+<p>The role of <code>.index</code> is thus to structure and composite in a relatively minimalistic manner the componants that make up a page of the site.</p>
\ No newline at end of file
-- 
cgit v1.2.3