创建新的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.cssAny 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屋!