Closed cjsha closed 2 months ago
Trying this out and this is what I see:
Do I need to perform a clean build or something, maybe?
Pull the latest commit and look at the headstage64-tut.md file to look at examples. Deleting the "_site" for a clean build might help this time to remove a certain local .css file.
With that said, I'd like to point you to this relevant comment about whether we should write in HTML or make custom containers. I suppose frequently repeated HTML should be its own custom markdown container.
@jonnew Captions are supported in markdig markdown engine (which docfx uses), but need to be enabled in the docfx.json by adding "figures" to the "markdigExtensions" array
"markdownEngineName": "markdig",
"markdownEngineProperties": {
"markdigExtensions": [
"attributes",
"customcontainers",
"figures"
],
"alerts": {
"TODO": "alert alert-secondary"
}
},
Do that ^ and follow this syntax to generate captions. I tested it, it works. This can be used to caption workflows, images, videos, etc., so I'm going to close this PR.
The syntax is like:
If this is clunky, maybe it's better to add html directly to the markdown file. I'm not necessarily opposed to just doing that if it works and doesn't create any issues with the linkchecking process or anything like that