This project is read-only.
1
Vote

Start topic is broken in Prototype model

description

Symptoms: After generating CHM file with Prototype style, start page is empty and wrong intermediate item is selected in the topic list.
That happens because .hhp file contains wrong value in the "Default topic" property.
RootNamespaceContainer property is set to false (I'm using the UI tool Sandcastle Help File Builder)
 
Reason: ApplyPrototypeDocModel.xsl has a call to the template "projectTopic" which adds new <api> tag with group="root". Afterwards ReflectionToChmProject.xsl puts file name from this group as a default topic value to .hhp file.
 
Solution: adding group="root" doesn't look to be necessary at all in case of not using RootNamespaceContainer. Commenting call to "projectTopic" template solves the problem:
 
<xsl:template match="apis">
<apis>
  <xsl:apply-templates select="api" />
<!-- <xsl:call-template name="projectTopic" /> -->
</apis>
</xsl:template>

comments

EWoodruff wrote Oct 23, 2008 at 4:34 PM

See http://www.codeplex.com/SandcastleStyles and apply the patch file from there. It fixes the issue with the blank root namespace page and many other issues. The actual bug related to the root namespace page was reported a while ago and the details can be found at http://www.codeplex.com/Sandcastle/WorkItem/View.aspx?WorkItemId=2277.

Dmnt wrote Oct 24, 2008 at 7:24 AM

I already have the patch applied and as mentioned i don't use Root Namespace Container.

EWoodruff wrote Oct 24, 2008 at 4:26 PM

I'm not seeing the behavior you're describing with or without the RootNamespaceContainer option. The noted work item did fix the problem with the missing root namespace page.

wrote Feb 22, 2013 at 1:40 AM