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
Sed placerat delenit amet esse gubergren feugiat et ut feugiat consetetur dolores. Option lorem no accusam sit sed diam no sanctus ut nobis quis praesent adipiscing nulla takimata. Labore accusam duo aliquyam quis accumsan et nostrud dolore dolores nisl tation aliquyam est et sadipscing. Duo invidunt ipsum feugiat clita in sed consetetur ut nam ipsum lorem et kasd sit eros. Dolore ipsum lorem dolor ut. Ea nostrud dolor clita blandit sit voluptua aliquyam magna dolore volutpat eu sed. Feugait rebum nonummy dolor tempor consetetur duo dolores elitr diam vero ut magna duo.
Sadipscing accusam et voluptua et justo volutpat consectetuer eos sadipscing dolor. Duo et laoreet stet in sit labore duo. Invidunt quis elitr voluptua magna lorem te nonumy clita et no eos eu sed eum. Ea facilisis vulputate ea ipsum tempor facilisis ut. Amet no aliquam consetetur diam autem aliquyam ut takimata ipsum erat sed justo erat. Takimata feugait gubergren voluptua ipsum nisl ipsum et voluptua facilisis. At ad lorem kasd vulputate magna takimata et et sit eirmod amet invidunt accusam.
Sample Output H3
Sea at sit nulla. Lorem takimata exerci. Voluptua takimata ad takimata wisi vel clita ea option eirmod lorem est. Molestie commodo labore ipsum at in et delenit at et ut cum sit dolore dolor et sit. Feugait ad ut quis quod at no ea consetetur voluptua aliquyam suscipit aliquip aliquyam quis gubergren diam dolor nulla. Ipsum consequat hendrerit accumsan dolor diam sadipscing justo justo laoreet. Sadipscing dolore dolores facilisi in nonummy vero est no amet te consetetur sadipscing et diam consequat amet. Invidunt at takimata illum. In eos at sit sea ipsum ea. Rebum et eos eirmod vero.
Tempor consequat et dolor duis sit tempor eum doming sed. Takimata lorem dolore amet magna. Nulla eum kasd illum luptatum nulla illum ipsum consetetur at magna sanctus justo amet. Amet iusto ipsum lorem vero gubergren dolore sanctus justo commodo consequat sanctus veniam erat dolor ullamcorper magna et nostrud. Stet ut sanctus et accusam sit amet ullamcorper voluptua et tempor et amet et sea tation. Rebum diam clita rebum eirmod at invidunt tempor accumsan vero mazim eros duo. Nulla et ipsum ipsum amet ad magna labore vero ea consetetur dolore erat.
Sample Output H4
Gubergren te eirmod at voluptua. Amet voluptua clita eros lorem et duo rebum consetetur dolore. Sea voluptua diam duo. Adipiscing sit consetetur option aliquyam dolores est in eros clita sea ea enim dolor lobortis praesent in. Erat lorem no nonummy clita. Stet justo erat clita ea. Ipsum accusam nam dolores stet sed magna doming tation et et vero labore. Stet odio amet. Dolores stet lorem dolor gubergren labore.
Ut et amet consetetur eirmod elitr vero eirmod gubergren tempor no nihil labore stet ut et vero sit sed. Sadipscing at lorem sed justo ipsum sit dolor vero dolore sed eos amet. Accusam duis sea dolor amet erat sit aliquyam diam voluptua sed accusam luptatum aliquam kasd et et. Suscipit sit nulla te gubergren gubergren at nonumy wisi est magna lobortis. Dignissim ipsum elitr eos tempor sea diam dolor amet consequat minim eos suscipit vel. Sit et sed sed praesent et consectetuer eu imperdiet nulla ex.
Sample Output H4
Sanctus feugiat dolor elit elitr. Elitr eos tincidunt duis. Sea sit clita odio duo duo sit hendrerit diam sea facilisi takimata rebum invidunt dolor. Labore minim ad gubergren tempor diam nonumy sit ipsum diam sed diam in diam quod voluptua. Vel et accusam aliquam aliquyam rebum feugiat ut sea hendrerit rebum et diam kasd consetetur possim lorem at. Kasd diam qui duo et ea cum consequat justo sanctus et iusto duo diam. Dolor takimata magna ut lorem dolores invidunt elitr. Et elitr congue dolor accusam ipsum justo.
Sit ea duo magna. No sed sit ipsum est clita sed dolore augue vel diam justo eirmod lobortis duo. No at ipsum sea dolores labore et diam facilisis et invidunt dolore eos. Magna dolore et elitr consequat kasd nibh qui aliquyam stet odio amet minim erat eos dolor ea clita dolores. Elitr nonumy et vero magna erat vero sanctus lorem et. Gubergren gubergren minim ipsum elitr erat. Et ut kasd ipsum amet cum stet nulla et eirmod labore vero lorem at. Sea sed sed. Iriure clita iusto. Accusam dolores feugiat molestie. In sit at rebum lorem lorem vulputate dolore ut eirmod.
Sample Output H3
Iusto sit sea diam eos no duis vel aliquyam enim at clita aliquyam aliquyam. Duo sadipscing exerci ut vel et et eirmod voluptua clita justo rebum sit justo dolore eros. Dolor iriure et kasd delenit et lorem sed justo dolor amet no diam stet nisl invidunt esse at. Kasd dolore dolore. Clita clita magna sed ipsum minim eros dolores ipsum sed et ea vel. Nonumy qui eirmod consetetur kasd stet rebum sadipscing aliquyam ex eos adipiscing sadipscing magna.
Et in elit. Sea ipsum dolore consequat amet feugait tempor ut ipsum duo justo ipsum dolore voluptua amet. Qui amet sit duo est. Dolore sit elitr eirmod laoreet ad eos est in labore amet vel. Et dolor est lorem facilisi tempor erat at stet vel labore et sit magna.
Sample Output H4
Ut eirmod feugiat est possim praesent est vulputate sea eirmod stet eum dolore. Ut enim ut nostrud at lorem veniam dolor dolor dolore et dolor ipsum. Nulla stet et diam ut clita sed. Aliquam esse vel nulla et eirmod sed. Sea aliquip exerci hendrerit aliquip luptatum tincidunt sed facilisi. Vero enim veniam lorem nihil elitr et feugait rebum et ea et duis justo magna et lorem. At dolor nam ea gubergren diam iriure at nisl. Consetetur eros at rebum diam. Invidunt feugiat ipsum dignissim. Eos at iusto invidunt accusam ipsum elitr eirmod possim vero aliquyam soluta vero rebum sanctus nihil magna est. At esse vel aliquam ex accusam diam magna at nostrud labore.
Imperdiet duis vero gubergren lorem aliquyam nonumy tempor ut invidunt duo magna ea no tempor sit labore accusam. Sea eu sit diam molestie dolore sed. Sadipscing dolor et amet dignissim tincidunt kasd sanctus. Accumsan aliquyam augue sit dolore duo diam dolor ea amet ut rebum. Lorem invidunt et sit sed et sit sed consequat. Vero elit nonumy justo duo ullamcorper magna amet. Ipsum at nibh est suscipit iusto amet et est molestie ut amet est est tempor ipsum elitr et.
Sample Output H4
Suscipit iusto et tempor amet et velit tempor ea eos diam est nonummy erat voluptua volutpat vero. Consequat dolor dolor lorem duis at amet diam molestie voluptua no et takimata ipsum odio. Rebum congue lorem assum gubergren possim et sea sit dolore ut delenit amet quod nonumy sit est placerat diam. Accusam dignissim diam sed eirmod diam et ad sed consetetur dolor suscipit amet veniam dolores imperdiet. Eos no clita exerci est ipsum quis ipsum invidunt laoreet. Magna diam elit praesent ut assum erat feugait et id sit placerat eos in rebum dolore. Dolor et nisl.
At lorem et sadipscing euismod consequat et. Elitr dolor vel lorem sed takimata te aliquyam et amet et sea. Justo est duo eirmod accusam at stet euismod duis et eos dolore lorem magna vel qui no gubergren. Elitr sed blandit et consetetur et sanctus sanctus erat est. Et labore volutpat in sanctus sadipscing lorem diam. Sed dolor dolor sadipscing magna vero consequat illum. Gubergren sed kasd invidunt takimata amet et dolores dolore vero justo lorem duo et nonumy dolores adipiscing.
More Sample Output H2
Eos voluptua sadipscing lorem est tempor molestie nonumy nonumy ullamcorper ut in tempor sanctus ea et consetetur odio ut. Duo quis est lorem et duo sadipscing et suscipit clita voluptua delenit dolores iriure kasd et. At takimata ipsum accusam diam sadipscing ullamcorper lorem. Aliquip no lorem dolor enim erat duis stet invidunt stet lorem. Aliquyam est diam rebum ea. Elit aliquyam ipsum in amet ipsum et ut duis invidunt sanctus diam luptatum aliquyam autem. Dolores dolores duo no dolores zzril. Et at dolore. Amet sit ut et accusam quod commodo voluptua molestie dolor. Stet diam sadipscing erat nulla enim takimata. Ea invidunt sea sadipscing vulputate.
Eum consetetur justo vero. Et vel dolore no nonumy erat. Amet et ea lorem eos vulputate sadipscing eirmod vel et eirmod amet justo enim erat dolores sed esse invidunt. Facilisis sadipscing amet eos sea kasd lorem sea lorem ipsum duo diam amet ea sea ipsum. Tempor no sanctus amet justo et feugiat sanctus dolor lorem ea tempor aliquyam. Odio ipsum vel ipsum at et sadipscing nonumy eirmod amet duo eos feugait dolore ad amet justo takimata. Velit et sed magna accusam at voluptua vulputate dolores et. Ipsum accusam duo sea dolore diam lorem dolor luptatum dolore vero sed liber sanctus voluptua amet nulla.
Sample Output H3
Duo ut kasd sanctus stet at hendrerit accusam voluptua stet amet et voluptua dolor et minim vel eos. Et stet dolor eos facilisi. Erat sanctus elitr takimata sit sed ipsum consetetur elitr takimata et. Et sanctus et facilisi et sed et esse at ipsum eirmod laoreet at. Diam et magna eum et clita est eirmod labore diam ut diam minim et delenit lorem et. Stet takimata lorem dolores dolores facilisis dolor justo diam diam diam dolore sed justo amet. Stet sed aliquyam. Dolore sea tempor vel sanctus invidunt takimata wisi adipiscing kasd molestie sed rebum sanctus ullamcorper amet ipsum. Est esse autem invidunt et ipsum duis duo placerat et. Sed elitr ut invidunt tempor erat est eos lorem.
Et dolor takimata erat nisl invidunt duo. Consetetur amet ut lorem eos at dolore amet ut diam autem iusto quis sed tempor. Lorem sit sanctus sed voluptua. Diam consetetur dolores vero ex. Erat consetetur stet veniam sit vero eirmod illum autem eirmod stet euismod. Erat justo blandit takimata nonumy lorem sed sea. Feugait ea rebum diam elitr sea vero diam ipsum lorem et.
Sample Output H4
Elitr vero voluptua laoreet diam lorem accumsan labore zzril eirmod clita diam dolor sit gubergren eirmod. Justo euismod no nonumy nisl kasd. Kasd ea stet at et stet rebum et et feugait sed consetetur vel dolor diam ut volutpat. Gubergren veniam duo lorem consetetur sea rebum ipsum et aliquyam magna ipsum et takimata rebum. Tation euismod sed lorem vel clita vero invidunt ea justo eos amet invidunt sanctus vero dolor tation rebum.
Erat clita hendrerit eos clita et congue ut et accusam elitr dolor nulla iriure vero sanctus et. Aliquyam et facer diam erat et ut vel ut eu sanctus stet magna amet delenit. Amet rebum tempor. Diam tincidunt rebum justo sed nonummy aliquyam ipsum qui. Eirmod dolores invidunt ut et sed feugait. Clita dolores nonumy ipsum cum et erat augue dolore sed diam autem ex gubergren et zzril dolores et. Dolor aliquyam sed et dolore stet in sed dolore diam.
Sample Output H4
Dolore sed sadipscing accusam sit congue nonumy et iriure amet et ipsum. Rebum invidunt sed nonumy sit in gubergren sadipscing in elitr et et in sanctus sit gubergren erat. Vel dolor accusam vulputate voluptua sea nisl amet duo sed lorem eos takimata. Nonumy tempor ipsum kasd duo iriure tincidunt tation vel gubergren diam lorem et sit sit in eirmod kasd. Et ut sadipscing duo at eu sit. Zzril accusam aliquyam lobortis invidunt dolores clita dolore. Ipsum vero te gubergren nibh sed stet aliquyam feugait tempor eirmod liber est consetetur diam sadipscing takimata ut eros. Invidunt sed magna ut. Stet tempor facilisis dolor sed autem elitr ipsum sea possim ea justo dolores sed at rebum eirmod labore. Eu dolor consetetur sed et lorem nulla dolores accusam diam dolor voluptua sadipscing amet gubergren luptatum elitr. Vero aliquam sed sit blandit dolor est voluptua vero suscipit sanctus ut.
Diam facilisis et et dolor gubergren sea et amet zzril tempor sit sanctus ad et vero. Facilisis duo sea erat zzril hendrerit dolor duo dolor eos diam vero sanctus consetetur et. Velit dolore rebum kasd nonumy nulla et. Sanctus vero stet in duo takimata gubergren est erat invidunt sit sit in dolor clita et dolore. Lorem tempor tempor dolor diam est sit stet. Kasd takimata aliquyam labore ea dolor rebum diam euismod euismod. Et in sit invidunt est sit ipsum justo aliquyam dolor invidunt elitr erat esse at aliquyam takimata. Duo eros voluptua eirmod velit amet dolor aliquyam dolor dolore enim elitr eum liber clita eirmod ullamcorper.
Sample Output H3
Dolor elitr ipsum. Dolore wisi autem sit ea sit enim sed eos takimata dolore facilisi. Sit clita invidunt dolor nonumy vel et velit et stet sed option autem sed erat iriure nonumy sanctus. Sit et amet qui sanctus ipsum magna est qui diam iriure ut zzril ipsum gubergren eirmod feugait sed. Clita at dolores et clita magna hendrerit delenit invidunt kasd dolor stet dolores sit ea sanctus. In sadipscing no ipsum. Illum amet dolor accumsan dolore id. Labore dolor lorem praesent dolores at ullamcorper duo labore kasd. Dolore dolor erat amet aliquyam voluptua sadipscing labore duis elitr eu zzril consequat autem. Eirmod consetetur amet vero nonumy sit lorem rebum stet elitr duo amet sit.
Est ad no dignissim dolore aliquam sed tempor justo et aliquyam sit consetetur accumsan sadipscing. Molestie ut ad diam minim ut gubergren consetetur sea amet aliquyam dolores invidunt illum dolore. Clita no invidunt stet diam amet praesent lorem te eros et lorem elitr nostrud lorem justo et ut. Kasd justo sit in accusam accusam. Feugiat magna magna kasd eleifend tation eirmod tempor nonumy tempor esse magna et facilisi duo dolore. Diam esse liber ut eu sit dolores sit sit. Accusam vero kasd zzril et dolor at velit ut. Rebum voluptua eos et lorem magna praesent dolor diam.
Sample Output H4
Elitr clita molestie tempor labore vel et amet ut ea rebum zzril takimata dolores stet erat est facilisi. Sed diam gubergren rebum lorem rebum ea lorem ea no. Ea takimata aliquyam nibh sed aliquam placerat amet et iusto at in lorem. Lorem amet ea ipsum placerat gubergren vero sed aliquip sed dolores dolor. Lorem placerat justo aliquyam aliquyam invidunt tation elit sea labore lorem magna at voluptua dolore at sit ipsum.
Feugait lorem amet lorem sanctus sea amet ut dolore vero dolor suscipit soluta. Ipsum iusto rebum in dolor odio kasd sanctus sed veniam. Sadipscing et iusto dolores dolore consequat zzril lorem sanctus. Lorem est justo at et tempor tempor clita ea dolore dolore et in. Vero kasd gubergren amet diam est ipsum sea at et feugiat. Autem ea sit accumsan tempor nonumy et lorem ipsum dolore. Commodo voluptua et et.
Sample Output H4
Facilisis no eirmod iusto et sadipscing kasd facer et voluptua sanctus eum sit veniam qui. Nonumy gubergren et clita sadipscing nibh clita magna hendrerit tempor vero. Facilisis et sadipscing amet sadipscing illum delenit vero vel lorem at. Nonumy duo eirmod rebum duo euismod ipsum. Voluptua diam nulla mazim lorem dolores ea amet suscipit accusam dolor sit lorem augue rebum no dolore sanctus. Stet amet no duo vero ut eu voluptua et takimata voluptua clita kasd ut labore accusam diam. Et sit at eirmod veniam ea lorem odio sed accusam.
Nulla consequat stet diam nonumy lorem amet et invidunt facilisi vero clita velit consetetur invidunt feugiat in et. Ut kasd consectetuer kasd no takimata feugait lorem ea rebum ipsum consetetur ut clita ut. Vulputate lorem dolor minim et consetetur magna lorem stet et delenit autem odio dolor te magna sea. Tempor tempor dolore dolor. Ipsum no blandit ea sed. Stet adipiscing et et ea eum diam nonumy assum dolore stet delenit. Lorem tempor id gubergren dolore dolor est iusto justo ipsum voluptua stet amet dolor sit. Et adipiscing erat. Et justo voluptua.