Différences entre versions de « Help/Annotations along the text »

De Rich Annotator System
(Page créée avec « {{#fas:caret-left}} Back to contents Category:Help {{interlanguagelink:en|Help-Annotations-along-text}} »)
 
Ligne 1 : Ligne 1 :
 +
''Readings'' can have different forms from studies on a separate page linked to literary texts to annotations displaced along the text.
 +
 +
For annotations displayed along the text, in a separate box, instead of a separate page, the "half-right" <nowiki><div></nowiki> class can be used. This div class creates a floating box filling 40% of the screen width at the right side. The annotation text has to be between the opening <code></nowiki><div class="half-right"></nowiki></code> tag and the closing <code><nowiki></div></nowiki></code> tag.
 +
 +
The original text can be marked by different font color or background color:
 +
* For different font color, put the text between <code><nowiki><span style="color:#</nowiki>''hexadecimal color code''<nowiki>;"></nowiki></code> and <code><nowiki></span></nowiki></code> tags.
 +
* For different background color, put the text between <code><nowiki><span style="background-color:#</nowiki>''hexadecimal color code''<nowiki>;"></nowiki></code> and <code><nowiki></span></nowiki></code> tags.
 +
 +
It is recommended to create '''subpages''' for the annotated text. Slashes (/) within a page name break the page into parent and subpages, recursively, e.g.:
 +
* <code>Text with links</code> – the text page;
 +
* <code>Text with links/Annotation 1</code> – a subpage with annotation.
 +
You can link directly to any page’s subpage using the normal ''double square brackets'' notation, by providing the full name – including the slash(es) and the individual subpage name(s).
 +
 +
Hence annotation subpages contain the original text ''and'' the annotation displayed in a floating box.
 +
 +
To avoid copying the same text in each annotation subpage, use [[Help/Transclusion#Labeled_section_transclusion|labeled section transclusion]]: mark off sections in the text, and transclude all unchanged sections to the annotation subpage; only the annotated paragraph has to be copied. If you don't want to change anything in the original text, all sections can be transcluded, and only the <nowiki><div></nowiki> block with the annotation has to be inserted at the right place.
  
  

Version du 3 novembre 2020 à 22:06

Readings can have different forms from studies on a separate page linked to literary texts to annotations displaced along the text.

For annotations displayed along the text, in a separate box, instead of a separate page, the "half-right" <div> class can be used. This div class creates a floating box filling 40% of the screen width at the right side. The annotation text has to be between the opening </nowiki>

</nowiki> tag and the closing </div> tag.

The original text can be marked by different font color or background color:

  • For different font color, put the text between <span style="color:#hexadecimal color code;"> and </span> tags.
  • For different background color, put the text between <span style="background-color:#hexadecimal color code;"> and </span> tags.

It is recommended to create subpages for the annotated text. Slashes (/) within a page name break the page into parent and subpages, recursively, e.g.:

  • Text with links – the text page;
  • Text with links/Annotation 1 – a subpage with annotation.

You can link directly to any page’s subpage using the normal double square brackets notation, by providing the full name – including the slash(es) and the individual subpage name(s).

Hence annotation subpages contain the original text and the annotation displayed in a floating box.

To avoid copying the same text in each annotation subpage, use labeled section transclusion: mark off sections in the text, and transclude all unchanged sections to the annotation subpage; only the annotated paragraph has to be copied. If you don't want to change anything in the original text, all sections can be transcluded, and only the <div> block with the annotation has to be inserted at the right place.



Back to contents