Paragraphs, Figures and Equations Archives - Stilo https://www.stilo.com/docs/%knowledge_base%/paragraphs-figures-and-equations/ experience XML in a whole new way | exceptional tools for structured content solutions Tue, 27 Apr 2021 19:37:08 +0000 en-US hourly 1 https://wordpress.org/?v=6.7.1 https://www.stilo.com/wp-content/uploads/2017/03/favicon-150x150.png Paragraphs, Figures and Equations Archives - Stilo https://www.stilo.com/docs/%knowledge_base%/paragraphs-figures-and-equations/ 32 32 equation https://www.stilo.com/docs/migrate/paragraphs-figures-and-equations/equation/ Mon, 15 Mar 2021 00:00:00 +0000 https://www.stilo.com/?post_type=docs&p=64166 Syntax equation(filename) filename the file name of the MathML file to embed Purpose The equation domain annotations are used to […]

The post equation appeared first on Stilo.

]]>
Syntax

equation(filename)

filename

the file name of the MathML file to embed

Purpose

The equation domain annotations are used to embed MathML from external files into the DITA output.

The post equation appeared first on Stilo.

]]>
p.figure https://www.stilo.com/docs/migrate/paragraphs-figures-and-equations/p-figure/ Mon, 15 Mar 2021 00:00:00 +0000 https://www.stilo.com/?post_type=docs&p=64168 Syntax p.figure p.figure.desc p.title.figure Purpose Figure annotations are used to mark up images and any information associated with them. The […]

The post p.figure appeared first on Stilo.

]]>
Syntax

p.figure

p.figure.desc

p.title.figure

Purpose

Figure annotations are used to mark up images and any information associated with them.

The annotation p.figure is usually applied to paragraphs that contain an image and no text.

The annotation p.figure.description is used to mark up information associated directly with an image that contains more detail than is usually included in a title.

The annotation p.title.figure is applied to short pieces of information associated directly with an image, shorter than a description.

Example: Creating a figure from an image

The following screenshot is an example of what an image may look like in your original document.

figure-from-image-original

The following image is an example of what your rule may look like to create a figure from an image.

figure-from-image-rule

You saw in the original document that there are several images together; if not told to close the figure tags, Migrate will keep them open until forced to close them. The outside annotation forces Migrate to close the figure tags after each image.

The following XML is an example of what the figure could look like in your output.

<p>These images are by themselves and do not have any other information associated with them.</p>
<fig>
  <image href="image1.jpg" width="3.493cm" height="4.234cm"/>
</fig>
<fig>
  <image href="image2.jpeg" width="5.027cm" height="7.602cm"/>
</fig>
<fig>
  <image href="image3.jpg" width="3.048cm" height="2.337cm"/>
</fig>

The following screenshot is a published view of this figure as the code above could look.

figure-from-image-dita-result

Example: Creating a figure description

The following image is an example of what a figure description may look like in your original document.

figure-description-original

The following image is an example of what your rule may look like to create a figure description.

figure-description-rule

The following XML is an example of what the figure description could look like in your output.

<p>The following images have descriptive information added to each one.</p>
<fig>
  <desc>
    This painting is called “Girl with a Pearl Earring”, and was painted 
    by the 17th century Dutch painter Johannes Vermeer. It depicts 
    a young woman wearing a dress and a turban with a headscarf that
    falls down the back of her head. She is wearing an earring, though 
    art experts sometimes argue about the material of which the
    earring is made.
  </desc>
  <image href="image1.jpg" width="3.493cm" height="4.234cm"/>
</fig>

The following image is an example of what the figure description could look like in your published output.

figure-description-dita-result

 

Example: Creating a figure title

The following screenshot is an example of what a figure title may look like in your original document.

figure-title-original

The following image is an example of what your rule may look like to create a figure title.

figure-title-rule

The text “Figure 3:” in this case was typed in manually, instead of being automatically generated as a listmarker. This means that a rule deleting listmarkers will not remove this text from the figure title. You can leave in the word Figure and the numbering if you prefer; in this example, the method for removing the text using a pattern is displayed.

The following XML is an example of what the figure title could look like in your output.

<fig>
  <title>Excerpt from The Birth of Venus, Sandro Botticelli</title>
  <image href="image3.jpg" width="3.048cm" height="2.337cm"/>
</fig>

The following image is a published view of what the figure title could look like, given the above code.

a published view of what the figure title could look like

The post p.figure appeared first on Stilo.

]]>
p.figure.desc https://www.stilo.com/docs/migrate/paragraphs-figures-and-equations/p-figure-desc/ Mon, 15 Mar 2021 00:00:00 +0000 https://www.stilo.com/?post_type=docs&p=64170 Syntax p.figure p.figure.desc p.title.figure Purpose Figure annotations are used to mark up images and any information associated with them. The […]

