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