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