The post p.figure.desc appeared first on Stilo.

]]>
Syntax

p.figure

p.figure.desc

p.title.figure

Purpose

Figure annotations are used to mark up images and any information associated with them.

The annotation p.figure is usually applied to paragraphs that contain an image and no text.

The annotation p.figure.description is used to mark up information associated directly with an image that contains more detail than is usually included in a title.

The annotation p.title.figure is applied to short pieces of information associated directly with an image, shorter than a description.

Example: Creating a figure from an image

The following screenshot is an example of what an image may look like in your original document.

figure-from-image-original

The following image is an example of what your rule may look like to create a figure from an image.

figure-from-image-rule

You saw in the original document that there are several images together; if not told to close the figure tags, Migrate will keep them open until forced to close them. The outside annotation forces Migrate to close the figure tags after each image.

The following XML is an example of what the figure could look like in your output.

<p>These images are by themselves and do not have any other information associated with them.</p>
<fig>
  <image href="image1.jpg" width="3.493cm" height="4.234cm"/>
</fig>
<fig>
  <image href="image2.jpeg" width="5.027cm" height="7.602cm"/>
</fig>
<fig>
  <image href="image3.jpg" width="3.048cm" height="2.337cm"/>
</fig>

The following screenshot is a published view of this figure as the code above could look.

figure-from-image-dita-result

Example: Creating a figure description

The following image is an example of what a figure description may look like in your original document.

figure-description-original

The following image is an example of what your rule may look like to create a figure description.

figure-description-rule

The following XML is an example of what the figure description could look like in your output.

<p>The following images have descriptive information added to each one.</p>
<fig>
  <desc>
    This painting is called “Girl with a Pearl Earring”, and was painted 
    by the 17th century Dutch painter Johannes Vermeer. It depicts 
    a young woman wearing a dress and a turban with a headscarf that
    falls down the back of her head. She is wearing an earring, though 
    art experts sometimes argue about the material of which the
    earring is made.
  </desc>
  <image href="image1.jpg" width="3.493cm" height="4.234cm"/>
</fig>

The following image is an example of what the figure description could look like in your published output.

figure-description-dita-result

 

Example: Creating a figure title

The following screenshot is an example of what a figure title may look like in your original document.

figure-title-original

The following image is an example of what your rule may look like to create a figure title.

figure-title-rule

The text “Figure 3:” in this case was typed in manually, instead of being automatically generated as a listmarker. This means that a rule deleting listmarkers will not remove this text from the figure title. You can leave in the word Figure and the numbering if you prefer; in this example, the method for removing the text using a pattern is displayed.

The following XML is an example of what the figure title could look like in your output.

<fig>
  <title>Excerpt from The Birth of Venus, Sandro Botticelli</title>
  <image href="image3.jpg" width="3.048cm" height="2.337cm"/>
</fig>

The following image is a published view of what the figure title could look like, given the above code.

a published view of what the figure title could look like

The post p.figure.desc appeared first on Stilo.

]]>
p.title.figure https://www.stilo.com/docs/migrate/paragraphs-figures-and-equations/p-title-figure/ Mon, 15 Mar 2021 00:00:00 +0000 https://www.stilo.com/?post_type=docs&p=64172 Syntax p.figure p.figure.desc p.title.figure Purpose Figure annotations are used to mark up images and any information associated with them. The […]

The post p.title.figure appeared first on Stilo.

]]>
Syntax

p.figure

p.figure.desc

p.title.figure

Purpose

Figure annotations are used to mark up images and any information associated with them.

The annotation p.figure is usually applied to paragraphs that contain an image and no text.

The annotation p.figure.description is used to mark up information associated directly with an image that contains more detail than is usually included in a title.

The annotation p.title.figure is applied to short pieces of information associated directly with an image, shorter than a description.

Example: Creating a figure from an image

The following screenshot is an example of what an image may look like in your original document.

figure-from-image-original

The following image is an example of what your rule may look like to create a figure from an image.

figure-from-image-rule

You saw in the original document that there are several images together; if not told to close the figure tags, Migrate will keep them open until forced to close them. The outside annotation forces Migrate to close the figure tags after each image.

The following XML is an example of what the figure could look like in your output.

<p>These images are by themselves and do not have any other information associated with them.</p>
<fig>
  <image href="image1.jpg" width="3.493cm" height="4.234cm"/>
</fig>
<fig>
  <image href="image2.jpeg" width="5.027cm" height="7.602cm"/>
</fig>
<fig>
  <image href="image3.jpg" width="3.048cm" height="2.337cm"/>
</fig>

The following screenshot is a published view of this figure as the code above could look.

