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