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

Multiple projects website TOC

Topics: Developer Forum, User Forum
Nov 13, 2014 at 1:34 PM
Only the first (in alphabetical order) project/xml is shown in the Websites TOC when adding several projects/xml to "Documentation Sources". However when I build a "HTML Help 1" file, all projects/xml in the current SHFB project are shown in the TOC.

The generated WebTOC.xml seems to include all the projects/xml in a correct way and all the html files for the projects/xml are generated in the html folder but only the first projct/xml is shown in the index.html TOC.
Nov 13, 2014 at 4:33 PM
Expand the root node of the TOC. It's collapsed by default in the current release unless you include at least one conceptual topic. It's fixed in the next release due out soon.

Nov 14, 2014 at 10:10 AM
Edited Nov 14, 2014 at 12:25 PM
You mean expanding the node on the website? The root node only containts one of the added projects/xml.

The struture of the help website is :

A Sandcastle Documented Class Library
-First project

UPDATE: The only way I manage to show all the different projects/xml is if I choose the "Include root namespace container". This will however add a second tier which seems to be abundant. The structure of the help website will then look like this:

A Sandcastle Documented Class Library
--First project
--Second project
Nov 14, 2014 at 4:08 PM
The "A Sandcastle Documented Class Library" node can be expanded too. As noted, it's fixed for the next release. Adding the root namespace container or a conceptual topic is the current workaround.

Nov 17, 2014 at 7:21 AM
Edited Nov 17, 2014 at 7:30 AM
Hi Eric,

Can you please explain in detail with some demo code?
What changes we need to do and exactly where?

This is the demo code that i am getting in WebTOC.xml.

<?xml version="1.0" encoding="utf-8"?>


<HelpTOCNode Id="c8817aae-9d00-4969-9d0c-77ffe58a864f" Title="ABC.XYZ.Data" Url="html/N_Acidaes_VirtualSalesManager_Data.htm">
Some xml.........
<HelpTOCNode Id="06fa0f39-8945-429d-9219-fe1fc702f50b" Title="MNO.XYZ.Dal" Url="html/N_Max_VirtualSalesManager_Dal.htm">
Some xml.........
<HelpTOCNode Id="de914dac-2dd7-42d9-97a0-e6718f4f242a" Title="MNO.XYZ.Data" Url="html/N_Max_VirtualSalesManager_Data.htm">
Some xml.........
<HelpTOCNode Id="7fc45b19-c7d9-4735-949f-9574aa2c6409" Title="MNO.XYZ.Data.Master" Url="html/N_Max_VirtualSalesManager_Data_Master.htm">
Some xml.........



But, I getting only first project in my .CHM file.
Other projects are missing.
Nov 17, 2014 at 5:58 PM
Generating CHM files is unrelated to this issue which is for a website build. If you're missing stuff in an Help 1 build, it's probably because the stuff that's missing is private or internal which is not documented by default. If that's the case, you need to enable the private and internal member options in the Visibility category of project properties.

Nov 20, 2014 at 4:44 AM
Hi Eric,

I enabled the private and internal member options in the Visibility category of project properties. But this works only for methods.
And in case of projects the response is same as above.
I am getting only first project in .chm file.
Nov 20, 2014 at 4:15 PM
It's hard to tell what your problem is based on your description. Can you send me an example? My e-mail address is in the footer of the pages in the help file.