返回首页

简介
在这篇文章中,我们将目前的概念有助于在2007年10月CTP发布的Sandcastle的帮助编译器系统推出。
Sandcastle的建设的基础上。NET中的XML - DOC格式的源代码API参考提供的支持以前的版本。虽然这可能是有用的,在大多数情况下,一个完整的软件文档将包括两部分:API参考文档,以及quot;用户Manualquot;虽然有些软件提供了在Microsoft Word或Adobe PDF格式的,我们最喜欢的HTML格式的手册。在HTML格式的,我们喜欢一个外观类似的API参考文档。很多企业现在只提供在线帮助系统,不仅是方便,更实用,节省成本,但它也使我们的戈尔高兴!
现在,与2007年10月CTP发布,即使是最贫穷的独立软件开发商可以在他们可以负担得起的价格生产专业documentations - 免费。好了,"freequot;本身的价格,在这种情况下,一个非常昂贵的。在Sandcastle的概念帮助支持,没有一个文档(文档管理是没有记录),因此很难对当前Sandcastle的GUI商融入自己的工具。
这篇文章,因此,旨在提供以下:为帮助作者
减少quot; freequot;学习使用概念的帮助,使许多可以探讨这一有用的工具的潜力成本。对于(GUI)工具作者
提供的信息,以帮助整合新的和现有工具的概念帮助支持。
基本上,我想与你我共享,目前,在我试图去学习和掌握Sandcastle的概念帮助支持。我会发布了一系列关于这个的文章,但提供的所有工具和设施,在附带的下载文件,让你不会有工作,我的步伐。
在这篇文章中,我将目前都介绍你和你可以开始快速启动。这也将有助于我在下一篇文章中收集的信息。
现在,这些新的沙堡的概念帮助,让我给一个quot; freequot;一个典型的输出,这实际上是下载文件的一部分的屏幕截图。
{S0}什么是概念上的帮助?
概念是指有关概念或概念的形成,帮助这样一个概念,是一个文档的概念,或您的软件程序将如何帮助实现一些概念或想法。嗯,这是我尝试的技术,相信我,这是不准确的。准确的版本如下... ...
的概念帮助是基于微软协助标记语言或MAML,由微软用户援助平台团队为Windows Vista用户援助开发一个基于XML的标记语言。 MAML背后的想法是类似的DocBook(我不知道哪个更好)。
MAML由几个不同的内容类型,每一个特定的文档类型。 MAML内容类型包括:概念,术语,程序或如何做,参考,故障排除等
长期quot;概念helpquot;实际上是出自quot;概念contentquot; MAML定义的内容类型之一。
MAML规范是目前无法使用,但Sandcastle的团队提供了一个衍生版本为开发模式。架构目前是不完整的,这是添加到quot; freequot;成本我前面提到的。
概念的内容类型的模式,这是最通用的所有内容类型,如下所示:

下面是一个结构(现实的情况是不同的模式,表明一个不完整的架构)的概​​念帮助的例子:

<?xml version="1.0" encoding="utf-8"?>

<topic id="GUID" revisionNumber="">

    <developerConceptualDocument

        xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"

        xmlns:xlink="http://www.w3.org/1999/xlink">

        <title>...</title>

        <summary>

            <para>...</para>

        </summary>

        

        <introduction>

            <para>...</para>

        </introduction>



        <section>

            <title>...</title>

            <content>

                <para>...</para>

            </content>

        </section>



        <section>

            <title>...</title>

            <content>

                <para>...</para>

            </content>

        </section>

        <relatedTopics>

        </relatedTopics>

    </developerConceptualDocument>

