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