Differential D29573 Diff 87226 documentation/content/en/books/fdp-primer/doc-build/_index.adoc

Changeset View

Standalone View

documentation/content/en/books/fdp-primer/doc-build/_index.adoc

	Show First 20 Lines • Show All 86 Lines • ▼ Show 20 Lines
	....			....
	====			====

	[[doc-build-rendering-pdf]]			[[doc-build-rendering-pdf]]
	=== Rendering to pdf			=== Rendering to pdf

	To generate a document in `pdf` format use this command.			To generate a document in `pdf` format use this command.
	In this example the English Handbook will be used.			In this example the English Handbook will be used.
	In order to export the document correctly all the extensions should be passed used the `-r` argument.			In order to export the document correctly all the extensions should be passed using the `-r` argument.

	[[document-pdf-example]]			[[document-pdf-example]]
	.Build the entire documentation project			.Build a document in pdf
	[example]			[example]
	====			====
	[source,shell]			[source,shell]
	....			....
	asciidoctor-pdf -r ./shared/lib/man-macro.rb -r ./shared/lib/git-macro.rb -r ./shared/lib/packages-macro.rb -r ./shared/lib/inter-document-references-macro.rb -r ./shared/lib/sectnumoffset-treeprocessor.rb --doctype=book -a skip-front-matter -a pdf-theme=./themes/default-pdf-theme.yml content/en/books/handbook/book.adoc			% cd ~/doc/documentation
				% asciidoctor-pdf \
				-r ./shared/lib/man-macro.rb \
				-r ./shared/lib/git-macro.rb \
				-r ./shared/lib/packages-macro.rb \
				-r ./shared/lib/inter-document-references-macro.rb \
				-r ./shared/lib/sectnumoffset-treeprocessor.rb \
				--doctype=book \
				-a skip-front-matter \
				-a pdf-theme=./themes/default-pdf-theme.yml \
				-o /tmp/handbook.pdf
				content/en/books/handbook/book.adoc
	....			....
	====			====

	[[doc-build-toolset]]			[[doc-build-toolset]]
	== The FreeBSD Documentation Build Toolset			== The FreeBSD Documentation Build Toolset

	These are the tools used to build and install the FDP documentation.			These are the tools used to build and install the FDP documentation.

	▲ Show 20 Lines • Show All 160 Lines • Show Last 20 Lines