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