Sandcastle安装向导

\documentclass[UTF8]{ctexbook}
\usepackage{Psfrag}
\title{Sandcastle安装向导}
\author{IECAS\quad Archie}
\begin{document}
\maketitle
\tableofcontents
\chapter[欢迎]{欢迎进入Sandcastle安装向导}
Sandcastle是由微软公司制作,用于把.NET程序集和相关的XML注释文件生成MSDN-格式文档的一系列工具合集。 根据你想要生成的帮助文档的类型的不同,可能需要不止一个额外的工具。另外，还有很多社区补丁、第三方构建工具和组件也非常有用。

本程序将指导你安装过程中所需的全部步骤，这样你就可以利用Sandcastle开始你的生成帮助文档之旅了。某些额外的工具，如辅助编译器，并不是开源的，所以并没有包含在此引导安装包。本程序将搜寻需要的工具，如果没要找到则会引导你下载和安装。

安装程序与Sandcastle主标题中所显示的版本一致。
第三方构建工具和组件提供商同样可以和他们的产品一起使用本安装程序。此种情境下，工具和组件应该在Sandcastle及以上提及的工具之后安装。 

单击Next按钮继续。
\chapter{.NET Framework}
\section{Microsoft .NET Framework}
Sandcastle工具是使用 .NET Framework编写开发的。因此，需要匹配的版本来运行此安装包将要安装的所有必须的工具。 此应用程序和绝大部分工具和组件运行在 .NET 4.0。某些第三方构建工具或许需要另外版本的.NET Framework.
\section{最低版本要求}
安装包安装的工具要求.NET Framework最低版本为v4.0.本步骤中没有另外的操作.
单击Next按钮继续。
\chapter{帮助文件格式}
Sandcastle输出可以用来创建不同格式的帮助文件。然而，它却并不实际生成最终文件。因此需要辅助编译器或第三方工具。如下是帮助文件格式和生成相关文件所需工具的一个概述。
\section{HTML帮助格式 1}
HTML帮助格式 1 文件是扩展名为.chm的独立帮助文件。这是最早的帮助文件格式，可以在任何系统上浏览而无需特殊的查看器。 Microsoft HTML Help Workshop将作为帮助文件 1 的编译器被安装。
\section{Microsof帮助格式 2}
Microsoft Help 2格式生成扩展名为.HxS的帮助文件。这些文件并不能独立存在。 要想查看它们，必须将其嵌入到帮助文件集合器。这种文件典型的应用是为控件库和工具提供帮助并嵌入到微软的Visual Studio 2008以及更早版本的帮助集合器。第二种类型的帮助文件编译器不能单独获取，必须作为SDK的一部分嵌入到Visual Studio 2008 或更早版本。
\section{Microsoft Help Viewer}
这是最新的帮助文档格式，可以生成扩展名为.mshc的文件。这种类型文件主要为Visual Studio 2010及其其后版本的控件库和工具提供帮助。它们与第二种帮助文档类似，都需要嵌入到集合器中才能查看，但是这种文件不需要编译器。取而代之，帮助内容被压缩为ZIP格式的存档文件。Sandcastle的第三方构建工具将提供必要的支持来生成帮助归档文件和相关的配置文件。
\section{网站}
Sandcastle生成的主题文件是HTML文件，可以创建上传到web服务器的帮助内容。然而Sandcastle自身并不提供创建基于网络的目录、索引或查询功能的任何支持。这些功能留给第三方构建工具来做。.\\
下面的步骤将检查帮助类型1和帮助类型2的编译器，如果需要将给出下载和安装的指导。\\
单击Next按钮继续。
\chapter{检测本机安装的编译器}
\section{帮助类型1HTML编译器}
HTML帮助格式 1 文件是扩展名为.chm的独立帮助文件。这是最早的帮助文件格式，可以在任何系统上浏览而无需特殊的查看器。
发现帮助类型1HTML编译器。
据测定帮助类型1HTML编译器已在本系统安装 (位置: \verb| C:\Program Files\HTML Help Workshop)。|无需额外操作。\\
单击Next按钮继续。
\section{Microsof帮助格式 2}
Microsoft Help 2格式生成扩展名为.HxS的帮助文件。这些文件并不能独立存在。 要想查看它们，必须将其嵌入到帮助文件集合器。这种文件典型的应用是为控件库和工具提供帮助并嵌入到微软的Visual Studio 2008以及更早版本的帮助集合器。第二种类型的帮助文件编译器不能单独获取，必须作为SDK的一部分嵌入到Visual Studio 2008 或更早版本。

