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