Make definition of docs sections optional #3

content/docs/config/index.md

@@ -20,7 +20,7 @@ The following configuration variables from `config.toml` can be set/overridden p
 - `toc_inline`: Whether to render inline table of contents at the top of all pages, in addition to floating quick navigation buttons.
 - `toc_ordered`: Whether to use numbered (ordered) list for table of contents.
 
-The following variables can be set in the `config.tom` file:
+The following variables can be set in the `config.toml` file:
 
 - `apple_touch_icon`: Filename of the [colocated](https://www.getzola.org/documentation/content/overview/#asset-colocation) Apple Touch Icon.
 - `favicon`: Filename of the [colocated](https://www.getzola.org/documentation/content/overview/#asset-colocation) favicon.

content/docs/docs/index.md

@@ -31,8 +31,9 @@ Use the following syntax:
 ```toml
 [extra]
 sections = [
-  "Usage", # Section 1
-  "Extra"  # Section 2
+  "Usage",    # Section 1
+  "Markdown", # Section 2
+  "Advanced"  # Section 3
 ]
 ```
 

static/card.svg

@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="1200mm"
+   height="628mm"
+   viewBox="0 0 1200 628"
+   version="1.1"
+   id="svg1"
+   inkscape:version="1.4 (e7c3feb100, 2024-10-09)"
+   sodipodi:docname="card.svg"
+   inkscape:export-filename="card.png"
+   inkscape:export-xdpi="25.4"
+   inkscape:export-ydpi="25.4"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview1"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="mm"
+     inkscape:zoom="0.07276804"
+     inkscape:cx="2253.7367"
+     inkscape:cy="1745.2717"
+     inkscape:window-width="1202"
+     inkscape:window-height="743"
+     inkscape:window-x="26"
+     inkscape:window-y="23"
+     inkscape:window-maximized="0"
+     inkscape:current-layer="layer1" />
+  <defs
+     id="defs1">
+    <linearGradient
+       id="linearGradient1"
+       inkscape:collect="always">
+      <stop
+         style="stop-color:#fc004f;stop-opacity:1;"
+         offset="0"
+         id="stop1" />
+      <stop
+         style="stop-color:#fe0073;stop-opacity:1;"
+         offset="1"
+         id="stop2" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient1"
+       id="linearGradient2"
+       x1="80.644943"
+       y1="-2.620512"
+       x2="1063.0137"
+       y2="658.26202"
+       gradientUnits="userSpaceOnUse" />
+  </defs>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <rect
+       style="fill:url(#linearGradient2);stroke-width:0.264583"
+       id="rect1"
+       width="1227.4141"
+       height="664.46155"
+       x="-1.0510273"
+       y="-11.334039"
+       ry="2.5378413" />
+  </g>
+</svg>

templates/partials/docs_toc.html

@@ -7,22 +7,26 @@
 <div id="docs">
 	<ul>
 	{%- for page in section.pages %}
-		{%- if page.extra.section == 0 %}
-			<li>
-				<a class="{%- if slug == page.slug -%}active{%- endif -%}" href="{{ page.permalink | safe }}">{{ page.title }}</a>
-			</li>
+		{%- if page.extra.section %}
+			{%- if page.extra.section == 0 %}
+				{% include "partials/docs_toc_item.html" %}
+			{%- endif %}
+		{%- else %}
+			{% include "partials/docs_toc_item.html" %}
 		{%- endif %}
 	{%- endfor %}
-	{%- for section in section.extra.sections %}
-		{% set int_section = loop.index %}
-		<h3>{{ section }}</h3>
-		{%- for page in section.pages %}
-			{%- if page.extra.section == int_section %}
-				<li>
-					<a class="{%- if slug == page.slug -%}active{%- endif -%}" href="{{ page.permalink | safe }}">{{ page.title }}</a>
-				</li>
-			{%- endif %}
-		{%- endfor %}
-	{% endfor %}
+	{%- if section.extra.sections %}
+		{%- for section in section.extra.sections %}
+			{% set int_section = loop.index %}
+			<h3>{{ section }}</h3>
+			{%- for page in section.pages %}
+				{%- if page.extra.section %}
+					{%- if page.extra.section == int_section %}
+						{% include "partials/docs_toc_item.html" %}
+					{%- endif %}
+				{%- endif %}
+			{%- endfor %}
+		{% endfor %}
+	{%- endif %}
 	</ul>
 </div>

templates/partials/docs_toc_item.html

@@ -0,0 +1,3 @@
+<li>
+	<a class="{%- if slug == page.slug -%}active{%- endif -%}" href="{{ page.permalink | safe }}">{{ page.title }}</a>
+</li>