</topic>
重要注意事项
以下必须指出关于这个问题和其他内容结构:LT; titlegt标签实际上是一个编译成功的帮助,甚至认为不包括架构。LT; topicgt的ID必须是一个GUID,在帮助系统中唯一标识每个文档。包含每个文件的文件必须命名为LT; topicgt的ID值。
最后,一个好消息:Sandcastle的团队提供的工具进行改造,与不同程度的完成和准确性,各种内容类型为表示支持的样式都HTMLHELP 1.x和2.x。典型的输出使用的VS - 2005年的演讲风格,这是最好的支持风格,如上图所示。 包含在下载是什么呢?帮助Builder库
这是一个易于使用的库,这将有助于你集中精力,而不是如何建立你的帮助文件的内容类型。这将创建与Sandcastle的配置文件所需要的目录中的主题ID中提取的GUID名称的文件的副本。这将创建的各种文件,包括表的内容。这将帮助您编译的文件和日志输出。架构Documentations
MAML即使是良好的记录。在2007年10月CTP版的Sandcastle的版本是不完整的,使其难以提取的文档。我已成功地提取文档中所提供的架构,而不是很漂亮,但很有用。它被命名Maml.chm在Builder文件夹中。快速入门示例
样品来源,在C#和VB.NET的教程,介绍如下。()样品这是不是只是另一个例子,但最主要的,我真的希望你有什么。这是一个例证表明您与Sandcastle的你可以做什么,然后你看看源代码,看看它是怎么做。它的目的是一个指南,教程,和食谱!事实上,这篇文章是从中提取。一个名为Manual.chm输出的副本位于Builder文件夹,你会得到同样的事情,如果你编译并运行此示例。以上显示的是输出的截图。
现在,让我们继续前进的教程或快速启动部分开始一些实实在在的工作。本教程
本节介绍简单的步骤,以帮助您开始使用所提供的Builder库。我们将创建一个简单的帮助文件,将显示quot概念帮助相当于你好,Worldquot;
输出将如下所示:
{S2}重要注意事项
库​​。NET 2.x或更高版本,并使用它需要VS.NET 2005年。正在使用VS.NET,让您可以轻松编辑您的概念帮助编译器所需的XML文件。创建内容启动您的VS.NET 2005(或更高),并创建一个新的控制台应用程序,在C#或VB.NET。我们需要添加的引用Builder库,以简化构建过程。找到你下载并解压缩本文附带的源。位于Builder文件夹的概念帮助建设者,以简化构建过程。在Builder文件夹中,有一个输出子目录包含Builder库,名为Conceptual.Builder.dll。添加到该库在新创建的控制台项目的参考。 从Builder文件夹中,复制的配置文件,Project.config到项目目录和批处理文件,Project.bat,并把它们添加到您的项目。
注意:Project.config Project.bat文件的内容可以自动生成,将在以后的文章。然而,在这篇文章中,它是提供这样您就可以对其进行修改和控制生成过程。现在,右键单击IDE中的项目,并添加两个文件夹,命名文件和媒体。
注:媒体文件夹及其内容(稍后添加)不是本教程所需要的,但"; fixedquot;配置文件需要它。
我们现在已经准备的项目,并准备添加需要定义我们的文档结构的内容。创建内容我们需要添加一个概念性的文档文件。 "; Documentsquot;文件夹上右击,选择添加,然后新项目... ...从显示的对话框中,选择"XML文件",并给它的名称document.xml中(本教程,但它可以是任何东西)。更改这个文件的内容看起来像这样... ...{C}
注:quot; idquot的LT topicgt;属性标签必须是一个GUID,你可以创建一个新的或刚使用提供的演示。 同样,MediaContent.xml添加到Media文件夹,并修改的内容为以下...
<?xml version="1.0" encoding="utf-8"?>

<stockSharedContentDefinitions fileAssetGuid="" assetTypeId="">

</stockSharedContentDefinitions>
最后,让我们建立一个表的内容。 project.xml文件添加到项目和改变以下内容... ...
<?xml version="1.0" encoding="utf-8"?>

<files>

    <file name="Document.xml"/>

</files>

按照同样的步骤,添加更多的文件文件添加到项目。
我们现在定义文档结构和准备配置构建过程,这是Builder库的用武之地。使用Builder库Builder库添加到本文章将用于编译的帮助文件,我们需要配置它。打开一个C#项目,或为VB.NET项目的Module1.vb你的Program.cs。导入Conceptual.Builder命名空间,并在下面的代码段显示,改变Program.cs文件中的内容。
下面的C#和VB.NET代码演示了如何创建,初始化,使用Builder库和编译帮助文件:C#代码
using System;

using System.IO;



using Conceptual.Builder;



namespace QuickStartCS

