SALT Light Syntax

Defining claims

\claim { text }
Description:
This command creates a claim. Internally each claim will receive an unique identifier. Once the claim is published, this identifier will be transformed into a general and referenceable identifier.

NOTE: All annotated claims should be strictly regarded from the publication's point of view, i.e. what is that you as an author claim in your publication, and not what other authors claimed in different publications and you discuss. This discussion should be seen as a position to other people's claims.

Example:
\claim {The structure of a document has an important influence on its perception.}

Defining claims as arguments

\claim [ POS_ID ] { text }
Details:
  • POS_ID - the identifier of an arbitrary position.
Description:
This command is similar to the previous one. Both create a claim. The difference is given by the fact that this claim will be marked as being an argument for the given position. POS_ID identifies the position to be refered.

Example:
\claim [p1] {The structure of a document has an important influence on its perception.}

Defining positions

Positive
\sposition [ ID ] [ CLAIM ] { text }
Negative
\cposition [ ID ] [ CLAIM ] { text }
Neutral
\position [ ID ] [ CLAIM ] { text }
Details:
  • ID - the position's identifier. Can be used to refer to it by defining a claim as an argument to this position. (see example above)
  • CLAIM - a means of identification for the claim in regards to which this position is stated. CLAIM can be the URI of a claim, the claim bibitem key (providing that you attach a claim bibliography file to the sources) or the claim's text. (see below for examples)
Description:
Using this command you can state a position in regards to a particular claim. Practically, by doing this, you contribute to the argumentation discourse network spanned across multiple publications, part of the discussions between authors by means of their publications.

Example:
\position [p1] [http://salt.semanticauthoring.org/claim/34324973] {That is why a good structure will make a document easier to read and understand.}
\cposition [p1] [cbibgroza2007] {That is why a good structure will make a document easier to read and understand.}
\sposition [p1] [The structure of a document has an important influence on its perception.] {That is why a good structure will make a document easier to read and understand.}

Defining rhetorical blocks

\begin { RHETBLOCK_NAME }
...
\end { RHETBLOCK_NAME }
Details:
  • ENV_NAME - the name of the rhetorical block. This can be one of the following: background, motivation, scenario, contribution, evaluation, discussion and conclusion. See Terminology for details of each of them.
Description:
This command helps us create a particular rhetorical block. The definition of a rhetorical block can be used for several times. The final rhetorical block created will be the concatenation of all the definitions of that rhetorical block.

Example:
\begin {scenario}
...
\end {scenario}

Defining claim bibliography

\cbibliography { claim bibliography file }
Description:
Similar to the usual bibliography definition, this command defines a claim bibliography. A claim bibliography is a set of claims modeled as claim bibliography items. Due to the fact that the format is not stable, it will not be included here for now.

Example:
\cbibliography {myclaimbib.cbib}