Ensure our own docs build without errors

docs/source/markup/admonitions.md

@@ -1,4 +1,4 @@
 ---
 title: Admonitions
 ---
 
@@ -49,11 +49,11 @@
 Feature A
 ```
 
-```{versionchanged} 8.15
+```{versionchanged} 8.15.0
 Feature B
 ```
 
-```{deprecated} 2
+```{deprecated} 0.2.0
 Feature C
 ```
 

docs/source/markup/images.md

@@ -6,7 +6,7 @@
 
 Here is a block-level image from the top-level static folder. The image directive supports attributes such as alt text and image width as shown here.
 
 ```{image} /_static/img/observability.png
 :alt: Elastic Search
 :width: 250px
 ```
@@ -22,7 +22,7 @@
 
 Here is an image from the local image folder. 
 
 ```{image} img/serverless-capabilities.svg
 :alt: Elastic Search
 :height: 400px
 ```
@@ -31,8 +31,9 @@
 
 We can use the `figure-md` directive to add caption to an image.
 
-```{figure-md}
-![Elasticsearch](/_static/img/observability.png){w=350px align=center}
+```{figure-md} /_static/img/observability.png
+:width: 350px
+:align: center
 
 This is a caption in **Markdown**
 ```

docs/source/markup/substitutions.md

@@ -8,5 +8,4 @@ Here are some variable substitutions:
 
 | Value               | Source       |
 | ------------------- | ------------ |
-| {{project}}         | conf.py      |
 | {{frontmatter_key}} | Front Matter |

src/Elastic.Markdown/Myst/Directives/ImageBlock.cs

@@ -95,7 +95,7 @@ private void ExtractImageUrl(ParserContext context)
 
 		ImageUrl = imageUrl;
 		var imagePath = Path.Combine(includeFrom, imageUrl.TrimStart('/'));
-		if (context.Build.ReadFileSystem.File.Exists(imageUrl))
+		if (context.Build.ReadFileSystem.File.Exists(imagePath))
 			Found = true;
 		else
 			EmitError(context, $"`{imageUrl}` does not exist. resolved to `{imagePath}");

src/Elastic.Markdown/Myst/ParserContext.cs

@@ -42,6 +42,9 @@ public ParserContext(MarkdownParser markdownParser,
 			foreach (var (key, value) in props)
 				Properties[key] = value;
 		}
+
+		if (frontMatter?.Title is {} title)
+			Properties["page_title"] = title;
 	}
 
 	public MarkdownParser Parser { get; }