{

    class Program

    {

        static void Main(string[] args)

        {

            // 1. Set the working directory, which is the same as 

            //    your project directory

            string workingDir = @"..\..\";



            // 2. Prepare the documents and project file paths 

            string projectFile = Path.Combine(workingDir, "Project.xml");

            string documentsDir = Path.Combine(workingDir, "Documents");



            // 3. Create a new instance of the conceptual project

            Project project = new Project();



            // 4. Lets begin the build process...

            try

            {

                // First signal a beginning of a build process

                project.BeginInitialize(documentsDir, projectFile);



                // Second, initialize the working (or your project directory)

                // and build...

                if (project.Initialize(workingDir))

                {

                    // Third, build, only the batch build is implemented.

                    project.CompileBatch("Project.bat");

                }



                // Last, clean up...setting the parameter to "true" will delete

                // all the directories and files created for the build process.

                // NOTE: The HTML help files are not deleted.

                project.EndInitialize(true);

                project = null;

            }

            catch (Exception ex)

            {

                if (project != null)

                {

                    project.EndInitialize(false);

                    project = null;

                }



                Console.WriteLine(ex.ToString());

            }

        }

    }

}
VB.NET代码
Imports System.IO

Imports Conceptual.Builder



Module ModuleMain



    Sub Main()

        ' 1. Set the working directory, which is the same as 

        '    your project directory        

        Dim workingDir As String = "..."

        ' BUG in the CP syntax coloring will not let me write this correctly!



        ' 2. Prepare the documents and project file paths 



        Dim projectFile As String = Path.Combine(workingDir, "Project.xml")



        Dim documentsDir As String = Path.Combine(workingDir, "Documents")



        ' 3. Create a new instance of the conceptual project

        Dim project As Project = New Project()



        ' 4. Lets begin the build process...

        Try

            ' First signal a beginning of a build process

            project.BeginInitialize(documentsDir, projectFile)



            ' Second, initialize the working (or your project directory)

            ' and build...

            If project.Initialize(workingDir) Then



                ' Third, build, only the batch build is implemented.

                project.CompileBatch("Project.bat")

            End If



            ' Last, clean up...setting the parameter to "true" will delete

            ' all the directories and files created for the build process.

            ' NOTE: The HTML help files are not deleted.

            project.EndInitialize(True)

            project = Nothing

        Catch ex As Exception

            If project IsNot Nothing Then

                project.EndInitialize(False)

                project = Nothing

                Console.WriteLine(ex.ToString())

            End If

        End Try



    End Sub



End Module

在C#和VB.NET代码工作的例子。 QuickStartCS和QuickStartVB样品提供的代码和本文件中概述的所有步骤。编译代码
无特殊编译或汇编指令是必需的,只是编译Builder库(如有必要)和你的项目。然后,运行该项目,如果一切顺利成功,编译的帮助文件会自动显示。输出位于"帮助"子文件夹。有用的链接下载Sandcastle的2007年10月CTP {A}。
Sandcastle的相关文章:{A6}历史2007年12月30日 - 初始版本 - 0.1版说。 2007年12月31日 - 固定格式。

回答

评论会员:Indivara 时间:2011/12/15
我低先后被评为,考虑到它是多么有用

在过去,我用这篇文章中,然后为了发表评论,但忘了。

