创建新的Sandcastle PresentationStyle [英] Create new Sandcastle PresentationStyle

问题描述

我正在尝试通过创建新的演示风格来获得Sandcastle的输出帮助/ CHM文件以匹配我们公司文档的样式。这就是我到目前为止所做的：

创建了一个新目录：

C：\Program Files\Sandcastle\Presentation\的我们公司面试

从\Presentation\vs2005 <复制一切/ p>
<跨度> 以\Presentation\的我们公司面试

启动Sandcastle帮助文件生成器GUI并更改：

项目属性>帮助文件>演示文稿样式为我们的公司

下一步是在styles\presentation.css中编辑font-family和font-size值

任何其他提示或建议使其快速正确地工作？

解决方案

"缺少共享内容项目" - 只有某些PresentationStyle名称

我收到了一个错误，其原因似乎无法隔离。我第一次尝试创建自己的PresentationStyle时，我创建了目录\Sandcastle \ Presentation \ OurCompany ，如原帖中所述。我第一次构建，没有更改从\ Presentation \vs2005复制的原始文件，我得到了多个"丢失共享内容项"错误。所以，我又重新开始了。这一次，我决定打电话给我的PresentationStyle \Presentation \ Chg_vs2005 。我再次复制了所有文件和文件。来自原始\ Presentation\vs2005目录的目录并构建。没有错误。我在我的新\ Presentation \Chg_vs2005 \Styles \ Presentation.css文件中修改了几个font-family标签并重新构建。再一次，我没有收到任何重大警告或错误。

所以......我回到了原来的PresentationStyle（和子目录）名称\Sandcastle \ Presentation \ OurCompany。这一次，我又得到了我原来的错误...他们是行的，重复数次：

信息：BuildAssembler：建筑话题N：OurProd.Threading.WaitHandles
警告：SharedContentComponent：缺少共享内容项。标签："包括"; Id：'fb_alias'。
警告：SharedContentComponent：缺少共享内容项。标签："包括"; Id：'fb_product'。
警告：SharedContentComponent：缺少共享内容项。标签："包括"; Id：'fb_deliverable'。
警告：SharedContentComponent：缺少共享内容项。标签："包括"; Id：'fb_body'。
警告：SharedContentComponent：缺少共享内容项。标签："包括"; Id：'fb_subject'。
警告：SharedContentComponent：缺少共享内容项。标签："包括"; Id：'fb_headerfeedback'。

除了这些警告之外，我的帮助文件中缺少信息。除了为PresentationStyle使用不同的名称之外，我找不到新创建的有效的差异，以及在构建过程中显示这些警告的差异。

我多次切换，自定义PresentationStyle \Sandcastle \ Presentation \Chg_vs2005继续工作。但是，样式\ Sandcastle \ Presentation \ OurCompany继续提供这些错误，无论我在哪个文件中填充子目录。所以，我将\ Presentation \ OurCompany重命名为\ Presentation\xy_vs2005，警告就消失了。有什么想法吗？

I'm trying to get Sandcastle's output help/CHM file to match the style of our company’s documentation by creating a new presentation style. This is what I’ve done so far:

Created a the new directory: 

  C:\Program Files\Sandcastle\Presentation\OurCompany

Copied everything from \Presentation\vs2005

  to \Presentation\OurCompany

Started up the Sandcastle Help File Builder GUI and changed:

  Project Properties > Help File > Presentation Style to OurCompany

Next step is to edit the font-family and font-size value in styles\presentation.css

Any other tips or suggestions to get this to work quickly and correctly?

解决方案

"Missing shared content item" - Only with certain PresentationStyle name

I have been getting an error whose cause I can't seem to isolate.  The first time I tried to create my own PresentationStyle, I created the directory \Sandcastle\Presentation\OurCompany , as mentioned in the original post.  The first time I built, with no changes to the original files that had been copied from \Presentation\vs2005, I got multiple "Missing shared content item" errors.  So, I started all over again.  This time, I decided to call my PresentationStyle \Presentation\Chg_vs2005 .  Again, I copied all of the files & directories from the original \Presentation\vs2005 directory and built.  No errors.  I modified several of the font-family tags in my new  \Presentation\Chg_vs2005\Styles\Presentation.css file and built again.  Again, I got no significant warnings or errors.

So... I went back to my original PresentationStyle (and subdirectory) name of \Sandcastle\Presentation\OurCompany.  This time, I got my original errors again...  They are several repeats of the lines:

  Info: BuildAssembler: Building topic N:OurProd.Threading.WaitHandles
  Warn: SharedContentComponent: Missing shared content item. Tag:'include'; Id:'fb_alias'.
  Warn: SharedContentComponent: Missing shared content item. Tag:'include'; Id:'fb_product'.
  Warn: SharedContentComponent: Missing shared content item. Tag:'include'; Id:'fb_deliverable'.
  Warn: SharedContentComponent: Missing shared content item. Tag:'include'; Id:'fb_body'.
  Warn: SharedContentComponent: Missing shared content item. Tag:'include'; Id:'fb_subject'.
  Warn: SharedContentComponent: Missing shared content item. Tag:'include'; Id:'fb_headerfeedback'.

In addition to theses warnings, there is information missing from my help file.  Other than use a different name for the PresentationStyle, I can't find any differences in the newly created one that works, and the one that displays these warnings during the build.

I switched several times, and the custom PresentationStyle \Sandcastle\Presentation\Chg_vs2005 continued to work.  But, the style \Sandcastle\Presentation\OurCompany continued to give these errors, regardless of which files I populate the subdirectory with.   So, I renamed \Presentation\OurCompany to \Presentation\xy_vs2005, and the warnings went away.  Any ideas why?

这篇关于创建新的Sandcastle PresentationStyle的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！