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