Como gerar documentação em PDF para o LLVM?

2

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

    
por Kuba Ober 08.12.2013 / 23:58

2 respostas

2

O LLVM usa o sphinx para gerar sua documentação, e o sphinx suporta a geração de documentação do pdf via latexpdf. Supondo que você tenha tanto a esfinge quanto o látex instalados, em um sistema unix, tudo o que você precisa é de um pequeno patch para o arquivo de látex gerado funcionar com o uso zeloso de alguns caracteres Unicode não suportados pelo pacote inputenc.

Um procedimento completo pode ter a seguinte aparência:

#! /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 ../..

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

    
por 08.12.2013 / 23:58
1

É muito fácil. Faça o download de um aplicativo para seu navegador como Web2PDF para o chrome (há muitos desses aplicativos, esse pode ser encontrado na Chrome WebStore, basta pesquisar no google pelo navegador) e ele converterá a página da Web que você está vendo em pdf .

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

    
por 09.12.2013 / 00:23

Tags