Glossary
"
- "Finished" status of a derived item
- Finished derivation
Refers to an item in a derived workspace whose derivation is completed, validated (icons in green color).
Tagging as "finished" the derivation of an item (overloaded or not) allows the user to be visually warned when modifications (in the derived workspace or in the reference workspace) affects this item. Basically, the green icon turns brick red to invite the writer to check the item before tagging the derivation as "finished" once again.
- "Non-overloaded" status of a derived item
- Non-overloaded item
Refers to an item in a derived workspace whose content has not been modified (compared to the source item in the reference workspace).
The modifications made in the reference workspace are imported automatically for the items non-overloaded so that they stay identical to their source (until they get overloaded).
- "Overloaded" status of a derived item
- Overloaded item
Refers to an item in a derived workspace whose content has been modified (compared to the original item in the reference workspace).
- "To review" status of a derived item
- Derivation to check, Out of phase
Refers to an item in a workspace whose derivation, previously tagged as "finished", has been affected by modifications (in the derived workspace or in the reference workspace). Basically, the green icon became brick red to invite the writer to check the item before tagging the derivation as "finished" once again.
A-B
- Abbreviation
Enables to give the whole form of an initialism, an acronym,...
- Audio description
- (digital accessibility)
Allows to include an audio description file (descriptive comments inserted with the soundtrack).
- Bibliographic entry
The item
Bibliographic entryis a reference item that enables to create a bibliographic or webographic entry. In other words, it enables to specify the source of an information, a book title or a web site...The
Bibliographic entryitems held by a document automatically create the Bibliography / Webography, at the publication.- Bibliography
Enables to write a bibliographic or webographic reference.
Note: in publication, two distinct index are created depending on the
typegiven toBibliographyitems during their creation.- Bookmarks
The application's bookmark feature allows a user to create shortcuts to items in the explorer and to sort them in a personal way, in folders if need be.
C
- Chromium browser
- Client-server implementation
Using a publishing chain in client-server mode implies the storage of the content sources on a remote server, to allow several users to work in collaboration. In this case, the storage of sources and the publication of the various media is managed by the remote server.
- Code
The code is the name of an item (or a space) in the workspace explorer.
It is advised to choose short codes and to adopt the camelCase practice which consists in writing a set of words by capitalizing the first letters of the linked words.
For example, lawArticle12, myDocContent, ...
- Comment
- Annotation
A comment is a block of text inserted in the editor but which isn't publish in the document outputs (except in previews).
Comments allow you to create a discussion thread:
- Write down a remark on a precise tag of an item, for yourself or for another user.
- Discuss between authors on specific tags of the items.
- Complete description
- (digital accessibility)
Allows to describe the content and the meaning of a complex resource for users unable to see the pictures.
D
- Definition
The
Definitionitem is a reference item that enables to explain a term or a notion.The
Definitionitems held by a document automatically create the Glossary, at the publication.- Depot / resource server
It is a resource distribution server which allows:
the creation of a file tree within a management interface and the uploading of documents in the various folders of this tree;
an online access to the documents from a web browser, through a URL.
- Derived layer workspace
A derived workspace is a workspace whose content is based on another workspace, called a reference workspace.
Workspace derivation is useful especially for localizing contents, in other words adapting contents to a different context.
- Digital accessibility
The digital accessibility means that disabled people (visual, hearing, physical, speaking, cognitive and neurological handicaps) can use the computing tool. More precisely, they can perceive, understand, browse and interact with those tools, and they can contribute to it.
Source: CAPA project (fr)
- Document
- Document medium
A document, in SCENARI, refers to the result of a generation made through a publishing item.
The term document medium refers to the material form of a document (which determines its mode of consultation and conservation); it is the element that holds the information of the document (examples: print, PDF, website, slideshow,...).
- Document model
A document model defines the structure of the contents and the available publications.
Installing a document model is a prerequisite for the creation of a workspace since a workspace is necessarily associated to a document model.
E
- Editing area
The editing area corresponds to the predefined form, made of tags, which is displayed when an item is opened. Using the various tags (authorized and/or mandatory) that an item type offers, the authors can create the content and define the document scenario.
- Explorer
The explorer refers to the interface element within a workspace where the contents are visible and accessible: the items created to form documents and spaces in which they are stored and sorted.
By default, the items and spaces in the explorer are organized in alphanumeric order.
- Explorer mode
The most complete editing interface allowing access to the explorer where all the items are stored. It allows access to all the functions, including those for management and advanced reuse of content, so it requires a greater knowledge of the application.
- External item
- Externalized content
The term External item emphasizes the fact that a content is a full-fledged item in the explorer. This notion is in opposition with "internalized content" (edited in the structure of its parent item); an external item is autonomous and reusable.
Externalized content makes easier the access to sources, allows the same content to be reused without duplicating or rewriting and simplifies updates.
An external item is linked in the editing area of its parent item thanks to a link on a linking icon
.
F-H
- Foreign item
The term
foreign itemrefers to an item from a public workspace linked in a workspace that authorizes this kind of links (= direct inter-workspace links).- Functional management
Functional management covers the administration tasks of the work environment, especially the management of the workspaces and users and their roles / rights.
- Generator
A generator transforms the content created in the application into a document with the format, ergonomics and the style guide defined by this generator (web, pdf, slideshow, etc).
- Glossary
Enables to write the definition of a glossary term.
- Home banner
The home banner displays menus giving access to all the functions, services and options of the environment which you are logged in to. It takes the form of a ribbon across the top of the window.
I
- Image type
- (digital accessibility)
InformativeorDecorative: gives an essential information since only an informative picture conveys an additional information relative to the surrounding content; a decorative picture is interesting only if she is seen visually (in this case, don't fill in an alternative). - Inline tags
An inline tag is an element inserted inside the editorial content of an item. It can be a link to an item (definition, internal reference, link to a file) or a semantic enrichment (with an associated formatting).
- Internalized content
The term Internalized content refers to a content edited in the structure of its parent item (ascending) when it could be an autonomous item. This notion is in opposition with "externalized content" (autonomous item of the explorer); an internalized content is neither autonomous, nor reusable.
To maximize document management and simplify updates, we encourage content fragmentation and the reuse of external items.
An internalized content, since it is a potential item within another item, it can be transformed into an external item (via the
Replace... / Externalize this contentoption).- Item
Items are chunks of content materialized in a workspace explorer; technically, they are XML files.
Depending on their type, the items are made of:
content internalized tags (text blocks, metadata, date fields,...);
and/or
links to other items:
to content items, to develop the outline of a document or add a content fragment,
to reference items (glossary, for instance) or resource items (multimedia or office files) to enrich the content.
The available types of items depend on the document model of the publishing chain.
- Item network
- Links Tree
Items are linked to form one or several documents. These links form a network that we call an item network.
Displaying the network of a particular item allows to visualize all the items linked to this item:
its parents, or
ascending items(= the items in whose content it is linked),its children, or
descendant items(= the items which are linked in its content).
- Item state
The state of an item in a workspace layer gives an indication compared to its version in the reference workspace (unchanged, modified, new, deleted). It is symbolized by an icon to the right of the item's code in the explorer.
J-L
- Language
- (digital accessibility)
Allows to specify the language code, especially for screen readers.
Use the standardized languages codes, such as: fr or fr-FR (language code-country code) ; a list of suggestions is displayed when you start typing.
- Language - Type
- (digital accessibility)
Allows to specify the name of the subtitle language or the deaf and hard of hearing subtitling type.
- LaTeX
LaTeX is a writing language, derived from TeX, commonly used for the publication of scientific documents in particular for that it facilitates the writing and the formatting of mathematical formulas.
- Localization
Localization refers to the adaptation of a document to the specific needs of target users in a particular context.
The adaptation to specific audiences can take many forms and consider different point of views such as linguistic, geographic, cultural, ergonomic or religious.
M-O
- Main menu
The main menu allows one to navigate between the different applications of the work environment (workspaces, SCENARI depot, tasks...), to access the management features (document models, users...) and the options (theme, font size, language,...).
- Medium
- Output Documentary medium
The term documentary medium refers to the material form of a document (which determines its mode of consultation and conservation); it is the element which supports the information of the document.
Examples: print, PDF, website, CD-Rom,...
- Nomenclature
Nomenclatureitems feed an index of physical quantities.The reference can be an equation. In addition, the item allows you to enter the
Nameof the quantity, itsDefinition, itsUnitand the associatedEquation.- Orphan item
An orphan item is an item of the explorer which is not linked to any other item. In other words, an orphan item doesn't have ascending items(parents).
The publication items are supposed, by nature, to have no ascending network since they are the top of the pyramid. On the contrary, if an image, for instance, is orphaned, that means that it will never be published in any document; you should choose to delete it or to link it to an item.
- Outline
The outline refers to the tree structure formed by the links between the items. The outline gives the table of contents or the navigation menu of a document in publishing. In the editor, displaying the outline of an item allows to see how its children items (or descendant items) are structured.
The outline of an item is interactive and allows one to navigate in the document.
P-Q
- Plan mode
Interface where the user works focused on a single document of the workspace switching between 3 aspects:
Content: editing content of the outline of the selected document (root item);Output: selection of a publication item and setting of the medium to publish;Publications: selection of a generator and medium publishing environment.
Plan mode can be useful for a novice user or an occasional contributor, for a proofreading task, for example. Plan mode allows one to overcome the complexity of documentary management of content fragments; indeed, it does not allow sharing and reusing chunks of content.
- Pseudo
Le
Pseudod'un utilisateur s'affiche dans l'éditeur en remplacement de sonComptepour toutes les informations fonctionnelles (propriétés des items, historique, tâches,...).- Public workspace
A public workspace is used to solve document management issues by allowing other workspaces to link the items it contains (=
unknown itemsreferencing).- Publication
The publication is the action that transforms the created content in the publishing chain into a documentary medium. So it is the step that takes place before the distribution of the document.
The resulting document (format, style, ergonomics...) is defined by the type of generator used for publication.
- Publication item
The term publication itemrefers to an item which can generate an output (medium) because it bears the
Publicationsfeatures. The types of outputs generated (web, pdf,...) depend on the type of the selected publication item.The
Editiontab of a publication item allows to:Build the scenario of the document to publish, either by linking a particular item that gives its outline to the document (an item called root content), or by creating the scenario directly in the editing area of the publication item (which, in this case, is also the root item).
Set up the publication by setting a number of options (include indexes, solutions, etc.) and/or by entering metadatas (date, author, version, illustration,...).
R
- Reference
Item deliberately neutral, enabling to create a job or personal reference document with an ID (tag
Reference) and textual explanations (tagDescription).- Reference item
A reference item allows to create content, rather short, meant to be reused in several places of the document (a definition or a bibliographic entry, for example).
When published, the reference items of a same type allow to automatically generate indexes (glossary, bibliography,...).
A reference item must be linked to a content item to be integrated into the scenario of a document and to be published.
- Reference workspace
The reference workspace refers to the workspace that is used as a source for a derived workspace and/or a work layer workspace.
In other words, the reference workspace is the one whose content is linked (and is the source) to another workspace content.
- Remote resources
Remote resourcesitems (Document,Picture,Video,...) allow to reference in your content multimedia files stored on a remote server.- Replacement text
- (digital accessibility)
Allows explaining the meaning of a resource for users in contexts where images are imperceptible.
- Resource item
A resource item is a container; it contains a multimedia file (image, video, web resource...) or an office resource (PDF document, OpenDocument...) as well as metadata (title, properties.,..)
S
- SCAR
- SCenari ARchive
Archive exported from a SCENARI publishing chain. It enables you to transfer, migrate or archive an item or an item network.
For a transfer or a migration, the target workspace must have a document model compatible with the one from the source workspace (from which the SCAR has been exported).
- SCORM
- Sharable Content Object Reference Model
SCORM is a standard for the exchange of training media between production and learning management systems (LMS). It specifies how the course should be structured, how the datas produced during the course should be exchanged and archived as well as how the files should be put together in a zip archive.
- SCWSP
- SCenari WorkSPace
Archive exported from a SCENARI publishing chain. It enables you to transfer, migrate or archive the content of a whole workspace.
For a transfer or a migration, the target workspace must have a document model compatible with the one from the source workspace (from which the SCWSP has been exported).
- Semantic markup
The semantic markup is the use of XML elements (semantic tags) that allow one to give meaning to the content.
In a WYSIWYM editor, the writer clarifies the structure of a document and the intention associated to each element of its content by choosing semantic tags that describe the content they hold.
The list of semantic tags, their arrangement and their look in publication depend on the publishing chain (its XML schema).
- Sending option
Options available after the publication of a document.
Example: send the document to a web server via FTP, FTPS,... or to a SCENARI depot using the CID protocol.
- Skin
The skin is the stylesheet used to publish a document; it defines the look of the published document.
- skinpack
Skinpack is the type of file for installing a skin (stylesheet) in a SCENARI application.
- Space
A space is a folder (or directory) from the explorer of a workspace where items (chunks of content) are stored and sorted. Spaces and their sub-spaces form trees.
- State of a derived item
The state of an item in a derived workspace refers to its state compared to its version in the reference workspace (overloaded, non-overloaded, finished, out of phase,...).
- Static alternative (or textual alternative)
Information used for non interactive publications (paper), that allows you to describe the resource and/or add a link to the resource online.
- Subtitling file / video
- (digital accessibility)
Allows you to link an independant subtitles file (.srt or .webvtt). Some document models authorize a video with insertion of subtitles.
T-V
- Text (rich)
The term
Rich textrefers to a type of tag in the editor which allows typing the writing content and whose distinctive feature is that it can be enriched with word highlighting, lists, tables, external links, links to references (glossary...), multimedia resources, etc. Basically, it is materialized by a multi-paragraph input field in the editor.The various enrichments available are accessible via the buttons displayed in the editing bar when you click in a text area.
We find the rich text mainly in the intention blocks (Information, Attention, Example...).
- Transcription
- (digital accessibility)
Allows typing the textual transcription of an audio/video resource OR to link the item of a file that contains the transcription.
- Variable
A variable injects a string of characters into a text at publishing time. Three types of variables exist:
Static variableitems which carry their value directly;Variableitems whose value can be modified at the time of publication. Before generating a document, the editor chooses to keep or customize the default value of each variable used in the document, via a configuration frame implemented on every publication items;Combinations of variablesitems that enable a string of characters to be constructed from other variables.
W-Z
- Web address
Web address is an item that enables to enter a web site address or a mail in order to reuse it in several places in the content.
The point of this item lies in the possibility to update this address in only one place, if it were to change, but that this action correct simultaneously all the address occurrences in the content.
- Weight
- (digital accessibility)
Allows typing the weight of the file (in Ko), important information for downloading.
- Work layer workspace
- Work / draft workspace
A work layer workspace is a "draft" in which the content is created and modified while the validated and published version of the content is in the reference workspace.
- Workspace
A workspace is a work environment containing fragments of contents (items) allowing one to create one or several documents depending on the links between the items (the scenario).
- wsppack
Wsppack is the type of file for installing a document model or an extension in a SCENARI application.