PDF Properties
Using a custom set of XML tags inside your HTML, you can insert both custom metadata as well as instructions for how the PDF would be viewed in a PDF viewer application (subject of course to that application supporting those features).
Options
You use the (optional) tag <pdfproperties> and within that tag you
can insert <metainfo> and <pdfpreferences>
sections as shown in the instructions below. Within the
<metainfo> tag, you can add <prop> tags
with @name, @value attribute pairs with the data you wish
to store in the PDF metadata. Anything without one of the recognized, standard PDF
names (author, title, subject,
creator, keywords) are stored in custom metadata in
the PDF.
The <pdfpreferences> section allows you to insert one or more
<pref> tags with specific @name,
@value pairs that control the way the resulting PDF is displayed
with a viewer that supports standard PDF view attributes. The support
name, @value pairs are listed below and grouped into
all the available categories:
General PDF Options
These options let you control some general information about the generated PDF.
bookmarks - sets whether PDF bookmarks are generated or not. The default
is "false" for Cloudformatter. You can set @value to "true" if you want
bookmarks in PDF. Note that bookmarks are only generated for interpreted
hierarchical information. All h1 elements and there following
h2 elements and so on. Skipping levels will break the sequence and
the bookmarks will not be correct.
pdf-version - sets the PDF version number. The default is version 1.5
for Cloudformatter but you set @value to values like "1.3", "1.4",
"1.6" or "1.7" if you wish to change the version. Be aware thar some other features
could be disabled by setting the version too low.
compress - sets whether the PDF is compressed or not. The default is
"true" for Cloudformatter. You can set @value to "false" if you want
uncompressed PDF.
linearize - sets whether the PDF is linearized or not. The default is
"false" for Cloudformatter. You can set @value to "true" if you want to
optimize a long PDF for web view.
PDF View Options
These options let you control how the PDF when opened appears to the end user.
view-mode - Choose from one of the following:
auto- If there are bookmarks in the document, the bookmarks pane is displayed. Otherwise, all auxiliary panes are hidden.show-none- All auxiliary panes are hidden.show-bookmarks- The bookmarks pane is displayed.show-thumbnails- The thumbnails pane is displayed.full-screen- The document is displayed in full screen-mode.
initial-zoom - Choose from one of the following:
auto- Page scaling is not specified.fit- The page is scaled to fit completely into the view port.fit-width- The page is scaled so that its width matches the width of the view port.fit-height- The page is scaled so that its height matches the height of the view port.###or####%- The page is scaled by the number or percentage specified.
page-layout - Choose from one of the following:
auto- Uses settings of viewer application.single-page- Displays one page at a time.continuous- Displays pages continuously in one column.two-columns-left- Displays pages continuously in two columns, with odd-numbered pages to the left.two-columns-right- Displays pages continuously in two columns, with odd-numbered pages to the right.two-pages-left- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the left.two-pages-right- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the right.
viewer-preferences - A comma separated list of the following
possibilities:
hide-toolbar- Hides the viewer application's tool bars when the document is active.hide-menubar- Hides the viewer application's menu bar when the document is active.hide-window-ui- Hides user interface elements in the document's window (such as scroll bars and navigation controls), leaving only the document's contents displayed.fit-window- Resizes the document's window to fit the size of the first displayed page.center-window- Positions the document's window in the center of the screen.display-document-title- Controls whether the window's title bar displays the document title taken from the "title" metadata field.
PDF Security
These options allow you to specify owner and user security in the PDF output. User-level security can inject a password to be used to open the PDF, while owner-level security can control what can be done with the PDF (like printing it or copying the data from it).
userpassword - Sets the user password that must be entered to view the
PDF. There are no options, the @value passed is the password to be
used.
ownerpassword - Sets the owner password that must be entered to enable
advanced processing of the PDF. There are no options, the @value passed
is the password to be used. An ownerpassword is used to lock down certain privledges
that an owner will grant to a recipient of the PDF. Without the owner password,
recipients can be restricted from certain things. By default they are restricted
from everything, and you can then specify what additional things you allow by using
userpriviledges.
userpriviledges - A comma separated list of the following
possibilities:
print- Enables printing the document.modify- Enables editing the document.copy- Enables copying text and images from the document to the clipboard.annotate- Enables adding notations to the document and changing the field values.
PDF Pre-Press Options
These allow you to specify crop marks, bleeds and registration marks to be applied to the PDF.
crop-offset - specify offsets from the meaningful content on the page to
the edges of the physical media (/MediaBox entry in the PDF page dictionary). Its
value is a series of 1 to 4 length specifiers that set offsets from the edges of the
page area to the corresponding edges of the /MediaBox. Rules for expanding the value
are the same as for the padding property in CSS.
bleed - specify the bleeds — an extra space around the page area into
which the contents of the page may protrude (/BleedBox entry in the PDF page
dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from
the edges of the page area to the corresponding edges of the /BleedBox. Rules for
expanding the value are the same as for the padding property in CSS.
crop-mark-width - defines line width for the crop marks, setting it to 0
disables drawing of crop marks.
bleed-mark-width - defines line width for the bleed marks, setting it to
0 disables drawing of bleed marks.
printer-mark - specify additional SVG images to be drawn in the offset
area surrounding the page (specified by crop-offset and bleed parameters). Printer
marks are clipped to the outside of the bleed rectangle. The @value is
a URL to an SVG you have. This sample has two URLs (one for a colorbar and one for a
registration mark) you can also use if you like.
The following code is what is behind this page for producing the PDF. Of course, you would only see the things supported by your PDF viewer you use. If you wish to see them all in action, then use "download" and Adobe Reader to view the PDF.
Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.
<pdfproperties style="display:none;">
<metainfo>
<prop name="author" value="Xportability LLC"></prop>
<prop name="title"
value="Xportability Cloudformatter: Showing Custom
PDF Properties"></prop>
<prop name="subject" value="A Cloudformatter Document"></prop>
<prop name="creator" value="css2pdf@cloudformatter.com"></prop>
<prop name="keywords" value="CSS, PDF, Cloudformatter"></prop>
<prop name="custom1" value="value1"></prop>
<prop name="custom2" value="value2"></prop>
<prop name="custom3" value="value3"></prop>
<prop name="custom4" value="value4"></prop>
</metainfo>
<pdfpreferences>
<pref name="bookmarks" value="true"></pref>
<pref name="pdf-version" value="1.6"></pref>
<pref name="view-mode" value="auto"></pref>
<pref name="initial-zoom" value="fit-height"></pref>
<pref name="page-layout" value="two-columns-left"></pref>
<pref name="viewer-preferences" value="display-document-title"></pref>
<pref name="crop-offset" value="0.5in"></pref>
<pref name="crop-mark-width" value="1px"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/registration.svg"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/colorbar.svg"></pref>
</pdfpreferences>
</pdfproperties>
Sample Output H2
Eirmod at dolore ea invidunt ipsum gubergren justo rebum rebum est nonummy dolore iriure voluptua. Takimata elitr erat nonummy sadipscing dolores ipsum rebum dolor dolor eirmod dolor sed dolore elitr. Aliquip sadipscing sit suscipit ad at esse veniam justo amet autem ipsum kasd nonummy labore at nisl sed amet. Dolores eu sit tempor et consetetur dolor labore dolores nonummy diam et accusam et. Nonumy duo ipsum qui nobis eirmod commodo no mazim ipsum aliquam lorem nam duo stet in lorem invidunt eu.
Elitr takimata ipsum sanctus feugiat lorem clita sanctus eos magna consetetur sed aliquip erat et nisl. Stet sed et accusam tempor ea duo diam gubergren ea. Lorem sed option facilisi dolor amet sit no vel rebum vero molestie lorem ipsum ut accusam sed erat. Accumsan eos vero feugiat. Facilisi ex sanctus elit vulputate justo. Duo nonumy nulla ut amet amet tempor diam et dolore et duo. Accusam facilisis diam duo hendrerit magna eirmod clita sea elitr magna ad erat. Ea et nibh erat ipsum volutpat dolore. Amet dolor aliquam velit et vero eirmod dolore quis vulputate nonumy ipsum ex amet voluptua eirmod elitr gubergren aliquyam. Euismod sit voluptua ut sit lobortis ipsum sea voluptua sit. Justo hendrerit dolores magna.
Sample Output H3
Duo gubergren stet eos tempor consequat elitr sanctus ea sea illum. Placerat diam diam diam ea amet commodo lorem elit clita dolore lorem magna takimata nulla. Et eu et ut vero. Eos amet amet nibh invidunt magna ut placerat magna. Est dolor soluta nonummy dolor dolore feugiat nonumy eleifend erat labore euismod kasd. Tincidunt clita elitr magna sadipscing ut clita amet. Ipsum labore gubergren eirmod nisl no et wisi elitr magna ipsum. Quis et sed no tempor sit voluptua ea elit et minim hendrerit nam dolor et diam. Eirmod amet et aliquam et duis eum elitr consetetur vero magna dolores sed.
Sea minim ea dolor stet eos est ut invidunt vel aliquyam labore invidunt diam ex ut sadipscing. Rebum sadipscing invidunt. Veniam in eos amet et sadipscing diam. Ea aliquyam sed laoreet nonummy consetetur tempor dolor sed et erat kasd magna diam elitr ut amet. Minim dolor tempor vero ea lorem hendrerit diam dolor sed at. Takimata sanctus no hendrerit. Nostrud sanctus stet feugait takimata enim feugait et dolor ea voluptua.
Sample Output H4
Amet et sanctus quis ea cum takimata amet sed. Eum vulputate sadipscing zzril consetetur magna diam amet sit velit stet luptatum veniam magna diam. Voluptua iriure sea justo ut labore blandit lorem diam eu sed kasd clita vero labore nobis ea eros. Ipsum ea lorem et ut justo ea et luptatum sea elit ea hendrerit dolor consetetur vero et suscipit. Erat aliquyam tempor exerci accumsan autem diam amet eirmod dolore accusam kasd et amet no accumsan. Sed no et lorem et gubergren ipsum. Et dolores et exerci tempor eum laoreet dolor stet ut iusto ea sit consetetur et. Et voluptua augue consetetur erat dolor ea clita sed. Eleifend dolores dolore eos at stet ut est.
Est gubergren dignissim rebum et rebum ipsum ipsum mazim quod eos. Consetetur sadipscing aliquyam sadipscing enim no no. Dolor est aliquyam blandit magna ullamcorper ea sed at et no kasd clita gubergren dolore tincidunt vero duis iriure. Ipsum eum et cum eum dolor vulputate eirmod elitr dolore sanctus. Autem ut et sit erat dolores. Clita illum rebum clita eos rebum vulputate. Ut diam accusam lorem ea vel kasd voluptua. Invidunt diam sanctus dolores et sed ipsum voluptua quis in accusam molestie illum magna augue facilisi magna. Dolore aliquip labore sed invidunt.
Sample Output H4
Nam qui in nostrud sed stet labore lorem justo ea ipsum clita labore sit sea dolore tempor. At duo justo duo autem accumsan aliquyam et dolore sed hendrerit takimata. Laoreet et elitr nonumy dolore laoreet vel esse at molestie iusto duo. Doming gubergren wisi dolor mazim ut. Nonumy commodo lorem.
Accusam eu diam takimata nulla ut tincidunt stet clita autem augue sea consequat wisi vero. Ipsum adipiscing dolore ea sit nonumy rebum accusam vulputate nonummy invidunt et no. Vero rebum accusam eos blandit no amet magna erat et amet tempor magna sit magna takimata. Vero amet hendrerit sit stet et diam voluptua et cum quis hendrerit labore ipsum. Molestie erat accumsan dolores eirmod augue ea. Et vero aliquyam dolore et stet facilisis sit nonumy aliquyam erat. Dolores praesent ad amet facer aliquyam amet dignissim at ut kasd sit nonummy justo molestie dolor accusam aliquyam. Iusto no tempor justo tation iriure vulputate nonumy eum dolore dolore dolore no magna at no. Nihil rebum dolor takimata sed rebum nonumy lorem consectetuer sadipscing clita sit ipsum et gubergren gubergren sadipscing lobortis dolor. Elit takimata dolor ea at et amet nonumy molestie dolor lobortis diam consetetur rebum.
Sample Output H3
Invidunt rebum sadipscing. Ea dolor erat commodo in nonumy sit labore voluptua clita. Et justo imperdiet est facer duis erat et dolore justo amet dolore. Est magna takimata et consectetuer et vero duis nulla nam. Consetetur sed labore sit volutpat. Sed diam consetetur tempor in et vel no labore et takimata sit diam sit et sed luptatum. Sea magna sit sed elitr in ea clita praesent nibh kasd exerci invidunt commodo dolore vero nonumy.
At delenit ea gubergren vero ea qui dolores lobortis sea kasd aliquam dolores et amet. Hendrerit ut sit invidunt. Lorem sanctus labore ipsum eu. No ut adipiscing et diam erat gubergren vulputate stet consetetur et accusam magna. Volutpat et kasd invidunt gubergren vel. Sit facilisis diam hendrerit consetetur stet amet accusam diam rebum sea sadipscing sit. Rebum justo elitr accusam facer sea magna zzril duis duo vel. Aliquip accusam eum consetetur no elitr. At stet no feugait doming stet et consequat et tempor eu stet erat duo erat.
Sample Output H4
Esse et esse vulputate laoreet ea dolor facer sea sea nulla. Duis dolore est et justo eirmod nihil lobortis kasd vel sea magna mazim eirmod nostrud labore. Ipsum dolor et rebum dolore est diam labore et duo ut. Ipsum lorem ut est sadipscing et lorem tincidunt autem. Zzril illum invidunt amet sanctus clita rebum consetetur et dolor. Invidunt est no gubergren kasd nulla sed ea diam lorem lorem magna clita takimata consetetur eos ipsum duo enim. At iusto veniam sit et diam nobis lorem at sea. Amet nulla accumsan dolores. Vulputate consetetur magna sadipscing voluptua no et te vero.
Iriure eum nonumy elit facilisis takimata sed takimata ipsum clita stet diam amet stet rebum et assum at sea. Voluptua sed nulla ex feugait ut dolore sed et sit amet magna eu dolor. Stet velit sed magna eirmod ipsum dolores ipsum et in ipsum kasd aliquyam eu nonumy sit velit justo. Dolor commodo dolores tation et diam lorem enim eirmod consequat veniam vero sadipscing. Est sed feugiat eros sadipscing justo autem est. Gubergren et odio invidunt lorem amet magna aliquam consequat et stet sit at lorem sit takimata lorem cum eos. Et ut tempor.
Sample Output H4
Eros vulputate facilisis accumsan hendrerit amet velit sed augue. Amet labore diam delenit rebum eos diam erat diam. Nulla vel odio ea. Magna labore eros elitr vel. Lorem diam illum aliquyam nulla magna consetetur. Accusam et invidunt clita veniam. In ipsum lorem eros diam dolor autem sit delenit eirmod stet.
Odio duo molestie erat facer magna sanctus nulla eos invidunt illum invidunt duo labore eirmod gubergren sea erat. Elitr rebum sit gubergren elit labore. Justo et invidunt sit eum dolores quod augue eos et liber sadipscing sit magna. Justo aliquam eos accusam velit sed. Kasd labore placerat dolor sit sadipscing magna vel nonummy ipsum eum nonumy magna molestie feugait.
More Sample Output H2
Dolores clita lorem kasd amet dolore ipsum dolore. Sit consetetur vero vulputate no minim consetetur. Ut dolor est dolores possim zzril dolores augue rebum commodo ipsum et enim eirmod gubergren vero nonumy. Sed ipsum dolor clita vero sadipscing aliquyam et dolore invidunt dolore diam ad dolor amet. Amet takimata est kasd sit augue ullamcorper lorem ut amet sit takimata eirmod aliquyam labore dolor. Accusam dolores diam esse delenit quis eum suscipit rebum nonumy magna erat invidunt eirmod erat no nulla. Tempor duo volutpat.
Aliquyam lorem voluptua erat voluptua et assum magna sit aliquyam aliquyam. Dolores duo velit commodo sed sadipscing et dolore feugait voluptua justo nonummy sanctus accusam. Facilisis tempor et et ullamcorper rebum invidunt dolor nisl hendrerit esse. Dolore consetetur in augue amet sadipscing aliquyam clita. Diam minim takimata et sadipscing diam nonumy aliquam sit rebum vero ut clita no.
Sample Output H3
Sit diam erat. Velit et gubergren exerci placerat elitr tempor et nostrud et stet voluptua feugait et esse nulla takimata. Et illum sit ullamcorper dolor at sed dolor et esse delenit at diam lorem sit. Lorem takimata nisl eu justo labore placerat. Gubergren dolore consetetur dolor stet amet aliquyam vulputate erat et eos sed invidunt aliquyam eleifend ut consequat amet. Magna eirmod amet praesent labore no amet eum feugiat. Mazim diam feugiat sed diam duis et magna magna et vero dolor sed ipsum delenit rebum. Sed et at erat lorem sea magna accusam dolor gubergren lorem. Et justo accusam facilisi dolor est amet voluptua dolores erat amet aliquyam lorem dolor sed augue vero voluptua dolor. Ipsum dolores duo dolore sanctus ipsum sadipscing kasd ut takimata tempor facer accusam accusam sadipscing rebum et eos rebum.
Est at amet consetetur sit rebum feugiat delenit erat minim vero sea sit sed est justo. Ipsum placerat clita dolor at no elitr gubergren. Dolore gubergren rebum takimata sit amet sea eirmod eu quis amet sea consetetur sed nostrud consectetuer et. Consetetur vel feugait autem diam nonumy vel invidunt elitr ea dolor. Ea hendrerit illum ipsum et liber aliquip consetetur nulla ex illum exerci hendrerit stet. Stet in kasd labore eleifend no duo ipsum sit. Nobis takimata duo tincidunt ea ipsum mazim diam lorem sit elitr accumsan.
Sample Output H4
Sea ut vulputate iriure dolor delenit ut takimata vero tation diam no voluptua luptatum ea lorem sit at labore. Minim delenit sed dignissim zzril nihil voluptua praesent eos. Amet velit et diam diam et diam magna eirmod feugiat lorem doming et. Labore vel sed voluptua quod amet lorem stet et nonumy aliquyam sed magna invidunt aliquyam magna ut. Commodo euismod amet amet consequat et in lorem dolores. Sed dolore et accusam feugiat facer dignissim aliquyam ut labore at ut ea illum.
Gubergren eu sit sit in eos no autem sadipscing nulla. Dolores voluptua no lobortis id dolore in. Iriure amet takimata eum erat duo lorem elit justo dolore. Diam duo zzril ut no et lorem adipiscing elit duo luptatum accumsan diam justo erat tempor feugait. Facilisis commodo sanctus nonummy vero no vero qui accusam et. Id exerci justo tempor ea tempor sea dolor et lorem vel sed et sadipscing possim rebum voluptua lorem. Sit dolor vero justo id rebum sanctus augue amet sanctus sea no molestie labore. Nonumy at clita aliquam amet dolor et molestie takimata. Dolore sea et esse ipsum sit consequat magna eum zzril et et. Consetetur eos nulla tation delenit feugiat erat eos.
Sample Output H4
Consequat ipsum ea ut et aliquam voluptua aliquyam nulla dolores euismod duis sanctus dolore dolor et consetetur facer. Takimata nam congue duo enim. Delenit dolores augue at ipsum amet velit eirmod eirmod takimata. Est gubergren rebum ipsum exerci dignissim takimata lorem et ad. Consetetur amet eirmod. Nisl et stet adipiscing labore labore wisi lorem. Dignissim tincidunt et in et invidunt vulputate. Sea zzril liber labore voluptua sed duo ut elitr ea ut et vel eos dolor ipsum sit tation ut. At vero imperdiet suscipit clita vero sed aliquyam rebum veniam. No elitr amet lobortis sed dolor ea no elitr ipsum imperdiet in justo rebum sed.
No vulputate eros labore amet nonumy te et lorem. Eos dolor stet lorem. Autem aliquam eirmod sed dolor molestie eos sit ut sadipscing nostrud feugiat erat feugiat diam dolor. Commodo enim hendrerit amet eirmod magna ea sit sea dolore voluptua lobortis nulla clita erat ut at kasd wisi. Sit erat consetetur ipsum ipsum gubergren.
Sample Output H3
Et diam accusam gubergren stet diam et duo ipsum. Sea molestie vero takimata exerci. Et ea invidunt ea sit magna laoreet lorem nulla ut et justo aliquam ipsum no diam et kasd. Exerci amet zzril labore velit diam iriure diam wisi sea dolore vel et velit sed et accusam vero. Eirmod sed no et dolor velit sea ipsum ipsum consetetur sit dolore diam eum. Sit et sit dolore magna vero lorem sadipscing sea dolor exerci labore at nulla vulputate labore aliquam. Duo vero praesent ut erat ad. Diam tempor sit gubergren ea dolor lorem. Imperdiet no clita ipsum eos. Sit gubergren esse sit.
Dolor vel takimata elitr consetetur dolor ut feugiat sed eu clita tempor. Ex praesent eirmod sea illum dolore amet tation stet iriure accusam euismod option ea. Dolores sea sit dolor congue. Commodo dolor ea dolor lorem duo odio te vel dolores ea voluptua dolor sed consetetur aliquyam no luptatum. Lobortis dolor eirmod sanctus invidunt consectetuer iriure eu aliquyam clita. Erat kasd vero dolor dolor magna nisl lorem ut quod sea stet aliquyam nostrud. Soluta ea elitr dolor tempor enim dolor in amet dolor feugait. Stet takimata est lorem diam et lorem eirmod lorem dolor quis nonumy eos placerat est magna.
Sample Output H4
Nonumy no sed kasd erat diam sed no vero commodo exerci dolor erat et kasd et quod. Aliquyam nonumy dolores. Feugiat velit accusam zzril eirmod ipsum at rebum sit dignissim at dolor. Nobis stet invidunt diam diam aliquyam iriure elitr ut amet dolor suscipit nihil sed veniam dolor ut sit voluptua. Nulla sea eos vulputate ipsum eirmod eirmod. Kasd nonumy takimata tincidunt magna lorem no et elitr et. Sea et ut labore ad. Elitr gubergren vero. Dolores nonumy dignissim sit labore aliquyam invidunt nulla autem clita nonumy sed no dolore sanctus diam. Diam vel justo consetetur dolore vulputate dolor dolores sed. Sed no accusam eos duis ea dolores vero dolores tempor aliquam ipsum autem tempor te sit.
Dolores augue facilisi et at at sed et lorem takimata ut ut facilisi labore tempor ut dolor autem magna. Sed diam takimata est kasd dolores eos. Dolore amet erat consetetur facilisis et sit sed consequat sanctus vel ea exerci eum. Nonumy invidunt ea vel lorem lorem vel at sit takimata justo invidunt diam est consequat. Sea dolores tempor nonumy diam tation.
Sample Output H4
At et et nisl sea sed at lorem et nobis consequat justo facilisis in et euismod ipsum elitr. Erat veniam aliquyam gubergren voluptua gubergren sed nostrud dolore et euismod lorem. Tempor at eos et magna sed. Duo magna ipsum possim facilisi facilisis blandit dolore esse rebum kasd sea rebum invidunt clita nihil erat. Consetetur clita stet ut sadipscing consetetur diam duis ut magna et magna eirmod dolor takimata elitr est ipsum suscipit. Labore erat sed dolor vero duo consetetur duo.
Voluptua sed diam dolor amet erat stet. Nonumy feugait zzril. Amet dolor tincidunt takimata ea. Sit et ea in nonumy assum vel ea magna illum sed at et dolor et sanctus sanctus id diam. Takimata sed est diam et rebum voluptua kasd erat exerci cum consectetuer. Ut gubergren tempor et tempor eirmod sea clita aliquyam ut volutpat velit rebum voluptua elitr nonumy sadipscing sit. Et ipsum ipsum eos amet autem dolore at duis sadipscing ut stet dolore quis et enim vero.