search

EWSoftware / SHFB

Sandcastle Help File Builder (SHFB). A standalone GUI, Visual Studio integration package, and MSBuild tasks providing full configuration and extensibility for building help files with the Sandcastle tools.
Other
2.19k stars 368 forks source link

Custom tags and XSLT #1085

Open johnnyontheweb opened 15 hours ago

johnnyontheweb commented 15 hours ago

Hello, after a long search over the internet, I cannot ind any working way to add custom tags to the generated documentation, as described for instance here: https://learn.microsoft.com/it-it/archive/blogs/sandcastle/supporting-custom-tags-in-sandcastle https://stackoverflow.com/a/12393192/5278185

I cannot find any relevant .xsl, .xslt or main_sandcastle.xsl file to edit, nor in project folder or installation folder "C:\Program Files (x86)\EWSoftware\Sandcastle Help File Builder".

I simply want to add some new tags to document my functions. Can you please give some hint? I'm using the latest version of SandCastle.

EWSoftware commented 10 hours ago

The XSLT transformations were removed in favor of a more open and extendable code-based API in version 2022.8.14.0. See the Presentation Style Mods Plug-In example project. It shows how to do various things like adding custom element handlers using a plug-in.

In Visual Studio, create a SHFB plug-in project. You can then add the custom element handlers and the plug-in code to indicate to the presentation style that it should use them. For an example custom element handler, see CustomElement.cs. See the Add custom element handlers region in the plug-in for how to get it used.

I can provide more details if needed.