Content files not under the project root folder?

Topics: User Forum
Jul 26, 2010 at 8:59 PM

What is the suggested way to include additional help content into the help project when it comes from a different project?  We are currently forced to either forgo the GUI, because it will no longer load when there is a content file outside of the project root although the command line will still work.  Or we stuck creating additional copy steps in our build process to copy the files into the help project folder.  If we can reference and use a .csproj file that is anywhere why can't we pull in a content file?

Jul 26, 2010 at 10:54 PM

SHFB projects are similar to other Visual Studio projects.  Think of documentation sources as references which can be anywhere and the content files as source code files which are located in the project folder.  As with other Visual Studio projects, source/content files outside the project folder are supported but must use the <Link> metadata element to specify their virtual location within the project.  However, there is currently no support within the GUI for adding linked items.  I assume you've been editing the project by hand and/or using an import file to define the content file paths.  If so, add a <Link> metadata element to those items to specify their virtual location within the project.  For example:

    <Content Include="..\..\..\OtherProject\Doc\TestTopic.aml">
    <Content Include="..\..\..\OtherProject\Doc\SubFolder\AnotherTopic.aml">



Jul 27, 2010 at 2:25 PM

Thanks, this is just what we were looking for.