.Modelica.UsersGuide.Conventions.Documentation.Format

Information

In this section the format UsersGuide of the HTML documentation are specified. The structure of the documentation is specified separately.

Paragraphs

  1. In each section the paragraphs should start with <p> and terminate with </p>.
  2. Do not write plain text without putting it in a paragraph.
  3. No artificial line breaks <br> should be added within text paragraphs if possible. Use separate paragraphs instead.
  4. After a colon (:) continue with capital letter if new sentence starts; for text fragments continue with lower case letter

Emphasis

  1. For setting text in strong font (normally interpreted as boldface) the tags <strong> and </strong> have to be used.
  2. For emphasizing text fragments <em> and </em> has to be used.
  3. Modelica terms such as expandable bus, array, etc. should not be emphasized anyhow.

Capitalization of Text

  1. Table headers and entries should start with capital letters
  2. Table entries should start with lower case letter if only text fragments are used.
  3. Table and figure captions start with a capital letter

Contents

NameDescription
 CasesCases
 CodeCode
 EquationsEquations
 FiguresFigures
 HyperlinksHyperlinks
 ListsLists
 ReferencesReferences
 TablesTables

Generated at 2024-11-04T19:25:26Z by OpenModelicaOpenModelica 1.24.0 using GenerateDoc.mos