This project has moved and is read-only. For the latest updates, please go here.

How to break a line? (<br />)

Topics: Developer Forum, User Forum
Sep 7, 2010 at 1:35 PM


Could you prompt how to break a line in the SandCastle code?

We've found the following solution:


In the Sandcastle installation folder, make the following change in both Presentation\Prototype\Transforms\main_sandcastle.xsl and Presentation\VS2005\Transforms\main_sandcastle.xsl.

Find the section commented as "pass through html tags" and replace it with this block:

 <!-- pass through html tags -->
 <xsl:template match="p|ol|ul|li|dl|dt|dd|table|tr|th|td|a|img|b|i|strong|em|del|sub|sup|br|hr|h1|h2|h3|h4|h5|h6|pre|div|span|blockquote|abbr|acronym">
   <xsl:copy-of select="@*" />
   <xsl:apply-templates />



BUT these files contain already this block, and the <br> tag does not work. The <para> tag does not meet our needs, as the line height is too large in this case...

Is there any other solution up-to-date?


Thank you in advance.

Sep 7, 2010 at 8:29 PM

Are you referring to XML comments or MAML topics?  The above template is from the transformation that handles XML comments and the <br/> tag does work there.  There is no equivalent support for MAML topics.  If you don't like the paragraph spacing in general, you can modify the Presentation.css file in the presentation style folder (%ProgramFiles%\Sandcastle\Presentation\VS2005\Styles\Presentation.css for example).  If you are just trying to adjust the spacing for a small section of a topic, you can use the <markup> element to pass through a chunk of HTML unmodified.  You need to apply the Sandcastle Styles patch to support that.  See the MAML Guide also available from the Sandcastle Styles project site for information on when it may be appropriate to use the <markup> element.




Sep 9, 2010 at 2:33 PM

Thank you very much for help!