summaryrefslogtreecommitdiff
path: root/localhost:8080/docs
diff options
context:
space:
mode:
Diffstat (limited to 'localhost:8080/docs')
-rw-r--r--localhost:8080/docs/.view1
-rw-r--r--localhost:8080/docs/index12
-rw-r--r--localhost:8080/docs/view3
3 files changed, 16 insertions, 0 deletions
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