谢谢! {S3}
评论会员:游客 时间:2011/12/15
保罗Selormey。Indivara写道:滑稽有多低先后被评为,考虑到它是多么有用谢谢。诚然,这是真的很有趣。用了大约一个月演奏和研究(使用我公司的时间),以获得理解和构建工具,它的概念性的东西,工作和其他。当我发布的MSDN文档论坛上的联系,开发​​工作Sandcastle的工具,说他不想读它-可能是表明他对自己的工作理解的概念性主题{S4}的现在,投票制度使得它便于识别的低等级的背后的动机。最好的问候,耶稣基督是爱!请告诉别人。
BryanGDonaldson
评论会员:游客 时间:2011/12/15
当我使用提供project.config,我得到以下错误:错误:ResolveArtLinksComponent:每个目标元素必须有一个输出属性指定一个目录,在其中放置引用的艺术文件。检查配置文件中的有关部分,我看到这(注释已移除)-!解决艺术的联系-GT; LT组件类型="Microsoft.Ddue.Tools.ResolveArtLinksComponent"大会="%DXROOT%\ProductionTools\BuildComponents.dll"GT;"\媒体"。\输出\媒体"的目标输入=输出=链接="../媒体"地图="\媒体\MediaContent.xml"/GT;LT/componentgt;进一步研究表明,它可能是这样的: LT组件类型="Microsoft.Ddue.Tools.ResolveArtLinksComponent"大会="%DXROOT%\ProductionTools\BuildComponents.dll"放大器;GT"\媒体","\输出"的目标输入=baseOutput=outputPath="媒体"链接="../媒体"地图="\媒体\MediaContent.xml"GT;LT/componentgt;后来BuildAssembler死于异常:未处理的异常:System.IO.DirectoryNotFoundException:无法找到路径"C:\\TESTAPPS\ConceptHelp\输出\输出\test.HxF"的一部分。这是追溯到这一行:LT-记录文件的创建活动-GT;LT组件类型;="Microsoft.Ddue.Tools.HxfGeneratorComponent"大会="%DXROOT%\ProductionTools\BuildComponents.dll"输入="%DXROOT%\颁奖\VS2005\seed.HxF"输出="\输出\测试HXF"。/GT;改变输出属性"test.HxF"固定的。修改,2009年9月17日,日(星期四)上午09:35
保罗Selormey
评论会员:游客 时间:2011/12/15
对不起,这篇文章是为Sandcastle的2007年10月CTP,和配置是在当前版本中改变库的更新版本Sandcastle的协助项目的一部分请让我知道你想要做什么,我会告诉你现在可以使用的工具。你会发现一个改进MAML指南{A8}最好的问候,保罗。 耶稣基督是爱!请告诉别人。
保罗Selormey
评论会员:游客 时间:2011/12/15
http://preview.tinyurl.com/69dnck请你考虑更新您的非常有趣的快速启动?,埃里克T.
保罗Selormey
评论会员:游客 时间:2011/12/15
实际的链接是{A9}]这是另一个由Eric伍德拉夫的MAML文档。EricT。写道:"请您考虑更新非常有趣的快速启动?是的,我的工作就可以了。我将需要更新构建系统和documenations-对不起延迟。最好的问候,保罗。耶稣基督是爱!请告诉别人。
jwhook
评论会员:游客 时间:2011/12/15
您好,我在CodePlex已经开始一个新的项目,在这篇文章上的代码工作进一步。{A10}称之为它的CTP预览代码,自定义生成代码语法突出在LT组件​​;!codegtLT;codeReferencegt;标签,在概念和参考帮助。还有一个希望插入数学公式使用LT的数学部分;mathgt;标签最好的问候,保罗。 耶稣基督是爱!请告诉别人。
保罗Selormey
评论会员:游客 时间:2011/12/15
我也是通过在您的文章工作留下深刻印象。我主要是兴趣,最初,在MAML帮助文件。但下载zip文件并进行提取,当我点击。chm文件后,我得到一个浏览器错误,并没有什么帮助。你能帮助吗?感谢。
jwhook
评论会员:游客 时间:2011/12/15
jwhook写道:我也工作在您的文章留下深刻印象。谢谢。jwhook写道:你能帮助吗?如果您使用Windows防火墙,这是一个普遍的问题。如果您单击*.chm文件,Windows将显示"Windows安全警报"对话框,点击"解除阻止"。如果不是的话,请让我知道。最好的问候,保罗。耶稣基督是爱!请告诉别人。
保罗Selormey
评论会员:游客 时间:2011/12/15
不正是你说的。我得到一个对话框:打开文件-安全警告。当我单击打开,我得到一个"导航网页被取消"显示在右窗格中。如果我在主题列表中的任何项目上按一下,我得到了一个空白显示。
jwhook
评论会员:游客 时间:2011/12/15
对不起,请了Windows,你使用,并在适用时,服务园区是什么?我会尽力调查。最好的问候,保罗。耶稣基督是爱!请告诉别人。
保罗Selormey
评论会员:游客 时间:2011/12/15
WindowsXP的SP2。没有任何幻想。能读"manual.chm"我重新生成项目时产生的,但不是一个分布式。而不是MAML.chm。
jwhook
评论会员:游客 时间:2011/12/15
我很对不起这个问题。我仍然无法重现它在我的电脑。我已尝试vitual电脑也没有,所以我不知道如何最好地修复它。如果直接通过电子邮件发送给你任何帮助,我会的。只是让我知道,我怎么可能会有帮助。最好的问候,保罗。耶稣基督是爱!请告诉别人。
托马斯韦勒
评论会员:游客 时间:2011/12/15
喜保I/E标记为"封杀"时,它保存到磁盘文件。的解决办法是做一个右键单击|在资源管理器的文件属性,并点击解除封锁虽然我过去这个问题的时候,我仍然不能完全得到挂起的模式。我想我们的程序员来弥补这一下降死简单,所以他们可以做一些非常基本的程序标题的意见很容易,但得到很好的格式化,太吉姆-
保罗Selormey
评论会员:游客 时间:2011/12/15
您好,首先感谢您的文章。我有没有详细,但您提供的样品,但它是立即明显我必须在多少辛劳。我特别高兴地看到,我不关心这样的"少女"的东西,如文档问题的唯一开发。我是一个自由职业者,谁是多年努力告诉人们,良好的文档是一个软件系统的重要组成部分,不只是东西,你做时,有没有别的左(即:永远不会做的东西)。使用Sandcastle的,Sandcastle的GUI,自动生成服务器和CR_Documentor插件的组合,可以建立一个记录至少源代码退出流利的过程。然而,最概念性的文档是使用一个丰富的环境,如MSWord或HTML编辑器,这些文件吨已经在使用某种方式或其他。没有人真的想要写大纯XML文本。你知不知道将文件类型,如*.DOC,*.html或*.比与超链接引用到帮助系统的PDF?或任何其他的想法如何概念性文件的创作过程中可以某种方式更容易取得?预先感谢托马斯
托马斯韦勒
评论会员:游客 时间:2011/12/15
您好托马斯,的兴趣和反馈。大家都非常清楚,这里的目标是HTML帮助的CHM/HXS文件。对于HTML:既然你已经在构建过程中的控制权,你可以直接添加任何HTML文件前的最后建立或建立自己的最终结果。您可以添加所需的页眉和页脚的HTML文件有相同的外观和感觉为Sandcastle的输出。{BR​​}对于*.DOC,*.PDF格式:您不能直接纳入的CHM/HXS没有超链接目前,许多写HTML文本编辑器的所见即所得编辑器,并自MAML比HTML简单得多,你不担心造型等,我将鼓励开发人员学习MAML和完成工作。通过这个项目,我会的目的是减少编译的工作,这样的作家可以集中精力在MAML。我欢迎在这方面的任何建议,并交流经验。最好的问候,保罗。耶稣基督是爱!请告诉别人。
保罗Selormey
评论会员:游客 时间:2011/12/15
您好保,感谢您的答复。我真的很喜欢这个概念文件的概念,因为它增加了文件的过程更加清晰和结构。我非常感谢你的工作:我打算使用一些介绍文档在我的下一个项目的风格指南Manual.chm样品。我也期待您的文章宣布更新不过,有一点我们似乎有不同的关注。我觉得我有我点了一下更清楚。我问上述问题的原因是没有这么多的技术,但我的一个务实的方式,在开发人员的日常工作​​纳入文档问题思想。良好的文档在软件项目只会发生,如果你能获得接受你的团队成员(不是一件容易的事情在所有...).{BR}保罗Selormey写道:我会鼓励开发人员学习MAML和完成工作不幸的是,这将无法工作。如果你想开发人员编写一些有关源(如某些软件设计或做工这样)的概念文件,有两种选择:要么你提供他们有能力做一个快速和容易的(所见即所得-)的方式,在他们的生产环境或他们会产生类似Word文档,并告诉你在哪里可以找到它。其余的将被留给你。但他们绝不会愿意写纯XML,不管它可能是多么的简单!(是明确的:我自己是一个程序员,但有时我也有关心项目管理的问题,至少有关技术的,...){BR}那么,什么是需要的东西,没有什么可以做CR_DocumentorVS插件的代码注释的概念性文件:启用一个程序员写的文字,并没有太多关心的格式。在VS本身的一个流利地这样做。在此期间,我曾在看DocToMAML工具。这是非常beta版,但是我认为这是在正确的方向。创建Sandcastle的帮助文件生成器GUI的技术选择委员会是另一种方式纳入你的项目文件不同的文件。关于托马斯
托马斯韦勒
评论会员:游客 时间:2011/12/15
您好托马斯,inforomation和反馈。现在,我明白你的意思。目前,我试图使其更容易建立的概念帮助,和编辑方尚未就工作。不幸的是,我的MAML太多,可能没有边界使用任何WYSIWYG工具。我来到这里后,寻找一些可能性。我研究了一些。NET的Word转换工具,大多数都是非常昂贵的,所以,免费的工具,开发人员可能不能够给开发商带来。我见过CR_Documentor工具,但更喜欢纯VS.NET,似乎对我更快。因此,获得一个trully所见即所得的工具,satistfy大多数用户将需要使商业努力。我MAML后,迫使我公司支付超过1000美元,2授权文件的工具,不能满足我们的需要。所以,我决定到这个MAML做我的documentations的方式,因为它地方小的局限性,它是高度定制的,如果你有时间。我会寻找到你的建议,我尝试提供一个工具,我可以用自己。我将我的计划和结果公布于众,供他人使用,并提高最好的问候,保罗。耶稣基督是爱!请告诉别人。
保罗Selormey
评论会员:游客 时间:2011/12/15
您好保,感谢您的答复和Codeplex上讨论列表显示您的新文件格式建议。在第一眼您的建议似乎完全合理的,我的,因为它们是在同一时间,以及结构和灵活的。此刻我没有时间,以更深入地或尝试在测试项目,但它看起来对我好。(也许这是其中一个可以很容易地把一些像树顶部的可视化编辑,从而创造一个基本的编辑器的帮助结构的排序。这是否对你有意义吗?)保罗Selormey写道:我所见过的CR_Documentor工具的,但更喜欢纯VS.NET,似乎对我更快。当然,你是绝对正确的的:一个真正纯VS.NET快,应该是你有所有的XML注释语法的东西记。我与"快"的意思是:一个团队更有效率,在使用CR_Documentor时,输出的质量较高,和XML注释语法的学习,去得更快-因为人们马上就可以看到他们的著作的输出看起来会像顺便说一下:我通过电子邮件与特拉维斯ILLIG(CR_Documentor背后的家伙)这些天,他告诉我,下一版本的CR_Documentor会有一些Sandcastle的整合,也将走开源。(因为我们是与"真正的"工作的所有辛勤工作的人,他能不能告诉确切将于何时,但它不应该是长现在...).{BR}我也同意你的第三方文档工具都非常昂贵,大多在日常生活有很大帮助。我的印象是,他们还方式过于复杂,在日常使用。我不是一个帮助文件的作者,但有时觉得需要写一些句子,他的软件(有时给它添加一个图片)的程序员!我想要做一个简单的方法-最好不要离开我的生产环境。除此之外,你见过{A11}这里我简要地描述了一种可能的方法纳入现实生活中的软件项目的文档?目前,我认为创建CodeProject上的文章,自己在那里我可以在一个更详细地概述这些点与一些比较高层次的考虑(关于项目管理问题)。因为我非常繁忙的时刻,这不会是夏末前。也许我可以反映在概念帮助领域的一些伟大的关于你的工作,沙堡,SHFB等...).{BRongoings(}只是一个想法,我在这一刻:如果您想直接写HTML文档,VisualStudio和链接Sandcastle是使用相同的样式表,使这些文件,你将有回落的创作概念的帮助文档的道路很长的路要走视觉风格。这可能可以结合一些概念性的帮助文档的不同类型的VS-模板。你怎么想?关于托马斯
保罗Selormey
评论会员:游客 时间:2011/12/15
您好托马斯,答复和信息。托马斯韦勒写道:(这也许是东西可以很容易地把一些像树顶部的可视化编辑,从而创造一个基本的编辑器的帮助结构的排序,这是否对你有意义吗?)正确的,即是目标的一部分。虽然我还没有说,它的目标的一部分,是提供各种控件的编辑部分。托马斯韦勒写道:"一个团队更有效率,在使用CR_Documentor时,输出的质量较高,和XML注释语法的学习,去得更快-因为人们马上就可以看到他们的著作输出看起来会像。显然,不会是一个单一的解决方案为所有。我将努力使可用于定制和特定需求或应用程序扩展库。托马斯韦勒写道:CR_Documentor未来版本将有一些Sandcastle的整合和也将开源所付出的努力,希望CR_Documentor可以尽快加入Sandcastle的生态。麻省理工学院/BSD与我的当前项目,以及灵活的许可证,我希望能够帮助缩短这个时间和/或努力。它也可以用于一些实施一个新的图书馆,以供参考。此外,托马斯韦勒写道:,你见过我的其他职位,我简要地描述了一种可能的方法,融入现实生活中的软件项目的文档?是的,我已阅读此主题的讨论。看来,夏天的时候是一个很好的,因为大多数Sandcastle的项目将有一个工作环境或工具。可能是非常有用的一篇文章,可以让用户了解可用的工具和功过。审查,然后再发布,以增加读者的经验,你可以提出各种帮助工具作者。托马斯韦勒写道:"可能这是可以结合一些概念性的帮助文档的不同类型的VS-模板。你怎么想?这将是一个当然的欢迎帮助。即使微软无法得到一个真正可用的所见即所得的HTML编辑器,所以我还是喜欢在大多数情况下,直接访问HTML。有一次,我认为本文的VS模板和VS的项目,但它需要安装,我不希望这个简单的指南。DocProject目前VS.NET集成和模板,只是它仍需要更多的工作。对概念性的东西之前,我一直在寻找一个简单的HTML模板与样式的支持,我可以用它来写帮助文档。SHFB了一点点接近,但有不支持代码过滤器,和其他功能。很多再加入,并要求被释放的Sandcastle的概念部分。最初,它看起来很难,这是为什么我这篇文章的时候。不幸的是,投入,如您现在共享​​的伟大思想,不能来找我,以确定进行这一努力多远。我真的很感谢您分享您的想法时。最好的问候,保罗。耶稣基督是爱!请告诉别人。
莱纳舒斯特
评论会员:游客 时间:2011/12/15
托马斯韦勒写道:我也希望为您的文章宣布更新请你看着{A12}],你可能会为我的一些建议。最好的问候,保罗。耶稣基督是爱!请告诉别人。
托马斯韦勒
评论会员:游客 时间:2011/12/15
喜托马斯,您可以包括与Sandcastle的帮助文件生成器(SHFB)一个简单的TOC等HTML。你必须从SandcasteGUI迁移。概念帮助是在DocProject综合一个简单的方法,将进入SHFB1.7.0.0版本。双方将有简单的可视化编辑器,在它们的版本的下一版本。沙塔队下周将推出一个新的CTP。我猜这两个家伙,埃里克伍德拉夫和戴夫萨克斯顿将释放他们的更新很快。希望这有助于一点点。莱纳Live是短到被激怒了丢失的机会
!莱纳舒斯特
评论会员:游客 时间:2011/12/15
喜莱纳,感谢信息。只是一个简短说明:我是很不清楚在我以前的帖子-如果我说Sandcaste的GUI,其实我的意思是Sandcastle的帮助文件生成器(SHFB)。关于托马斯
托马斯韦勒
评论会员:游客 时间:2011/12/15
。Ok.It的很容易比在GUI中去"AdditionalContent"一节中,命中"..."在AdditionalContent物业它应该是非常不言自明的。有一点需要注意。将您添加到TOC的每一个项目的帮助下文件夹,你可以改变一个适当的DestinationPath在一个相对的方式。SHFB文件是非常好的,但如果你坚持随时来问我进一步的问题。我也喜欢做concetual帮助文档。它的结构,它有一个模式,你会得到一个非常漂亮的外观和感觉。____________________________________________{BR}支持德国NET资源:{A13}____________________________________________{BR}