Как создать PDF документацию для LLVM?

Question

LLVM поставляется с HTML-документацией, там нет загружаемых PDF-файлов. Есть ли способ создания PDF документации для него?

Answer 1

LLVM использует sphinx для генерации своей документации, а sphinx поддерживает генерацию pdf документации через latexpdf. Предполагая, что у вас установлены как sphinx, так и latex, в системе Unix все, что вам нужно, это небольшой патч для сгенерированного файла латекса, чтобы обойти усердное использование некоторых символов Unicode, не поддерживаемых по умолчанию пакетом inputenc.

Полная процедура может выглядеть следующим образом:

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

Обратите внимание, что документация на самом деле не проверена / не поддерживается для вывода в формате pdf, поэтому здесь и там будет несколько глюков. Вывод длиной 820 страниц.

Answer 2

Это очень просто. Загрузите приложение для своего браузера, такое как Web2PDF для Chrome (таких приложений много, их можно найти в онлайн-магазине Chrome, просто Google для вашего браузера), и оно преобразует веб-страницу, которую вы ищете, в PDF.

Если вы предпочитаете инструмент CLI, wkhtmltopdf - очень хороший инструмент.