docfx C# (Como funciona para desenvolvedores)

Como usar o DocFX

1. Instale o SDK do .NET 6.0 ou superior.
2. Abra o PowerShell.
3. Execute o script um por um para instalar a biblioteca DocFX.
4. Após a instalação, execute o arquivo JSON.
5. Isso abre o site de documentação na porta 8080.

Introdução ao DocFX

A Microsoft criou o DocFX, uma ferramenta de código aberto para geração de sites estáticos e documentação. Com a ajuda de arquivos Markdown e código-fonte, os desenvolvedores podem produzir sites de documentação com aparência profissional. O DocFX é adaptável e amplamente aplicável em diversos projetos, pois suporta uma infinidade de formatos de marcação e linguagens de programação.

Os desenvolvedores podem criar tutoriais, artigos conceituais e referências de API em sua documentação usando o DocFX. Graças à sua arquitetura adaptável, as equipes podem personalizá-la e estendê-la para atender às suas necessidades específicas. O DocFX também oferece recursos como referências cruzadas, modelos editáveis ​​e suporte para diversos formatos de saída, incluindo HTML e Markdown. Para uma descrição mais detalhada do funcionamento interno e dos métodos do DocFX, visite a Documentação do DocFX .

Primeiros passos com o DocFX

Criar um novo site DocFX

Nesta fase, criaremos um site de documentação básico no seu computador local.

É necessário um conhecimento básico de operações em linha de comando.

• É necessária uma versão do .NET SDK 6.0 ou posterior.

Para instalar a versão mais recente do DocFX, certifique-se de ter o SDK do .NET instalado, abra um terminal e digite o seguinte comando:

dotnet tool update -g docfx

Para iniciar um novo conjunto de documentos, execute:

docfx init

docfx init

Ele cria um arquivo JSON com todas as configurações. Com a ajuda deste comando, você pode criar um novo projeto DocFX no diretório de trabalho atual. Para criar o conjunto de documentos, execute:

docfx docfx.json --serve

docfx docfx.json --serve

A página web agora pode ser visualizada em http://localhost:8080.

Salve suas alterações. O DocFX é configurado usando o arquivo de configuração JSON. Agora, vamos usar um novo terminal para executar este comando para reconstruir o site e visualizar as alterações locais:

docfx docfx.json

docfx docfx.json

Funcionalidades do DocFX

Integrando o DocFX com o IronPDF

Ao combinar o DocFX com o IronPDF, os desenvolvedores podem aproveitar as vantagens de cada ferramenta e aprimorar seu processo de documentação. Os desenvolvedores podem garantir uma renderização consistente em todos os dispositivos, criar documentação pronta para uso offline e facilitar o compartilhamento e a distribuição utilizando o IronPDF para converter a documentação HTML gerada pelo DocFX para o formato PDF. Para saber mais sobre o IronPDF, consulte a Documentação do IronPDF .

Instale o IronPDF

• Inicie o projeto do Visual Studio.
• Selecione "Ferramentas" > "Gerenciador de Pacotes NuGet " > "Console do Gerenciador de Pacotes".
• No console do Gerenciador de Pacotes do Visual Studio, digite o seguinte comando (corrija esta linha para um comando de instalação de pacote adequado):

Install-Package IronPdf

• Como alternativa, você pode instalar o IronPDF usando o Gerenciador de Pacotes NuGet para Soluções. Você pode selecionar o pacote IronPDF nos resultados da pesquisa e, em seguida, clicar na opção "Instalar". O Visual Studio cuidará do download e da instalação para você.

  

• O NuGet instalará o pacote IronPDF juntamente com todas as dependências necessárias para o seu projeto.
• Após a instalação, o IronPDF poderá ser utilizado em seu projeto.

Implementando a lógica

A seguinte lógica está envolvida no processo de integração:

1. Crie documentação com o DocFX: Para começar, use o DocFX para criar sua documentação. Para gerar a documentação HTML, é necessário executar o processo de compilação do DocFX no código-fonte e nos arquivos Markdown do seu projeto.
2. Use o IronPDF para converter documentação HTML em PDF: Depois que a documentação HTML for criada, utilize o IronPDF para convertê-la programaticamente para o formato PDF. Converter texto HTML em documentos PDF imprimíveis é fácil usando os recursos de conversão de HTML para PDF do IronPDF.
3. Automatize o processo de conversão: Utilize código C# ou scripts para automatizar o processo de conversão e otimizar o fluxo de trabalho. Isso garante que a documentação possa ser facilmente atualizada e regenerada caso não seja necessária intervenção manual.

using IronPdf;

class Program
{
    static void Main()
    {
        // Create a new HtmlToPdf Renderer
        var Renderer = new HtmlToPdf();

        // Render the webpage as PDF
        var PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html");

        // Save PDF to a file
        PDF.SaveAs("output.pdf");

        // Inform the user of successful PDF creation
        Console.WriteLine("PDF generated successfully!");
        Console.ReadKey();
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Create a new HtmlToPdf Renderer
        var Renderer = new HtmlToPdf();

        // Render the webpage as PDF
        var PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html");

        // Save PDF to a file
        PDF.SaveAs("output.pdf");

        // Inform the user of successful PDF creation
        Console.WriteLine("PDF generated successfully!");
        Console.ReadKey();
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Create a new HtmlToPdf Renderer
		Dim Renderer = New HtmlToPdf()

		' Render the webpage as PDF
		Dim PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html")

		' Save PDF to a file
		PDF.SaveAs("output.pdf")

		' Inform the user of successful PDF creation
		Console.WriteLine("PDF generated successfully!")
		Console.ReadKey()
	End Sub
End Class

Para saber mais sobre o exemplo de código, consulte este guia de uso de exemplo . O resultado da execução é mostrado abaixo:

Conclusão

Finalmente, os desenvolvedores têm uma opção robusta para criar e disseminar documentação de alta qualidade em formato PDF, integrando o DocFX ao IronPDF em C#. Os desenvolvedores podem produzir documentação extensa e pronta para uso offline, de fácil acesso e compartilhamento, combinando os recursos de produção de PDF do DocFX e do IronPDF para geração de documentação. Essa integração aprimora o fluxo de trabalho de documentação, melhora a legibilidade e a acessibilidade da documentação do projeto e aumenta a probabilidade de sucesso do projeto de software.

Os desenvolvedores podem otimizar seus procedimentos de documentação, melhorar o trabalho em equipe e a comunicação, e proporcionar melhores experiências de documentação para usuários e partes interessadas, implementando as recomendações deste artigo e utilizando os recursos do DocFX e do IronPDF.

O pacote $799 Lite inclui uma licença perpétua, um ano de manutenção do software e uma atualização da biblioteca. O IronPDF oferece licença gratuita com restrições de redistribuição e tempo. Os usuários podem avaliar a solução durante o período de teste sem precisar ver uma marca d'água. Para obter informações adicionais sobre preço e licença, consulte os detalhes de licenciamento do IronPDF.