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

查看:55
本文介绍了创建新的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屋!

查看全文
登录 关闭
扫码关注1秒登录
发送“验证码”获取 | 15天全站免登陆