Yseop template generator

This is the documentation for 1.5.0 version, which is not the latest version. Consider upgrading to 3.4.0.

Why

Yseop is a well-known NLG software vendor.

While RosaeNLG is a production grade NLG software, some users may prefer to switch to commercial software like Yseop for various reasons like:

  • Support

  • Consulting / Professionnal Services

  • Additionnal features

  • Friendly UI (called "Yseop Business Studio" at Yseop)

  • Additionnal languages (Spanish, Dutch, Japanese etc.)

RosaeNLG has the ability to generate Yseop templates. This feature should be used to migrate existing RosaeNLG templates to Yseop. This migration feature is aimed at users who started creating RosaeNLG templates and wish to switch their existing templates to Yseop.

Pug/RosaeNLG is based on Javascript while Yseop uses a proprietary language. The Javascript snippets in RosaeNLG will not be migrated automatically to Yseop YML language.

Usage

First add yseop:true as an option when using compileFile.

To first debug and test, use also string:true to generate a plain string containing all templates:

const rosaenlgPug = require('rosaenlg');

var yseopTemplates = rosaenlgPug.renderFile(`template.pug`, {yseop:true, string:true});
console.log(yseopTemplates);

To generate files (one per Yseop TextFunction), provide a path with the yseopPath option:

const rosaenlgPug = require('rosaenlg');
const fs = require('fs');

rosaenlgPug.renderFile(`template.pug`, {
    yseop:true,
    yseopPath:'./output'
  });

What is supported

Table 1. Basis
RosaeNLG Yseop

p html tag

\beginParagraph \endParagraph

other html tags

\beginStyle(→ XmlTree -→ elementName "…​" -→ xmlNamespace YSEOP_TEXT_NAMESPACE;) \endStyle

plain text (using `

`)

plain text

JavaScript inline code, single line or multi line (using -)

commented code to be migrated in YML

single line or multiple lines comments

Table 2. Structure
RosaeNLG Yseop

if else condition

\if \else \endIf condition

standard Pug case when

\switch \case \endSwitch

standard Pug each loop

\foreach \endForeach loop

eachz loop

\foreach with → assembly \endForeach

itemz item enumerations

\beginList with → assembly \nextItem \endList

synz syn synonyms

\beginSynonym \choice \endSynonym

mixin definition, with or without arguments

TextFunction definition

mixin call, with or without arguments

TextFunction call

direct inclusion of pug files include simple.pug (specific to Pug)

inline included code

Table 3. Tags
RosaeNLG Yseop

recordSaid hasSaid deleteSaid

\setKeyVal(…​) TEXT_CONTENT_EXECUTION_CONTEXT.getKeyVal(…​)

syn mixin

\synonym(…​)

agreeAdj mixin

adjective tag

thirdPossession mixin

\value with _OWNER property

value mixin

\value; please note that this is a very complete tag in Yseop, and that many parameters have to be migrated manually

verb mixin

\thirdAction

What is supported

choosebest is not supported and is ignored, as it does not exist in Yseop.

Test suite

An extensive test suite is provided in rosaenlg/test-yseop:

  • unit: unit tests

  • templates: larger template files with RosaeNLG/Yseop correspondence