#14 add more content

hosts/demo/content/installation/index.md

@@ -47,7 +47,7 @@ Default markdown engine is _flexmark_.
 hostname: localhost
 template:
   engine: thymeleaf
-markdownd:
+markdown:
   engine: flexmark
 ```
 

hosts/demo/content/templating/index.md

@@ -1,6 +1,6 @@
 ---
 title: Templates & Engines
-template: start.html
+template: content.html
 menu: 
     title: Templating
     position: 20
@@ -12,4 +12,6 @@ Aktuell kann zwischen folgenden TemplateEngines zur Verfügung.
 
 * [Thymeleaf](https://thymeleaf.org)
 * [Pebble](https://pebbletemplates.io/)
-* [Apache Freemarker](https://freemarker.apache.org/)
+* [Apache Freemarker](https://freemarker.apache.org/)
+
+For information about configuration of template engien to be used see the [per host config](/installation#per-host-config)

hosts/demo/content/templating/index.part.01.md

@@ -0,0 +1,17 @@
+---
+title: Navigation
+template: content.part.html
+---
+
+Navigation is realy simple.
+
+```html
+<ul th:with="nodes=${navigation.list('/')}">
+    <li th:each="node : ${nodes}" th:if="${node.path} != '/'">
+        <a th:attr="aria-current=${node.current ? 'page' : ''}"
+            th:classappend="${node.current}? 'active'"
+            th:href="${node.path}"
+			th:text="${node.name}"></a>
+	</li>
+</ul>
+```

hosts/demo/content/templating/index.part.02.md

@@ -0,0 +1,35 @@
+---
+title: List of pages
+template: content.part.html
+---
+
+Whenever you want to print out a list of pages, the nodeListFunction is a tiny little helper.  
+Keep in mind, that the nodelist function does not return the hole rendered HTML content but just an excerpt of 200 characters.
+
+```html
+<!-- example for a blog overview page  -->
+<div
+	th:with='page = ${nodeList.from("/blog/*").sort("published").reverse(true).page(1).size(5).list()}'>
+	<th:block th:each="entry : ${page.items}">
+		<h2 th:text="${entry.name}"></h2>
+		<p th:text="${entry.content}"></p>
+		<u th:text="${#dates.format(entry.meta['published'], 'dd-MM-yyyy HH:mm')}"></u>
+		<a th:href="${entry.path}">goto</a>
+	</th:block>
+</div>
+```
+
+#### UseCase Blog
+Assume, your project has the following content structure for the blog, with the defaults _page = 1_ and _pageSize = 5_
+```
+blog/
+---2023-09/
+------entry1.md
+------entry2.md
+---2023-10/
+------entry1.md
+```
+This nodeList call will return all content nodes in all subfolders of the folder blog/
+```javascript
+${nodeList.from("/blog/*").list()}
+```

hosts/demo/templates/content.part.html

@@ -2,6 +2,6 @@
   <div class="card-body">
     <h5 class="card-title" th:text="${meta.title}"></h5>
     <p class="card-text" th:utext="${content}"></p>
-    <a href="#" class="card-link">readmore</a>
+    <!--a href="#" class="card-link">readmore</a-->
   </div>
 </div>

hosts/demo/templates/libs/header.html

@@ -22,7 +22,7 @@
 				<span class="navbar-toggler-icon"></span>
 			</button>
 			<div class="collapse navbar-collapse" id="navbarScroll">
-				<ul th:with="nodes=${navigation.list('/', 0)}" class="navbar-nav me-auto my-2 my-lg-0 navbar-nav-scroll"
+				<ul th:with="nodes=${navigation.list('/')}" class="navbar-nav me-auto my-2 my-lg-0 navbar-nav-scroll"
 					style="--bs-scroll-height: 100px;">
 					<li th:each="node : ${nodes}" th:if="${node.path} != '/'" class="nav-item">
 						<a th:attr="aria-current=${node.current ? 'page' : ''}"

pom.xml

@@ -49,6 +49,11 @@
 			<artifactId>flexmark-ext-tables</artifactId>
 			<version>0.64.8</version>
 		</dependency>
+		<dependency>
+			<groupId>com.vladsch.flexmark</groupId>
+			<artifactId>flexmark-ext-anchorlink</artifactId>
+			<version>0.64.8</version>
+		</dependency>
 		<dependency>
 			<groupId>org.freemarker</groupId>
 			<artifactId>freemarker</artifactId>

src/main/java/com/github/thmarx/cms/markdown/FlexMarkMarkdownRenderer.java

@@ -20,6 +20,7 @@
  * #L%
  */
 
+import com.vladsch.flexmark.ext.anchorlink.AnchorLinkExtension;
 import com.vladsch.flexmark.ext.tables.TablesExtension;
 import com.vladsch.flexmark.html.HtmlRenderer;
 import com.vladsch.flexmark.parser.Parser;
@@ -40,7 +41,8 @@ public class FlexMarkMarkdownRenderer implements MarkdownRenderer {
 
 	public FlexMarkMarkdownRenderer () {
 		options.set(Parser.EXTENSIONS, List.of(
-				TablesExtension.create()
+				TablesExtension.create(),
+				AnchorLinkExtension.create()
 		));
 		parser = Parser.builder(options).build();
         renderer = HtmlRenderer.builder(options).build();