I've been using <procedure> as suggested in the examples but I'm confused about what the <content> tag is for. I have something like this:
<para>Creating a server application</para>
A server application ...
What is the <content> for and are there other things I can do with <step>? Right now I just use <step><content> together and the first <para> becomes my numbered "heading". It would be nice to make the steps collapsible
and maybe have a separate title style instead of just numbering the first paragraph.
The content element is defined as a schema element type that is used by several
section-type structural elements, not just procedure elements. Its purpose, it seems, is to be a container of
block-level content and nested structure elements. It certainly accepts more children than just
para elements too. Here's the relevant schema that describes its content:
I think step can also contain other steps, IIRC. Whether Sandcastle honors them is a different story though ;)
If you're authoring MAML topics using Visual Studio's XML editor, then I recommend reading the following article:
How To Enable IntelliSense in Conceptual Topics
Sandcastle's main_conceptual.xsl file provides the XSLT templates that transform MAML to HTML. If you want a different output for the
step element you'll have to update this file or one of the XSLT files that it imports.
Brilliant, thanks for all the info.
I'm using DocProject and I'm writing MAML from within VisualStudio so enabling IntelliSense on MAML was a huge help!