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