SPFE Documentation | Collections > SPFE Development > Adding a new topic set

Adding a new topic set

 

Think

A topic set is a collection of related topics.

A content set must have at least one topic set.

 

Plan

 
Do I need more than one topic set?

You could have a single topic set that contains all your topics. This approach is consistent with the Every Page is Page One approach. However, you may want to divide your content set into multiple topic sets for two reasons:

  1. To provide top-down navigation for your readers. While the Every Page is Page One approach emphasizes a bottom-up approach to navigation, top down navigation still has significant value, particularly for smaller content sets where it can be used effectively. Dividing your content into topic sets provides a level of top-down structure to your content set that can be useful to your readers.

  2. To separate the processing of different types of content. In some cases, you will want to process different sets of topics in different ways. This is particularly true in cases where you are building topics from content extracted from external sources, especially when you are combining that material with authored content. Dividing your content into different topic sets allows you to define different processing for different sets of topics.

 
Can I include more than one topic type in a topic set?

Yes, you can include more than one topic type in a topic set. Each topic type configuration can define specific synthesis and presentation scripts for that topic type.

 

Do

To add a topic set to the build:

  1. Create a topic set configuration file that describes the topic set. The composition of the topic set is determined entirely by the topic set configuration. Individual topics don't know what topic set (or topic sets) they belong to.

  2. Add a new /content-set/topic-sets/topic-set to the appropriate content set configuration file. You can add a topic set to more than one content set.