figure-from-image-dita-result

Example: Creating a figure description

The following image is an example of what a figure description may look like in your original document.

figure-description-original

The following image is an example of what your rule may look like to create a figure description.

figure-description-rule

The following XML is an example of what the figure description could look like in your output.

<p>The following images have descriptive information added to each one.</p>
<fig>
  <desc>
    This painting is called “Girl with a Pearl Earring”, and was painted 
    by the 17th century Dutch painter Johannes Vermeer. It depicts 
    a young woman wearing a dress and a turban with a headscarf that
    falls down the back of her head. She is wearing an earring, though 
    art experts sometimes argue about the material of which the
    earring is made.
  </desc>
  <image href="image1.jpg" width="3.493cm" height="4.234cm"/>
</fig>

The following image is an example of what the figure description could look like in your published output.

figure-description-dita-result

 

Example: Creating a figure title

The following screenshot is an example of what a figure title may look like in your original document.

figure-title-original

The following image is an example of what your rule may look like to create a figure title.

figure-title-rule

The text “Figure 3:” in this case was typed in manually, instead of being automatically generated as a listmarker. This means that a rule deleting listmarkers will not remove this text from the figure title. You can leave in the word Figure and the numbering if you prefer; in this example, the method for removing the text using a pattern is displayed.

The following XML is an example of what the figure title could look like in your output.

<fig>
  <title>Excerpt from The Birth of Venus, Sandro Botticelli</title>
  <image href="image3.jpg" width="3.048cm" height="2.337cm"/>
</fig>

The following image is a published view of what the figure title could look like, given the above code.

a published view of what the figure title could look like

The post p.title.figure appeared first on Stilo.

]]>
p.title.for-following-content https://www.stilo.com/docs/migrate/paragraphs-figures-and-equations/p-title-for-following-content-2/ Mon, 15 Mar 2021 00:00:00 +0000 https://www.stilo.com/?post_type=docs&p=64174 Syntax p.title.for-following-content p.title.for-preceding-content Purpose The annotations p.title.for-following-content and p.title.for-preceding-content apply to section and figure, as well as anything that extends […]

The post p.title.for-following-content appeared first on Stilo.

]]>
Syntax

p.title.for-following-content

p.title.for-preceding-content

Purpose

The annotations p.title.for-following-content and p.title.for-preceding-content apply to section and figure, as well as anything that extends them. For example, syntaxdiagram extends figure, so these annotations would apply to syntaxdiagram. The items that extend section are as follows:

  • example
  • lcAudience
  • lcChallenge
  • lcDuration
  • lcGapAnalysis
  • lcInstruction
  • lcInteraction
  • lcIntervention
  • lcIntro
  • lcNeedsAnalysis
  • lcNextSteps
  • lcObjectives
  • lcPrereqs
  • lcProject
  • lcResources
  • lcReview
  • lcSummary
  • lcTechnical

The items that extend figure are as follows:

  • lcSingleSelect
  • lcMatching
  • lcMultipleSelect
  • lcTrueFalse

The annotation p.title.for-following-content can also be applied to a table when the title precedes the table and is outside of the table itself.

The post p.title.for-following-content appeared first on Stilo.

]]>
p.title.for-preceding-content https://www.stilo.com/docs/migrate/paragraphs-figures-and-equations/p-title-for-preceding-content-2/ Mon, 15 Mar 2021 00:00:00 +0000 https://www.stilo.com/?post_type=docs&p=64176 Syntax p.title.for-following-content p.title.for-preceding-content Purpose The annotations p.title.for-following-content and p.title.for-preceding-content apply to section and figure, as well as anything that extends […]

The post p.title.for-preceding-content appeared first on Stilo.

]]>
Syntax

p.title.for-following-content

p.title.for-preceding-content

Purpose

The annotations p.title.for-following-content and p.title.for-preceding-content apply to section and figure, as well as anything that extends them. For example, syntaxdiagram extends figure, so these annotations would apply to syntaxdiagram. The items that extend section are as follows:

  • example
  • lcAudience
  • lcChallenge
  • lcDuration
  • lcGapAnalysis
  • lcInstruction
  • lcInteraction
  • lcIntervention
  • lcIntro
  • lcNeedsAnalysis
  • lcNextSteps
  • lcObjectives
  • lcPrereqs
  • lcProject
  • lcResources
  • lcReview
  • lcSummary
  • lcTechnical

The items that extend figure are as follows:

  • lcSingleSelect
  • lcMatching
  • lcMultipleSelect
  • lcTrueFalse

The annotation p.title.for-following-content can also be applied to a table when the title precedes the table and is outside of the table itself.

The post p.title.for-preceding-content appeared first on Stilo.

]]>