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