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/.view |  1 +
 localhost:8080/docs/index | 12 ++++++++++++
 localhost:8080/docs/view  |  3 +++
 3 files changed, 16 insertions(+)
 create mode 100644 localhost:8080/docs/.view
 create mode 100644 localhost:8080/docs/index
 create mode 100644 localhost:8080/docs/view

(limited to 'localhost:8080/docs')

diff --git a/localhost:8080/docs/.view b/localhost:8080/docs/.view
new file mode 100644
index 0000000..d8c8fec
--- /dev/null
+++ b/localhost:8080/docs/.view
@@ -0,0 +1 @@
+<p>This directory holds a few notes about <em>site</em> concepts.</p>
\ No newline at end of file
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
diff --git a/localhost:8080/docs/view b/localhost:8080/docs/view
new file mode 100644
index 0000000..ced1356
--- /dev/null
+++ b/localhost:8080/docs/view
@@ -0,0 +1,3 @@
+<h3><code>.view</code> is the default page rendered in a directory</h3>
+
+<p>It can be used to provide a summary of what to expect in the subdirectories</p>
\ No newline at end of file
-- 
cgit v1.2.3