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