Tile API Update

documentation/docs/about/coverage-report/index.html

@@ -47,7 +47,7 @@ <h1>Coverage report:
         </form>
         <p class="text">
             <a class="nav" href="https://coverage.readthedocs.io">coverage.py v7.1.0</a>,
-            created at 2023-01-31 04:48 +0000
+            created at 2023-02-02 22:00 +0000
         </p>
     </div>
 </header>
@@ -158,7 +158,7 @@ <h1>Coverage report:
     <div class="content">
         <p>
             <a class="nav" href="https://coverage.readthedocs.io">coverage.py v7.1.0</a>,
-            created at 2023-01-31 04:48 +0000
+            created at 2023-02-02 22:00 +0000
         </p>
     </div>
     <aside class="hidden">

documentation/docs/configuration/palettes/dark.md

@@ -3,18 +3,18 @@ show_tiles_inline: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of green moss on a log.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'overhead of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/
 ---
 

documentation/docs/configuration/palettes/default.md

@@ -3,18 +3,18 @@ show_tiles_inline: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of green moss on a log.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'overhead of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/
 ---
 

documentation/docs/configuration/palettes/gruvbox-dark.md

@@ -3,18 +3,18 @@ show_tiles_inline: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of green moss on a log.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'overhead of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/
 ---
 

documentation/docs/configuration/palettes/index.md

@@ -1,35 +1,35 @@
 ---
 show_tiles_first: true
 tiles:
-  - caption: <a id="fnref:1" class="footnote-ref" title="to image description" alt="to long image description" href="#fn:1">Default</a>
+  - caption: <a id="fnref:1" class="footnote-ref" title="to image description" alt="to Default palette description." href="#fn:1">Default</a>
     img_src: ../../img/palettes/default.png
-    img_title: to Default Demo Page 
-    img_alt: Default Demo Page
+    tooltip: to Default Demo Page 
+    alt_text: Default Demo Page
     link_href: ./default/
-  - caption: <a id="fnref:2" class="footnote-ref" title="to image description" alt="to long image description" href="#fn:2">Gruvbox Dark</a>
+  - caption: <a id="fnref:2" class="footnote-ref" title="to image description" alt="to Gruvbox Dark palette description." href="#fn:2">Gruvbox Dark</a>
     img_src: ../../img/palettes/gruvbox_dark.png
-    img_title: to Gruvbox Dark Demo Page
-    img_alt: Gruvbox Dark Demo Page
+    tooltip: to Gruvbox Dark Demo Page
+    alt_text: Gruvbox Dark Demo Page
     link_href: ./gruvbox-dark/
-  - caption: <a id="fnref:3" class="footnote-ref" title="to image description" alt="to long image description" href="#fn:3">Dark</a>
+  - caption: <a id="fnref:3" class="footnote-ref" title="to image description" alt="to Dark palette description." href="#fn:3">Dark</a>
     img_src: ../../img/palettes/dark.png
-    img_title: to Dark Demo Page 
-    img_alt: Dark Demo Page
+    tooltip: to Dark Demo Page 
+    alt_text: Dark Demo Page
     link_href: ./dark/    
-  - caption: <a id="fnref:4" class="footnote-ref" title="to image description" alt="to long image description" href="#fn:4">Pink</a>
+  - caption: <a id="fnref:4" class="footnote-ref" title="to image description" alt="to Pink palette description." href="#fn:4">Pink</a>
     img_src: ../../img/palettes/pink.png
-    img_title: to Pink Demo Page
-    img_alt: Pink Demo Page
+    tooltip: to Pink Demo Page
+    alt_text: Pink Demo Page
     link_href: ./pink/        
-  - caption: <a id="fnref:5" class="footnote-ref" title="to image description" alt="to long image description" href="#fn:5">Sans</a>
+  - caption: <a id="fnref:5" class="footnote-ref" title="to image description" alt="to Sans palette description." href="#fn:5">Sans</a>
     img_src: ../../img/palettes/sans.png
-    img_title: to Sans Demo Page
-    img_alt: Sans Demo Page
+    tooltip: to Sans Demo Page
+    alt_text: Sans Demo Page
     link_href: ./sans/    
-  - caption: <a id="fnref:6" class="footnote-ref" title="to image description" alt="to long image description" href="#fn:6">Sans Dark</a>
+  - caption: <a id="fnref:6" class="footnote-ref" title="to image description" alt="to Sans Dark palette description." href="#fn:6">Sans Dark</a>
     img_src: ../../img/palettes/sans_dark.png
-    img_title: to Sans Dark Demo Page 
-    img_alt: Sans Dark Demo Page
+    tooltip: to Sans Dark Demo Page 
+    alt_text: Sans Dark Demo Page
     link_href: ./sans-dark/            
 ---
 
