Inserir AJUDA no programa
o Visual Studio tem alguma ferramenta que auxilia no desenvolvimento de um 'HELP' ?
Meu cliente pediu para eu criar um Manual, do sistema, então pensei em criar o 'manual' como se fosse um AJUDA, com procura pro palavaras chaves e etc.
Tem como fazer isso no VS ?
Felipe.
Curtidas 0
Respostas
Fabio Mans
17/02/2009
Olá Existe alguns inclusive Free.Help Generator for Visual Studio 2005 3.0
http://www.soft3k.com/Help-Generator-for-Visual-Studio-2005-p10856.htmAcredito que este é o mais conhecido de todos
NDoc Code Documentation Generator for .NET
http://ndoc.sourceforge.net/Espero ter ajudado.
http://www.soft3k.com/Help-Generator-for-Visual-Studio-2005-p10856.htmAcredito que este é o mais conhecido de todos
NDoc Code Documentation Generator for .NET
http://ndoc.sourceforge.net/Espero ter ajudado.
GOSTEI 0
Felipe.
17/02/2009
Entao, peguei o Help Generator for VS2005, mas nao funcioou talvez pq meu VS seja o 2008 Professional.
Já o otro programa, também nao funcionou, na instalação falou que o precisava do framework 1.1m as eu tenho o 3.5
Fiquei sem entender, onde certifico a versao do meu Framework ?
GOSTEI 0
Felipe.
17/02/2009
Então entrei na pagina do desenvolvedor e baixei o Help Generator for VS 2008, aí funcionou.
Criei um Help de teste e criou beleza.
Agora como eu faço minha aplicação chamar esse Help criado :?
GOSTEI 0
Fabio Mans
17/02/2009
Tenho um tutorial em Inglês, pode ser?
Qualquer dúvida fique a vontade.
Go to File->New->Blank Solution.
Select Visual C# Projects in Project Types.
Select ClassLibrary in Templates.
Type, for e.g. TestXMLdoc, in the Name textbox.
Creating a simple class XML file (the class which will have the comments which will be read by our Visual Studio .NET to create the XML documentation)
Replace the code in the class with the following:
Collapse Copy Codeusing System;
namespace TestXMLdoc
{
/// <summary>
/// This project shows how to create XMl documentation in C#
/// </summary>
public class TestXMLdoc
{
/// <summary>
/// m_iTestVar is a module level test variable for storing int
/// </summary>
private int m_iTestVar;
/// <summary>
/// m_sTestVar is a module level test variable for storing string
/// </summary>
private string m_sTestVar;
/// <summary>
/// TestXMLdoc is the constructor
/// </summary>
public TestXMLdoc()
{
//
// TODO: Add constructor logic here
//
}
/// <summary>
/// TestReturnBack is a test method which
/// simply takes a name and returns it back.
/// </summary>
/// <param name="sName"></param>
/// <returns></returns>
public string TestReturnBack(string sName)
{
return "Your name is " + sName;
}
}
}
Compiling your application after specifying the documentation filename
Note: If you are not using the Visual Studio .NET IDE, you should go for the first one from the following optionss:
At the compile time, you just need to specify the file name like the following:
Collapse Copy Codecsc testXMLdoc.cs /doc:testXMLdoc.xml
(or)
If you are using the powerful Visual Studio .NET IDE, then follow these steps:
Go to to the Solution Explorer.
Right click the project and go to Properties.
This will open a dialog box.
Locate the configuration properties -> Build
Specify the output path, and XML documentation file name, say TestXMLdoc. That's it.
Compile it and it will create the file at the specified location.
Unlike Java, Microsoft Visual C# generates XML documentation instead of HTML, and as we know about XML, it's mould-able and later can be used anywhere else we need. The following is a list of tags along with their description which can be used in creation of XML documentation.
This will textually include provided code in a single line.
E.g.: int i = 0 ;
This will textually include provided code in multiple lines (snippet).
This will include a code example.
This will force the compiler whether it matches a possible exception.
This will fetch the documentation from an external file. Same as #include in scripting languages.
This will insert a list into the documentation file.
This specifies the parameters of the method and makes the compiler verify it.
This will mark a parameter.
This will determine the access permissions.
This will include a descriptive text.
This will mark the return value of a member.
It is a reference to a related item.
This is similar to the 'See also' section of the MSDN help.
A summary of the member item. Normally, Visual Studio .NET prepares this automatically along with its close tag the moment you type.
/// (three slashes) in its editor.
This is nothing but a property.
Opening the XML documentation file
Go to the specified path (by default, your application's bin/Debug).
Open the XML file (in our case, TestXMLdoc.xml) in Internet Explorer.
Check out: it should look like the following:
Creating an HTML document file automatically
Wasn't that fun? It was.. I know. But that was just a trailer, let's see the whole movie.
Go to menu Tools->Build Comment Web Pages.
On the dialog box, click OK to see the magic (you may change the options as per your need but since we have a single class, let's leave it to default ones).
Click on the name of the solution on the created web page.
Now, click on the project name in the displayed tree.
And ...by now, you must be curious and must have already clicked the class name within.
That's the result of your patience, hard work and cooperation.
Note: The above example was for people who need a tool to suffice their minimum requirements. For advance documentation, you would like to opt for a more sophisticated tool like NDoc Code Documentation Generator for .NET.
NDoc generates class library documentation from .NET assemblies and the XML documentation files generated by the C# compiler (or with an add-on tool for VB.NET). And the output looks like the following:
NDoc uses pluggable documenters to generate documentation in several different formats, including the MSDN-style HTML Help format (.chm), the Visual Studio .NET Help format (HTML Help 2), and MSDN-online style web pages.
GOSTEI 0
Fabio Mans
17/02/2009
Conseguiu fazer?
GOSTEI 0