added note about excluding files from PDF but keeping themm on the web

This commit is contained in:
Tom Johnson
2015-08-20 12:43:59 -07:00
parent ad97a8b377
commit f64e803fc5
2 changed files with 9 additions and 0 deletions

View File

@ -362,6 +362,7 @@ entries:
platform: all
version: all
product: all
print: false
thirdlevelitems:
- title: Getting started pages
url: /doc_tag-getting-started.html
@ -369,6 +370,7 @@ entries:
platform: all
version: all
product: all
print: false
- title: Formatting pages
url: /doc_tag-formatting.html
@ -376,6 +378,7 @@ entries:
platform: all
version: all
product: all
print: false
- title: Navigation pages
url: /doc_tag-navigation.html
@ -383,6 +386,7 @@ entries:
platform: all
version: all
product: all
print: false
- title: Content types pages
url: /doc_tag-content-types.html
@ -390,6 +394,7 @@ entries:
platform: all
version: all
product: all
print: false
- title: Publishing pages
url: /doc_tag-publishing.html
@ -397,6 +402,7 @@ entries:
platform: all
version: all
product: all
print: false
- title: Special layout pages
url: /doc_tag-special-layouts.html
@ -404,3 +410,4 @@ entries:
platform: all
version: all
product: all
print: false

View File

@ -110,6 +110,8 @@ The code in the tocpage.html is nearly identical to that of the sidebar.html pag
There's another file (in the root directory of the theme) that is critical to the PDF generation process: prince-file-list.txt. This file simply iterates through the items in your sidebar and creates a list of links. Prince will consume the list of links from prince-file-list.txt and create a running PDF that contains all of the pages listed, with appropriate cross references and styling for them all.
{{note}} If you have any files that you do not want to appear in the PDF, add <code>print: false</code> in the list of attributes in your sidebar. The prince-file-list.txt file that loops through the sidebar_doc.yml file to grab the URLs of each page that should appear in the PDF will skip over any items that have <code>print: false</code> in the item attributes. For example, you might not want your tag archives to appear in the PDF, but you probably will want to list them in the online help navigation. {{end}}
## 4. Customize your headers and footers
Open up the css/printstyles.css file and customize what you want for the headers and footers. At the very least, customize the email address that appears in the bottom left.