examples: Improve webpage generation in various ways, add thumbnails, etc.

2024-12-05 23:54:48 -05:00
parent e50dc7265b
commit 90efb63e52
53 changed files with 118 additions and 38 deletions
--- a/examples/asyncio/01-load-bitmaps/thumbnail.png
+++ b/examples/asyncio/01-load-bitmaps/thumbnail.png
--- a/examples/asyncio/description.txt
+++ b/examples/asyncio/description.txt
@@ -0,0 +1 @@
+Asynchronous I/O
--- a/examples/audio/onmouseover.webp
+++ b/examples/audio/onmouseover.webp
--- a/examples/audio/thumbnail.png
+++ b/examples/audio/thumbnail.png
--- a/examples/camera/01-read-and-draw/onmouseover.webp
+++ b/examples/camera/01-read-and-draw/onmouseover.webp
--- a/examples/camera/01-read-and-draw/thumbnail.png
+++ b/examples/camera/01-read-and-draw/thumbnail.png
--- a/examples/categories.txt
+++ b/examples/categories.txt
@@ -0,0 +1,13 @@
+# Blank lines and lines that start with '#' in this file are ignored.
+
+# Categories, by directory name, go in here, in the order they should be
+# listed on the main page. If this file is missing, it'll assume any
+# subdirectory is a category and sort them alphabetically.
+
+renderer
+input
+audio
+camera
+asyncio
+pen
+demo
--- a/examples/demo/01-snake/onmouseover.webp
+++ b/examples/demo/01-snake/onmouseover.webp
--- a/examples/demo/01-snake/thumbnail.png
+++ b/examples/demo/01-snake/thumbnail.png
--- a/examples/demo/02-woodeneye-008/onmouseover.webp
+++ b/examples/demo/02-woodeneye-008/onmouseover.webp
--- a/examples/demo/02-woodeneye-008/thumbnail.png
+++ b/examples/demo/02-woodeneye-008/thumbnail.png
--- a/examples/demo/03-infinite-monkeys/onmouseover.webp
+++ b/examples/demo/03-infinite-monkeys/onmouseover.webp
--- a/examples/demo/03-infinite-monkeys/thumbnail.png
+++ b/examples/demo/03-infinite-monkeys/thumbnail.png
--- a/examples/demo/04-bytepusher/onmouseover.webp
+++ b/examples/demo/04-bytepusher/onmouseover.webp
--- a/examples/demo/04-bytepusher/thumbnail.png
+++ b/examples/demo/04-bytepusher/thumbnail.png
--- a/examples/demo/description.txt
+++ b/examples/demo/description.txt
@@ -0,0 +1 @@
+Full game and app demos
--- a/examples/input/01-joystick-polling/onmouseover.webp
+++ b/examples/input/01-joystick-polling/onmouseover.webp
--- a/examples/input/01-joystick-polling/thumbnail.png
+++ b/examples/input/01-joystick-polling/thumbnail.png
--- a/examples/input/02-joystick-events/onmouseover.webp
+++ b/examples/input/02-joystick-events/onmouseover.webp
--- a/examples/input/02-joystick-events/thumbnail.png
+++ b/examples/input/02-joystick-events/thumbnail.png
--- a/examples/pen/01-drawing-lines/onmouseover.webp
+++ b/examples/pen/01-drawing-lines/onmouseover.webp
--- a/examples/pen/01-drawing-lines/thumbnail.png
+++ b/examples/pen/01-drawing-lines/thumbnail.png
--- a/examples/renderer/01-clear/onmouseover.webp
+++ b/examples/renderer/01-clear/onmouseover.webp
--- a/examples/renderer/01-clear/thumbnail.png
+++ b/examples/renderer/01-clear/thumbnail.png
--- a/examples/renderer/02-primitives/thumbnail.png
+++ b/examples/renderer/02-primitives/thumbnail.png
--- a/examples/renderer/03-lines/onmouseover.webp
+++ b/examples/renderer/03-lines/onmouseover.webp
--- a/examples/renderer/03-lines/thumbnail.png
+++ b/examples/renderer/03-lines/thumbnail.png
--- a/examples/renderer/04-points/onmouseover.webp
+++ b/examples/renderer/04-points/onmouseover.webp
--- a/examples/renderer/04-points/thumbnail.png
+++ b/examples/renderer/04-points/thumbnail.png
--- a/examples/renderer/05-rectangles/onmouseover.webp
+++ b/examples/renderer/05-rectangles/onmouseover.webp
--- a/examples/renderer/05-rectangles/thumbnail.png
+++ b/examples/renderer/05-rectangles/thumbnail.png
--- a/examples/renderer/06-textures/onmouseover.webp
+++ b/examples/renderer/06-textures/onmouseover.webp
--- a/examples/renderer/06-textures/thumbnail.png
+++ b/examples/renderer/06-textures/thumbnail.png
--- a/examples/renderer/07-streaming-textures/onmouseover.webp
+++ b/examples/renderer/07-streaming-textures/onmouseover.webp
--- a/examples/renderer/07-streaming-textures/thumbnail.png
+++ b/examples/renderer/07-streaming-textures/thumbnail.png
--- a/examples/renderer/08-rotating-textures/onmouseover.webp
+++ b/examples/renderer/08-rotating-textures/onmouseover.webp
--- a/examples/renderer/08-rotating-textures/thumbnail.png
+++ b/examples/renderer/08-rotating-textures/thumbnail.png
--- a/examples/renderer/09-scaling-textures/onmouseover.webp
+++ b/examples/renderer/09-scaling-textures/onmouseover.webp
--- a/examples/renderer/09-scaling-textures/thumbnail.png
+++ b/examples/renderer/09-scaling-textures/thumbnail.png
--- a/examples/renderer/10-geometry/onmouseover.webp
+++ b/examples/renderer/10-geometry/onmouseover.webp
--- a/examples/renderer/10-geometry/thumbnail.png
+++ b/examples/renderer/10-geometry/thumbnail.png
--- a/examples/renderer/11-color-mods/onmouseover.webp
+++ b/examples/renderer/11-color-mods/onmouseover.webp
--- a/examples/renderer/11-color-mods/thumbnail.png
+++ b/examples/renderer/11-color-mods/thumbnail.png
--- a/examples/renderer/14-viewport/thumbnail.png
+++ b/examples/renderer/14-viewport/thumbnail.png
--- a/examples/renderer/15-cliprect/onmouseover.webp
+++ b/examples/renderer/15-cliprect/onmouseover.webp
--- a/examples/renderer/15-cliprect/thumbnail.png
+++ b/examples/renderer/15-cliprect/thumbnail.png
--- a/examples/renderer/17-read-pixels/onmouseover.webp
+++ b/examples/renderer/17-read-pixels/onmouseover.webp
--- a/examples/renderer/17-read-pixels/thumbnail.png
+++ b/examples/renderer/17-read-pixels/thumbnail.png
--- a/examples/renderer/18-debug-text/thumbnail.png
+++ b/examples/renderer/18-debug-text/thumbnail.png
--- a/examples/template-category.html
+++ b/examples/template-category.html
@@ -4,7 +4,7 @@
    <meta charset="utf-8" />
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>@project_name@ Examples: @category_name@</title>
+    <title>@project_name@ Examples: @category_description@</title>
    <link
      rel="stylesheet"
      type="text/css"
@@ -18,7 +18,7 @@
  </head>
  <body>
    <header>
-      <a href="/">SDL Examples</a>
+      <a href="/">@project_name@ Examples</a>
    </header>
    <main>
      <nav class="breadcrumb">
@@ -27,7 +27,7 @@
          <li><a href="/@project_name@/@category_name@">@category_name@</a></li>
        </ul>
      </nav>
-      <h1>@project_name@ examples: @category_name@</h1>
+      <h1>@project_name@ examples: @category_description@</h1>
      <div class="list">@examples_list_html@</div>
    </main>
  </body>
--- a/examples/template-homepage.html
+++ b/examples/template-homepage.html
@@ -28,8 +28,6 @@
      </nav>
      <h1>@project_name@ examples</h1>

-      <p>Check out the @project_name@ examples here!</p>
-
      @homepage_list_html@
    </main>
  </body>
--- a/examples/template-placeholder.png
+++ b/examples/template-placeholder.png