Creating Knowledge Hub pages

For each page displayed by Refined, there will be a page in the Cyber Essentials Knowledge Hub (CEKH) space and a page in the Cyber Essentials (CKHR) space. The CEKH page is created from a template and the content is provided by the CKHR page. The template provides a way of creating a standard page layout for each type of page. Templates are stored in the CEKH space and are prefixed with TMPL. They can be viewed and edited via Space settings>Look and feel>Templates.

Pages appear in the Refined site in the same order and with the same page structure as the CEKH space. All pages under the Home page of the space will appear in the Refined site. To prevent a page in the CEKH space from appearing in the Refined site, go to Space settings>Manage content>Reorder and drag the page above the Home page (shown in orange) in the list.

Step 1 - Create Master page in CKHR space

To create a page for the Refined site, first add a page in the CKHR space under Master Knowledge Hub Structure. Select the area you wish to add the page to and click on the + button (“Create a child page”) next to the area main page. The page name should be prefixed with M (indicating Master).

If you had an article already written entitled ‘Example Article’ that you wanted to place in the Refined site under the Tech and Cyber Basics area, start by creating a page in the CKHR Confluence space using either the Create button or the + button next to the page name in the navigation bar.

There is a template for content pages called TMPL_ContentPage which contains the basic elements of a content page: pageProperty control, ‘the below content will appear at’ line and excerpt box for the actual content and labels kh_cyberessentials and kh_content_page.

Type the page name at the top (in this case M_Example Article).

Add the document control PageProperties table with the ‘hidden’ attribute set to True (this can be copied from another page and the details changed). The Distribution will be ‘Refined Knowledge Hub’.

Add a text line in red that states The below will appear on the Refined page at

Type “/excerpt”. Click on the box and select Edit (the pencil icon). Name the excerpt - typically this would be M_TCB_ExampleArticle. Paste the article text into the box.

Click Publish/ Update to add the page to the space.

Add the relevant labels to the page (kh_cyberessentials, kh_content_page, and the area such as kh_techcyberbasics or kh_five_controls.

Step 2 - Create target page in CEKH

Navigate to the CEKH space and create a new page in the location you wish it to appear in Refined. Refined will show the pages in the same order and with the same structure as they appear in the Confluence space.

Add title

Type in the page title, e.g. Example Article.

Create page from template

The page will be created using a template, go to the bar at the right, type TMPL, and the available templates will appear under the search bar.

In this example an article is being created, so choose TMPL_ContentPage.

Update PageProperty

Add the details to the PageProperty control of the article.

Add graphic

There is a default graphic for the page, this can be changed by hovering over the image, clicking on the grey portion of the box and clicking the Edit (pencil) icon. This will enable you to select the image you need, the default location for images is the CKHR page CKHR:KH_DefaultImages and the available images are shown in the dropdown. Any other page could also be used as the image source, you must use the space code followed by a colon followed by the name of the page where the image is stored. Once the image is selected, check Remove border panel and click Save.

Link to master text

Next, click the /insert excerpt control and set the source as CKHR : M_Example Article and the excerpt as M_TCB_ExampleArticle (or whatever your source is). The excerpt from the CKHR page will appear inside the /insert excerpt.

Create and add PDF

As this is a content page, there should be a downloadable PDF of the page. The PDF is generated from the Confluence page using the built-in PDF creator.

At the right side of the Layout control is a piece of text ‘Downloadable PDF’. Click on the left/right arrow to expand the width of the Layout so that you can edit the text. Replace this with the author’s name, publishing date, etc. The text will appear correctly in the Refined page, but you may have to play with the placement of the text to get the right result in the PDF as the image can obscure it.

Click Publish and you will see the new page listed in the folder structure at the left.

To create the PDF, go to the 3 dots at the top right and click on Export>Export to PDF. Once it has been created, click Download PDF. On a Mac you will immediately see the file appear in the download alert at the top of the browser. Navigate to the file location (usually the Download folder) and change the file name to the article name (just remove the extraneous text from the file name).

Once the PDF file is created, go back into the page and add ‘Download PDF’ under the article info. Drag the PDF file from the file location to just under the text and a link will appear. In Change View select Display Thumbnail. Close up the Layout using the expand control. Publish the page.

You can check the appearance of the page in Refined by clicking on the Refined button at the top of the page to make sure the layout etc is working correctly.

Step 3 - Update Master page

Click on the Example Article in the navigation bar and click the three dots. Select Copy Link.

Navigate to the CKHR M_Example Article page and paste the link into the PageProperties Distribution field and next to ‘The below will appear…’

Step 4 - Document Control

Documents must be approved by Neil Furminger, Joe Checketts or Jane Waterfall.

There are two categories of review period for the Knowledge Hub articles. These are annual (for most documents) and bi-weekly (for the OS support pages, which require frequent updates to remain accurate). Specify the approval dates etc in the PageProperties control and add either the Annual or Bi-weekly period in the Review and Consultation field. These will be added to a review list for the quarterly audits and reviewed by Neil, Joe or Jane.

Operating System Support pages

Purpose is to show the end of life information to a non-technical user in a quick and easy to read manner.

Listed OS : Windows 10, Windows 11, macOS, iOS, Android, ChromeOS, Windows Server

Pages are created using the template TMPL_DeviceSupportPage.

PageProperties ID : pp_PageManagement

Layout containing default graphic via /insert excerpt ( 800x500_Placeholder from CKHR : KH_Images)

/insert excerpt control to display DeviceSupportDisclaimer

/insert excerpt control to display Master document text for specific OS

Labels: kh_device_support, kh_content_page

Create pages:

>Create page

>Create from template TMPL_DeviceSupportPage :

>Type TMPL to get template list (Cyber Essentials Knowledge Hub space)

>Select TMPL_DeviceSupportPage

>Set Page Title to Operating System name

>Select /insert excerpt image 

>Click Edit (pencil logo)

>Source page is CKHR : KH_OSImages, excerpts are named by OS

>Select excerpt name in dropdown and tick Remove border panel, Save

>Select /insert excerpt text

>Click Edit (pencil logo)

>Source page is CKHR : Master (currently in Refined OS Support pages )

>Select excerpt name in dropdown and tick Remove border panel, Save

>Select page in Confluence navigation bar, click … and select Copy Link

>Go to Device Support navigation page

>Click edit and click relevant image, Edit link, and paste link 

All pages created from TMPL_DeviceSupportPage are given the labels kh_device_support and kh_content_page.

They have PageProperty macros containing Subject (DeviceSupport) and Type (Operating System name).