Prepare a file - Fluid Topics - 4.2

Fluid Topics Configuration and Administration Guide

Reference Guides

The characteristics of the file to be uploaded in the Vocabularies administration interface depend on the type of vocabulary being added.

For this reason, the first step is to determine which of the following types of vocabularies is best adapted to the task at hand:

  • A list of synonyms.
    • This is the best choice when configuring a vocabulary where all terms are in the same language and on the same level (i.e., not hierarchized). For example, a list of synonyms can provide the long forms of all abbreviations and acronyms that exist in a corpus. As a result, any user who searches for the long form of a term (e.g., "search engine optimization") will find all documentation containing the shorter one (e.g., "SEO").
    • The topic Prepare a file to add synonyms provides details and an example.
  • A taxonomy.
    • This is the best choice when separating terms into hierarchized categories. The use cases below provide instructions on how to configure both synonyms and taxonomies.
    • The topic Prepare a file to add a taxonomy provides details and examples.

Supported file formats

Administrators can upload both CSV and SKOS files in the Vocabularies administration interface.

The following considerations may help when wondering which format is best for a specific context:

  • The SKOS standard is specifically designed for structuring vocabularies. However, a specific toolset is required to create and maintain SKOS files.
  • The CSV format is not specifically designed for structuring vocabularies. However, it is possible to create and maintain CSV files with a widely available editor such as Microsoft Excel, Numbers (macOS), LibreOffice Calc, or OpenOffice Calc.

Vocabulary files must be encoded in UTF-8 to avoid issues with special characters.