Getting started?

If you want to know how tags fit into the big picture of a Silk site, read the Silk site section first

What is tagging

You can use tagging to specify the meaning of facts on a page. You can tag text, links and images. 

Tagging text

On the Barack Obama page the text 4 August 1961 can be tagged with Birth date. Silk then knows that the birth date of Barack Obama is 4 August 1961. 

Tagging links

The Michelle Obama page contains a link to the Barack Obama page. This link can be tagged with Husband. Silk then knows that the husband of Michelle Obama is Barack Obama. Silk also knows the birth date of the husband of Michelle Obama. It knows this because we tagged this information on the Barack Obama page. 

Tagging images

Besides text, you can tag images to describe what they mean. If an image simply shows the topic of the page, you might simply tag it as Picture. But for countries, you may also want to include and tag its flag for example. 

Why use tags

When you tag the contents of your page, you are creating a data model that can be understood by Silk and provides very powerful features for yourself and the viewers of your site. Tagged information can be retrieved in various places:

  • The search bar lets you quickly navigate a Silk site, based on its tags
  • Every viewer of a Silk site can use explore mode to generate specific overviews, such as tables, charts and maps
  • An editor of a Silk site can insert widgets into a page. These are tables, charts and maps that automatically update themselves, based on the tagged information in your site. 
  • Developers can access Silk site through the API to run queries and retrieve specific information. 

How to tag

Tagging your content is easy:

  1. Start editing a document
  2. Select the text, link or image you want to tag (click on an image to select it)
  3. Type the desired tag name in the input field in the top menu. If the tag doesn't exist yet, you can created it from this menu. 
  4. After you created some tags, you will notice that Silk suggests tags to you on the left side of the input field. Simply click them to use this tag. 
  5. Alternatively, you can use a keyboard shortcut to tag and link. It is Control+Shift+Space on Windows/Linux or Command+Shift+Space on Mac.
Tag a word by using the keyboard shortcut

How to choose a tag name

If you are editing a page about Japan, and you want to tag the text Tokyo, complete the following sentence to come up with the proper tag name:

Tokyo is the _____ of Japan

The answer to this is obviously capital, so tag Tokyo as Capital. Do not tag Tokyo as City, since Tokyo is not THE city of Japan. You can, however, create a page called Tokyo, and make City the page category.  

How to untag

To untag something you tagged, select your tag, and click the tag name that appears in bold in the top menu. More about untagging.  

Page categories

Page categories are somewhat similar to tags. They describe what kind of page something is. Barack Obama might have the page category President. Alternatively, it could also have the page category Person, and a tag Job with the value President. More about page categories

Read on

You may want to continue reading about the search bar, widgets and explore mode