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

De Rich Annotator System
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.  
 
''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.
+
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:
 
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 font color, put the text between <code><nowiki><span style="color:#</nowiki>''[https://en.wikipedia.org/wiki/Web_colors#Shorthand_hexadecimal_form hex 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.
+
* For different background color, put the text between <code><nowiki><span style="background-color:#</nowiki>''[https://en.wikipedia.org/wiki/Web_colors#Shorthand_hexadecimal_form hex 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.:
 
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.:
Ligne 14 : Ligne 14 :
 
Hence annotation subpages contain the original text ''and'' the annotation displayed in a floating box.
 
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.
+
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. You can therefore easily create as many subpages as annotations, and the labeled section transclusion makes simple to place the "half-right" class div at the right position.
 
 
 
 
  
  

Version du 3 novembre 2020 à 22:15

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 <div class="half-right"> 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:#hex color code;"> and </span> tags.
  • For different background color, put the text between <span style="background-color:#hex 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. You can therefore easily create as many subpages as annotations, and the labeled section transclusion makes simple to place the "half-right" class div at the right position.


Back to contents