Step 4: Editing the Files That Compose the Site Topic

Although you have prepared most of the content for the topic in the Presence Builder editor in Step 1, you might also need to do the following:

• Optional steps:
  • Correct typos in text or make other minor changes, if required.
  • Translate the text in the site topic into another language, if required.
• Required steps:
  • Specify a title, a description, and keywords for the new topic.
  • Specify a title and a description for the new topic category, if you have decided to create a category.
  • Add an icon that should accompany the site topic on the topic selection screen in the Presence Builder editor.

To make changes to text contained in the website pages:

1. In the topic archive structure, open the following file for editing: /resources/locale/en_US/site_templates/<topic_code>/content.lng.

   Note: On the file system, the directory name corresponding to your topic will look like the topic code you specified, but with an appended unique combination of symbols.

2. Make the required changes to the text and save the file.

   Note: If you want to correct the site slogan shown in the header area, or a site description added to the <META> tags of HTML pages of the site, edit the file /resources/locale/en_US/site_templates/<topic_code>/site.lng.

To specify a title, a description, and keywords for the topic:

1. In the topic archive structure, open the following file for editing: /resources/locale/en_US/site_templates/<topic_code>/info.lng.
2. Type the title and description in quotation marks.
3. Specify keywords. These keywords are used for the following purposes:
   • Binding of images to website topics. When a new site is created based on a website topic, the editor searches for banner images that may be relevant to the topic, and adds one of them to the generated website. It also uses the relevant banners in generated design templates, which users can preview and select in the editor > Design tab > Templates. The relevance is determined by matching keywords in the website topic's meta data and in the banner descriptions. The instructions on how to add banner images for topics are provided in the section Adding Custom Banner Images.
   • Enabling users to find topics by keywords on the topic selection screen.
   • Improving of search efficiency by search engines. These keywords are also added to the <META> tags of HTML pages of the site.

   You can use several keywords separated with commas. White spaces can be used only if they are part of a descriptive phrase or a combination of words. For example:

   keywords = "team,sports team,league,roster"

4. Save the file.

To specify a title and a description for the new topic category:

1. In the topic archive structure, open the following file for editing:

   /resources/locale/en_US/CustomSiteTemplates.lng.

2. Type the title and description in quotation marks.
3. Save the file.

To add an icon for the topic:

1. Prepare an image with the dimensions of 67 x 134 pixels, and save it to the PNG format, under the file name <topic_code>.png.

   The PNG file must contain a composite image created by combining two icons with the dimensions of 67 x 67, aligned vertically: The upper half of the image must contain a grey icon, and the lower half of the image, a full-colored icon. The grey icon is shown on the topic selection screen when the mouse pointer is not hovered over the topic, and the lower half of the image, the full-colored icon, is shown when the topic is selected. The following is an example of the composite image that you need to create.

   

2. In the topic archive structure, upload the file to /htdocs/images/site_templates/.
3. When prompted, confirm you want to overwrite the existing file.

When you have finished editing the files, pack them into a ZIP archive and register with your Presence Builder installation, as described in the following section.