Samples

Tag is a desktop program that is organized into apps. The Samples app is used to browse sample files that we have uploaded which can help you get started quickly. More information about this app is provided in the future apps page.

Most samples contain multiple files that work together (e.g., data setup files, template files, images, etc.). You can copy some or all files from each sample to a folder on your computer.

 

During the copy process, ownership of the copied files can be changed to the current user (see below). This means you can modify your copies in any way, and not worry about remaining in sync with any source files.

samples.png

Samples are selected using a hierarchical menu (under "Math quiz"). When a sample is selected all included files are listed on the right side.

When some or all of the files are selected, they can be copied to the local folder selected on the left side.

Changing ownership of data setup files

Data setup files are central and provide a structure for the other file types to use. Each data setup file has a public identity in the form of a URI (shown below). These URIs are called namespaces, and for samples look like this:

http://id.nsymbol.com/demo/sample1

 

Namespace URIs are not used to download anything. They are only used for identification and to declare ownership. You can use any URI that you, or your organization, have control over on the web.

All Tag users have a default personal namespace URI and have control over all URIs that start with it. For example:

http://id.nsymbol.com/myAccountName/

If you convert ownership when copying samples (recommended), all namespaces will be changed to use your personal URI.

Gym samples

There are some easy solutions to common setup issues that you can copy to save time. The gym samples are intended to be used this way. They have been kept as simple as possible while still doing useful work.

The Personal data sample is the simplest. It gathers seven data fields and generates a tiny *.docx file which contains a table.

The Member summary sample provides a more substantial demo. It is discussed in detail in this blog article.

  • Multiple data setup files

  • Predefined field that is reused in multiple places

  • Shared utility templates: He-She, he-she, his-her, Member, Member-s, Mr-Ms and more

  • Dynamic lists within text (e.g. member has A, B and C) and as bulleted/numbered lists

The Search engine optimization sample shows how to gather data to embed in your website, which can help search engines understand and promote your site better. This is discussed further in the next section and also in this blog post.

Search engine optimization

Search engine optimization (SEO) refers to the process of updating your website to increase its visibility for relevant searches. This can lead to improved business outcomes.

A key component of SEO is embedding microdata in your website to better inform search engines. The most common microdata is defined by schema.org which is discussed further below.

Tag makes it easy to identify useful microdata, create a form to gather it, and save it in a useful format.

schema.org samples

schema.org is an amazing resource. It has grown out of a collaboration on web search terms into something much more. It now represents a knowledge base about everyday objects that both humans and computers can use.

The knowledge is organized into a hierarchy of terms, or classes, that reference each other in meaningful ways. These terms are:

 

  • used by search engines to find products, services and other links for web searches

  • used by eCommerce providers to advertise and buy/sell on the web

  • well understood by major artificial intelligence (AI) systems like Google, Siri and Alexa (and also used by many smaller AI models)

The schema.org hierarchy is published as a knowledge graph. When the Tag Knowledge graph app is released, it will allow you to interact with schema.org as a graph.

In the meantime, it is possible to reuse these terms now within smart content. When creating data setup files, you need to provide names for all the fields you want to store. By using the same names as schema.org, your data immediately becomes more reusable. Any software or AI model that knows these terms will better understand your data, and possibly link it to opportunities and collaborators in new and interesting ways.

To make this easy to do, we have created sample data setup files for all 877 classes in the latest schema.org release. The file names match schema.org class names, and fields are created for all class properties. Some data types are detected (e.g., numbers, dates), but most fields are treated as simple text.

The Gym Search engine optimization sample demonstrates how this mechanism works for an exercise gym creating SEO microdata.

The samples are organized into groups matching the top level of the schema.org hierarchy. Each sample contains 1 data setup file for each class in that group.

 

The groups and class counts are: Action (112), CreativeWork (162), Event (34), Intangible (237), MedicalEntity (73), Organization (176), Person (2), Place (70) and Product (11). You can browse them all below.

After copying, these files should be using your personal namespace URI, which means you can modify them as needed. Delete the fields you don't want and add new ones freely.

samples-schemaOrg.png

For convenience, below is an embedded view of the schema.org hierarchy. Click the "Open hierarchy" link or a top-level group (super-type) to explore. You can also visit the schema.org website directly.