@@ -51,9 +51,9 @@ theme:
   palette: pink
 ```
 
-[^1]: demo site with a white background and light blue hyperlinks.
-[^2]: demo site with a dark grey background, orange hyperlinks, and light yellow text.
-[^3]: demo site with a black background, light blue hyperlinks, and white text.
-[^4]: demo site with a white background and pink hyperlinks.
-[^5]: demo site with a white background, light blue hyperlinks, and sans font.
-[^6]: demo site with a black background, light blue hyperlinks, and white text in sans font.
+[^1]: white background and light blue hyperlinks.
+[^2]: dark grey background, orange hyperlinks, and light yellow text.
+[^3]: black background, light blue hyperlinks, and white text.
+[^4]: white background and pink hyperlinks.
+[^5]: white background, light blue hyperlinks, and sans font.
+[^6]: black background, light blue hyperlinks, and white text in sans font.

documentation/docs/configuration/palettes/pink.md

@@ -3,18 +3,18 @@ show_tiles_inline: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of green moss on a log.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'overhead of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/
 ---
 

documentation/docs/configuration/palettes/sans-dark.md

@@ -3,18 +3,18 @@ show_tiles_inline: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of green moss on a log.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'overhead of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/
 ---
 

documentation/docs/configuration/palettes/sans.md

@@ -3,18 +3,18 @@ show_tiles_inline: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of green moss on a log.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'overhead of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/
 ---
 

documentation/docs/elements/examples/figure.md

@@ -1,10 +1,8 @@
 ## Figure Example
 
-<section markdown>
 <figure markdown>
-![some image](https://picsum.photos/1000/600?random&imageWithCaption){ title="a random image" ; alt="Random image with a caption" }
+![some image](https://picsum.photos/1000/600?random&imageWithCaption){ title="a random image" alt="randomly generated image." }
 <figcaption>A Random Image</figcaption>
 </figure>
-</section>
 
 <br>

documentation/docs/elements/figure.md

@@ -10,23 +10,19 @@ markdown_extensions:
 
 ## Example
 
-<section markdown>
 <figure markdown>
-![some image](../img/picsum/120_small.jpg){ title="a starry night" ; alt="a dark sky filled with stars" }
+![some image](../img/picsum/120_small.jpg){ title="a starry night" alt="a dark green sky filled with stars." }
 <figcaption>@Guillaume via Picsum</figcaption>
 </figure>
-</section>
 
 
 ### Markdown
 
 ```markdown
-<section markdown>
 <figure markdown>
-![some image](../img/picsum/120_small.jpg){ title="a starry night" ; alt="a dark sky filled with stars" }
+![some image](../img/picsum/120_small.jpg){ title="a starry night" alt="a dark green sky filled with stars." }
 <figcaption>@Guillaume via Picsum</figcaption>
 </figure>
-</section>
 ```
 
 

documentation/docs/tile-grid/examples/example-page.md

@@ -2,18 +2,18 @@
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of green moss on a log.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
   - caption: 'Steve Richey'
     img_src: ../../../img/picsum/143_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'overhead of fallen leaves.'
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
     link_href: https://picsum.photos/ 
 ---
 

documentation/docs/tile-grid/examples/images-only.md

@@ -3,21 +3,22 @@ show_tiles_first: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
+    alt_text: 'close up of fallen leaves.'
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-  - caption: 'Steve Richey'
+    alt_text: 'close up of green moss on a log.'
+  - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
+    alt_text: 'overhead of fallen leaves.'
 ---
 
 # Image Only Tiles 
-The tiles on this page do not have `link_*` attributes[^tile-reference].  They are rendered as a captioned images instead of linked images.
+The tiles on this page do not have a `link_href` attribute.  They are rendered as static images instead of linked images.
 
 # Tiles First
 The tiles on this page are placed before the main page content.  This is because the [grid option](../grid.md) `show_tiles_first` is set to `true`.
 
-[^tile-reference]: see [Tile Reference](../tile.md)  
-
-
+
 ## Markdown
 
 ```markdown
@@ -26,9 +27,12 @@ show_tiles_first: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
+    alt_text: 'close up of fallen leaves.'
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-  - caption: 'Steve Richey'
+    alt_text: 'close up of green moss on a log.'
+  - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
+    alt_text: 'overhead of fallen leaves.'
 ---
 ```

documentation/docs/tile-grid/examples/inline.md

@@ -3,19 +3,13 @@ show_tiles_inline: true
 tiles:
   - caption: '@petradr'
     img_src: ../../../img/picsum/167_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of fallen leaves.'
-    link_href: https://picsum.photos/ 
+    alt_text: 'close up of fallen leaves.'
   - caption: 'Marcin Czerwinski'
     img_src: ../../../img/picsum/127_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'close up of green moss on a log.'
-    link_href: https://picsum.photos/ 
+    alt_text: 'close up of green moss on a log.'
   - caption: "Steve Richey"
     img_src: ../../../img/picsum/143_200x200.jpeg
-    img_title: 'to Picsum homepage'
-    img_alt: 'overhead of fallen leaves.'
-    link_href: https://picsum.photos/
+    alt_text: 'overhead of fallen leaves.'
 ---
 
 # My Page Content