Add meta descriptions to all website pages for search engines

Author: Tremeschin

.github/workflows/website.yml

@@ -3,9 +3,9 @@ on:
   workflow_dispatch:
   push:
     paths:
-      - "website/**"
       - "readme.md"
-      - "zensical.md"
+      - "website/**"
+      - "zensical.toml"
   schedule:
     - cron: "0 0 * * 5"
 

readme.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/BrokenSource/DepthFlow/main/website/assets/logo.svg" width="200">
+  <img src="https://raw.githubusercontent.com/BrokenSource/DepthFlow/main/website/assets/logo.svg" width="200" alt="Project logo">
   <h1>DepthFlow</h1>
   <span>🌊 Images to 3D parallax effect videos 🌊</span>
   <br><br>
@@ -11,7 +11,7 @@
   <br>
 </div>
 
-<video src="https://github.com/user-attachments/assets/a67632a3-5528-453b-843a-120a65cc480e" loop controls autoplay></video>
+<video src="https://github.com/user-attachments/assets/a67632a3-5528-453b-843a-120a65cc480e" alt="DepthFlow landing video showcase" loop controls autoplay></video>
 
 ## 🔥 Description
 
@@ -26,7 +26,7 @@
 
 <div align="center">
   <a href="https://depth.tremeschin.com/">
-    <img src="https://github.com/user-attachments/assets/d794899f-d7c9-4318-9038-9ec356c85e2d"/>
+    <img src="https://github.com/user-attachments/assets/d794899f-d7c9-4318-9038-9ec356c85e2d" alt="DepthFlow website preview"/>
   </a>
   <i>
     Visit the documentation at

website/changelog.md

@@ -1,6 +1,8 @@
 ---
 title: Changelog
 icon: material/file-document-edit
+description: Changelog page for the DepthFlow project. Detailed history of software
+  updates, feature improvements, infrastructure changes, and breaking changes.
 tags:
 - About
 - Changelog

website/community.md

@@ -1,6 +1,8 @@
 ---
 title: Community
 icon: material/recycle
+description: Explore community integrations for DepthFlow including a dedicated repository
+  for ComfyUI-Depthflow-Nodes to integrate the tool into ComfyUI workflows.
 ---
 
 ## ComfyUI

website/docs/animation.md

@@ -1,6 +1,8 @@
 ---
 title: Animation
 icon: material/animation-play
+description: Create 3D parallax animations by extending the DepthScene class to modify
+  Camera parameters over time using temporal and projection variables.
 tags:
 - Documentation
 - Animations

website/docs/camera.md

@@ -1,6 +1,8 @@
 ---
 title: Camera
 icon: octicons/device-camera-video-16
+description: Learn how to adjust 3D parallax effects using camera parameters like
+  Height, Offset, Steady, Isometric, Dolly, Focus, Quality, Zoom, Center, and Origin.
 tags:
 - Documentation
 - Camera
@@ -25,7 +27,7 @@ This page talks about the parallax projection parameters and their effects. Most
 Controls the scale factor of the projection surface growing towards the camera, acting like a global parallax intensity scalar. When depth maps are normalized:
 
 - A value of (0) zero generates no 3D displacements, the surface is flat at z=1.
-- A value of (1) one makes the surface's peak be on the same xy plane as the camera.    
+- A value of (1) one makes the surface's peak be on the same xy plane as the camera.
 - Note how in the video, the center doesn't touch the camera, as its relative depth value isn't 1, but the closer bottom edge _"gets below"_ the camera's view - where the peak is.
 
 <video loop controls src="https://github.com/user-attachments/assets/d388e725-2fb9-445e-b51d-3a63d60a6943"></video>

website/docs/estimators.md

@@ -1,6 +1,8 @@
 ---
 title: Estimators
 icon: material/magnify-scan
+description: Compilation of recommendations and support for various community monocular
+  depth estimation models, using them on a scene or standalone via wrappers.
 tags:
 - Documentation
 - Estimators

website/docs/exporting.md

@@ -1,6 +1,8 @@
 ---
 title: Exporting
 icon: octicons/video-16
+description: Export animations as high-quality videos using DepthFlow, single or batch,
+  and guides on optimizing final quality with supersampling, encoders, depthmaps
 tags:
 - Documentation
 - Exporting
@@ -49,6 +51,13 @@ scene.main(
 )
 ```
 
+## Batch
+
+For exporting multiple videos, you can follow something similar to the <a href="https://github.com/BrokenSource/DepthFlow/blob/main/examples/batch.py"><code>batch.py</code></a> example script, where a scene is reused on many renders over globbing image directories - some notes:
+
+- Always initialize the scene with a `backend=headless` for compatibility.
+- Always reset the scene's state before rendering again, as the previous animation ending could leave changes in the camera parameters a second animation doesn't enforce.
+
 ## Codec
 
 Very large topic, until ShaderFlow documentation is written, you can:

website/docs/index.md

@@ -1,5 +1,7 @@
 ---
 title: Documentation
+description: Overview of DepthFlow documentation including recommendations to also reference
+  the ShaderFlow project documentation, as it is the core engine behind rendering pipeline.
 tags:
 - Meta
 - Documentation

website/docs/inputs.md

@@ -1,6 +1,8 @@
 ---
 title: Inputs
 icon: material/image-area
+description: Use your own images or depthmaps in DepthFlow to make animations, via Python
+  methods or CLI, including guidelines for visual quality, automatic estimation.
 tags:
 - Documentation
 - Image
@@ -71,4 +73,3 @@ And also three main types of values:
 - **Normalized**: Values are in a 0-1 range, loses proportions.
 
 DepthFlow uses _normalized_, _near is white_ values in its [:octicons-device-camera-video-16: Camera](./camera.md) parameters.
-