当前系统未发现Microsoft Help 2编译器 。 
\chapter{微软Sandcastle工具}
\section{Sandcastle工具}
为了使用Sandcastle和所有相关第三方构建工具生成帮助文件，这些工具是必须的而且是运行时所需的。
\\
\\
\verb|当前系统未发现Sandcastle工具。点击下面的Install Sandcastle按钮。 一个单独的安装程序将执行安装。一旦完成，返回到此程序继续安装其余工具。你可能需要重启以便让系统环境变量的改变生效。|
\section{安装}
选中所有安装。
\section{Sandcastle工具已安装}
上步完成之后，将检测到Sandcastle工具已经安装到本系统(位置:\verb|C:\Program Files\Sandcastle\)。| 本步不需额外的步骤。
\\
单击Next按钮继续。
\chapter[MAML Schema 智能感知]{Visual Studio中的MAML Schema 智能感知 }
Sandcastle MAML schema files嵌入到Visual Studio global schema cache 这样当你在 Visual Studio中编辑MAML主题文件时就可以使用智能感知。选择要安装schemas的Visual Studio版本并单击Install Schemas按钮。 如果跳过此步，可以在稍后再次运行此程序安装schemas。单击Next按钮继续此步。\\.
\fbox{\shortstack[l]{如果你以安装包不同的方式安装了schemas，选项将不可用，关于此种情况\\
的描述将出现在下方。在Sandcastle MAML向导中查阅Visual Studio智能感知\\
主题，安装包如何安装schemas.}}
Visual Studio 2008 - Unable to locate this version of Visual Studio.\\
Visual Studio 2010 - The schemas can be installed for this version of Visual Studio.\\
Visual Studio 2012 - Unable to locate this version of Visual Studio.\\

我这里只安装了VS2008，选中Visual Studio 2010选项，点击Install Schemes
\chapter[MAML 片段文件]{MAML 片段文件 Visual Studio}
Sandcastle MAML 片段文件可以嵌入到Visual Studio本地片段缓存，这样当在Visual Studio中编辑MAM主题文件时你将有一个可作为片段插入的公用块和内联元素列表。选择将要安装片段的Visual Studio版本单击安装片段按钮. 如果跳过此步，可以延迟使用此程序再次安装。。单击Next按钮继续下一步。\\

Visual Studio 2008 - Unable to locate snippet cache for this version of Visual Studio.\\

Visual Studio 2010 - The snippets can be installed for this version of Visual Studio.\\

Visual Studio 2012 - Unable to locate snippet cache for this version of Visual Studio.\\

我这里只安装了VS2010，所以选中Visual Studio 2010选项，点击Install  Snippets
\chapter[SHFB]{Sandcastle帮助文件生成器}
Sandcastle Help File Builder (SHFB)用来提供项目管理功能， 添加经常使用但是却缺少的NDoc-like特性，提供图形和基于命令行的工具来自动化地生成帮助文档。最新版本可以在CodePlex的Sandcastle Help File Builder项目找到。\\

这将安装核心生成引擎和独立的GUI项目管理系统。一个 Visual Studio 包允许你在Visual Studio中创建、管理和生成帮助文档项目。这是独立安装的。它依赖于核心生成引擎，并且核心生成引擎需要在安装包之前安装。\\

\fbox{
\shortstack[l]{在 Sandcastle Help File Builder的帮助文件的入门章节查阅附加工具的\\
相关主题，这将非常有用，你可以学会如何开始你的第一个项目。
} }\\

本系统没有发现Sandcastle Help File Builder。请单击下面的Install SHFB 按钮。一个单独的安装程序将执行安装。一旦完成，返回到此程序继续安装其余工具。你可能需要重启以便让系统环境变量的改变生效。|\\

选择Install SHFB。\\
安装后出现\\

发现Sandcastle Help File Builder。
检测到本系统安装了Sandcastle Help File Builder \verb|(位置: C:\Program Files\EWSoftware\Sandcastle Help File Builder\)。| 本步无需额外操作。
单击Next按钮继续。
\chapter[SHFB Visual Studio包]{Sandcastle Help File Builder Visual Studio包}
这将伴随Sandcastle Help File Builder (SHFB)一起安装，将使你可以在Visual Studio中创建、管理和生成帮助文档项目。核心生成引擎要求在此之前安装以保证此包的正常工作。本包支持下列版本的Visual Studio:
\begin{itemize}
\item Visual Studio 2010 Professional/Premium/Ultimate
\item Visual Studio 2012 Professional/Premium/Ultimate
\end{itemize}
在 Sandcastle Help File Builder的帮助文件的入门章节查阅附加工具的相关主题，这将非常有用，你可以学会如何开始你的第一个项目。\\

帮助文档中的独立的Visual Studio 扩展包部分覆盖了独立的GUI和Visual Studio 扩展包的差异，并且这里也可以找到Visual Studio中独立GUI中的相关选项。\\
单击下面的Install Package按钮安装最新发布版安装包。如果安装过较旧版本，在安装新版本之前将被移除。一旦完成安装，需要重启所有Visual Studio实例，这样可以探视和注册新的扩展包。
\\
选择Install Packages。\\

包成功安装。
重启所有Visual Studio实例，这样可以探视和注册新的扩展包。  单击下面的Next按钮继续。.
\chapter[完成]{安装向导完成}
安装向导完成。下面是一些额外的操作列表。单击关闭按钮退出。\\
点击Close.



\end{document}