Como gerar documentação em PDF para LLVM?

Como gerar documentação em PDF para LLVM?

O LLVM vem com documentação html, não há pdfs para baixar. Existe uma maneira de gerar documentação em PDF para isso?

Responder1

O LLVM usa o sphinx para gerar sua documentação, e o sphinx suporta a geração de documentação em PDF via latexpdf. Supondo que você tenha o sphinx e o latex instalados, em um sistema unix, tudo que você precisa é de um pequeno patch para o arquivo latex gerado para contornar o uso zeloso de alguns caracteres Unicode não suportados por padrão pelo pacote inputenc.

Um procedimento completo pode ser o seguinte:

#! /bin/bash
svn co http://llvm.org/svn/llvm-project/llvm/branches/release_34/docs llvm34-doc
cd llvm34-doc
make -f Makefile.sphinx latex
patch -p0 <<ZZZ
--- _build/latex/LLVM.tex   2013-12-08 17:54:29.000000000 -0500
+++ _build/latex/LLVM.tex   2013-12-08 17:54:08.000000000 -0500
@@ -3,6 +3,13 @@
 \documentclass[letterpaper,10pt,english]{sphinxmanual}
 \usepackage[utf8]{inputenc}
 \DeclareUnicodeCharacter{00A0}{\nobreakspace}
+\usepackage{pifont}
+\DeclareUnicodeCharacter{2264}{$\leq$}
+\DeclareUnicodeCharacter{2265}{$\geq$}
+\DeclareUnicodeCharacter{2260}{$\neq$}
+\DeclareUnicodeCharacter{21D2}{$\Rightarrow$}
+\DeclareUnicodeCharacter{2714}{\ding{51}}
+\DeclareUnicodeCharacter{2718}{\ding{55}}
 \usepackage[T1]{fontenc}
 \usepackage{babel}
 \usepackage{times}
ZZZ
cd _build/latex
make
cd ../..

Observe que a documentação não é realmente testada/mantida para saída em PDF, portanto, haverá algumas falhas aqui e ali. A saída tem 820 páginas.

Responder2

Isso é muito fácil. Baixe um aplicativo para o seu navegador, como Web2PDFo Chrome (existem muitos desses aplicativos, este pode ser encontrado na Chrome WebStore, basta pesquisar no Google para o seu navegador) e ele converterá a página da web que você está procurando em um PDF.

Se você preferir uma ferramenta CLI,wkhtmltopdfé um instrumento muito bom.

informação relacionada