Create a Document Highlights (static) page
This page contains information on how to create a static page that includes Document Highlights. Sample Page Component Info
-
Create a Headline and Introduction for the Page
The first thing to build for a Document Highlights page is a General Content component with the headline and introductory text, highlighted in red below. Below are the steps for creating this component:
- In the 020 section, navigate to the folder where you want the components for the Document Highlights page to reside.
- Create a new component and complete the following fields:
- Name: enter a name for the component here
- Schema: select General Content
- Title: enter the headline for your Document Highlights page here.
- Content: enter the introductory text that will go at the top of your page. This is a rich-text field, so you can add other elements like images, links, etc.
Create Document components
In the folder that you used in step 1, now you will create Document components to populate your Document Highlights page. Create one or more Document components using the following instructions:
-
Name: enter a name for your component. You may wish to establish a naming convention for your document components, so that it is easier to organize and find individual documents.
- Schema: select Document
- Title: enter the title of your document here.
- Link to Document: choose from one of the two options:
- Internal link to components (has priority over external links): use this if you are going to link to document within your website. You can select files such as PDFs, Word docs, Excel docs, PowerPoints, images, etc. or you can select a component included in a published page. Click on the Browse Folder icon
, located at the end of the field. In the pop-up that appears, navigate to the document you wish to link to and double-click it. This will insert a link to the document.
- External link to a web page or file: use this if you are going to link to a document or page on another website. Enter the full URL for the document, such as https://www.google.com
- Internal link to components (has priority over external links): use this if you are going to link to document within your website. You can select files such as PDFs, Word docs, Excel docs, PowerPoints, images, etc. or you can select a component included in a published page. Click on the Browse Folder icon
- Short Description: enter a short 2 - 3 sentence summary of the document.
- Thumbnail image: this field is optional. To display a thumbnail image for your document, click on the Browse Folder icon
located at the end of the field. In the pop-up that appears, navigate to the thumbnail you wish to use and double-click it.
- Date: this field is optional. Enter a date by clicking the little calendar icon
to the right of the field. A pop-up will appear, which allows you to navigate through a calendar and select a date. The Time field is in 24 hour time, so to enter a time like 2:00 pm, you will need to enter 14:00:00. The date you select for this field does not affect when the document is published.
- File size in KB: this field is optional. Enter the document's file size in KB, such as 1024
- Author: this field is optional. From the drop-down, select an author for your document. If you need to add the author, click the green plus sign
at the end of the row. In the new tab that opens, enter the author's name in the Value field and then Save and Close the tab. The author's name will now appear in the Author drop-down and you can select it.
- Type: this field is optional. The Type field is used to identify the document type, which can be a broader type such as fact sheets, guidebooks, brochures. Or it can be a narrower type such as PDF, Word docs, PowerPoints, etc. You can select, or create new, tags by clicking the browse folder icon
. You can assign more than one Type to a document by clicking the green plus icon
.
- Topic: this field is optional. The Topic field is used to categorize the content of the document, such as Arts, Education, Employment, Environment, Health, etc. You can create your own topic categories as needed. You can select, or create new, topics by clicking the browse folder icon
. You can assign more than one Topic to a document by clicking the green plus icon
.
For more information about how the fields in a document component render on Document List pages, please refer to the Document component information page.
Create the Document Highlights page
- In the 050 section, navigate to (or create) the structure group where the Document Highlights page will reside.
- Create a new page.
- Fill in the Name, File Name, Page Display Name, Dublin Core Title, and Dublin Core Description fields.
- For the Page Template field, uncheck "Inherit from Parent." Then, in the drop-down menu for the field, select Document Page.
- Click the Design tab.
- Click the Add button:
- Navigate to the General Content component you created in step 1, select it, apply the Page Introduction component template, and insert it into the page.
- Navigate to the Document component you created in step 2, select it, apply the Document component template, and insert it into the page.
- Repeat the previous step for any additional Documents you wish to add to the page.
- Close the Insert Component Presentation pop-up window.
- Save and Close your Document Highlights page.
Publish the Document Highlights Page
When you've completed all the steps above, then all you need to do next is publish your Document Highlights page.
Navigate to the Document Highlights page you built in step 3, right-click on it and select Publishing > Publish.
Select the site you wish to publish to and click Publish. This will send the Document Highlights page to the publishing queue.
We also recommend republishing the navigation at this point, so that it picks up the new page.
Tips for Maintaining this Page
If the document used on your Document Highlights page is unpublished at the component level, it will also unpublish your Document Highlights (static) page. This will create a 404 error for the page. Please use caution if you are sharing a document between Document Highlight (static) pages and Document List (dynamic) pages.
Technical Specifications
Below are the components and component templates accepted in a Document Page template.
Component Type Accepted Component Templates Min/Max General Content - Feature Jumbotron
- Internal Jumbotron
- Page Introduction
- Page Introduction - Jumbo Feature Image (black text bar)
- Page Introduction - Jumbo Feature Image (white text bar)
0-1 Document - Document
0-10000