Différences entre versions de « Help/Texts »

De Rich Annotator System
 
(22 versions intermédiaires par le même utilisateur non affichées)
Ligne 2 : Ligne 2 :
  
 
The data page contains:
 
The data page contains:
* an infobox with essential data;
+
# An [[#Infobox|infobox]] with essential data and a [[#Full text|link to the full text]] (if available);  
* a short description (optional);
+
# A [[#Short description|short description]] (''optional'');
* links to [[Help/Readings|readings]] refering to the text or [[Help/Image pages|images]], [[Help/Audio & video|audio and video]] linked to the text;
+
# [[#Links to readings, images, audio and video|Links]] to readings refering to the text, or to images, audio and video connected to the text;
* link to the full text (if available).
+
# The [[#Category tag|category tag]].
 +
 
 +
The data page layout is hence as follows:
 +
{| class="wikitable" style="text-align:left;"
 +
! !! Wiki markup or text in the page !! Description
 +
|-
 +
| 1. || <nowiki>{{</nowiki>Infobox-fr {{#info:<nowiki>{{</nowiki>Infobox-hu calls the infobox in Hungarian.}}<br><nowiki>|</nowiki> ''parameters''<br><nowiki>}}</nowiki> || The Infobox template creates a floating box, which can contain an image and basic data.
 +
|-
 +
| 2. || Free text (''optional'') || You can add a short text that describes the work. General [[Help/Formatting|formatting]] rules apply.
 +
|-
 +
| 3. || <nowiki>{{Référence}}</nowiki> {{#info:<nowiki>{{Referencia}}</nowiki> calls the references in Hungarian.}} || Automatic references, created with the help of correct [[Help/Categories|category]] and [[Help/Semantic links|semantic annotation]] use, are called with this tag.
 +
|-
 +
| 4. || <nowiki>[[Category:Textes]]</nowiki> {{#info:Use ''Olvasmányok'' instead of ''Textes'' for Hungarian texts.}} || Categorize the page as a text.
 +
|}
 +
 
  
 
===Infobox===
 
===Infobox===
Ligne 22 : Ligne 36 :
 
}}
 
}}
 
</pre>
 
</pre>
You should start the infobox with the <code><nowiki>{{Infobox-fr</nowiki></code> line if you want to have an infobox in '''French''', and with the <code><nowiki>{{Infobox-hu</nowiki></code> line if you want to have an infobox in '''Hungarian'''. After the first line, every line begins with a pipe (<code>|</code>) followed by a parameter name and the value of the parameter (<code>''parameter'' = ''value''</code>).
+
Which gives:
 +
{{Infobox-fr
 +
|class = infobox
 +
|title = Médua
 +
|image = Maurice_Careme_Medua.png
 +
|booktitle = Médua
 +
|author = [[Maurice Carême]]
 +
|genre = roman
 +
|country = Belgique
 +
|editor = [https://fr.wikipedia.org/wiki/La_Renaissance_du_livre La Renaissance du livre]
 +
|date = 1976
 +
}}
 +
You should start the infobox with the <code><nowiki>{{Infobox-fr</nowiki></code> line if you want to have an infobox in '''French''', and with the <code><nowiki>{{Infobox-hu</nowiki></code> line if you want to have an infobox in '''Hungarian'''. After the first line, every line begins with a pipe (<code>|</code>) followed by a parameter name and the value of the parameter (<code>|''parameter'' = ''value''</code>). After the parameters, don't forget to close the infobox with the <code><nowiki>}}</nowiki></code> tag.
  
 
Parameter names are always in '''English''', but parameter values can be added in any language. Actually, if you use the French Infobox (<code><nowiki>{{Infobox-fr</nowiki></code>), you will probably want values to be in French.
 
Parameter names are always in '''English''', but parameter values can be added in any language. Actually, if you use the French Infobox (<code><nowiki>{{Infobox-fr</nowiki></code>), you will probably want values to be in French.
  
 
====Parameters====
 
====Parameters====
The following parameters can be added to an infobox. All parameters are optional. You can use [[Help/Formatting|text formatting markup]] and [[Help/Links|links]].
+
The following parameters can be added to an infobox. '''All parameters are optional.''' You can use [[Help/Formatting|text formatting markup]] and [[Help/Links|links]]. The order of parameters does not have any effect on the infobox layout. If you need other parameters, please contact administators.
 
{| class="wikitable sortable" style="text-align:left;"
 
{| class="wikitable sortable" style="text-align:left;"
! Parameter name !! class="unsortable"|Rendered in French !! class="unsortable"|Rendered in Hungarian !! class="unsortable"|Notes
+
! Parameter name !! class="unsortable"|Parameter name rendered in French !! class="unsortable"|Parameter name rendered in Hungarian !! class="unsortable"|Notes
 
|-
 
|-
| title || || || If omitted, the page title is used. The title is in top middle of the infobox in bold characters.
+
| title || <small>''no rendered text''</small> || <small>''no rendered text''</small> || If omitted, the page title is used. The title is in top middle of the infobox in bold characters.
 
|-
 
|-
| image || <small>''no rendered text''</small> || <small>''no rendered text''</small> ||  
+
| image || <small>''no rendered text''</small> || <small>''no rendered text''</small> || The name of an [[Help/Images|image]] ''without'' the <code>File:</code> or <code>Fichier:</code> part.
 
|-
 
|-
| author || Auteur || Szerző ||
+
| author || Auteur || Szerző || You should use the "Work of" property in the link (as above), see [[Help/Semantic links|Semantic links]].
 
|-
 
|-
 
| author-fem || Auteure || <small>''not relevant''</small> ||
 
| author-fem || Auteure || <small>''not relevant''</small> ||
 
|-
 
|-
| authors || Auteurs || Szerzők ||
+
| authors || Auteurs || Szerzők ||  
 
|-
 
|-
 
| booktitle || Titre || Cím ||
 
| booktitle || Titre || Cím ||
 
|-
 
|-
| original_title || Titre original || Eredeti cím ||
+
| original_title || Titre original || Eredeti cím || Used if the original title is for example in another language.
 
|-
 
|-
 
| language || Langue || Nyelv ||
 
| language || Langue || Nyelv ||
Ligne 55 : Ligne 81 :
 
| date || Date de publication || Kiadás dátuma ||
 
| date || Date de publication || Kiadás dátuma ||
 
|-
 
|-
| translation || Traduction || Fordítás ||
+
| translation || Traduction || Fordítás || Used if the text is a translation.
 
|-
 
|-
 
| pages || Pages || Oldal ||
 
| pages || Pages || Oldal ||
Ligne 63 : Ligne 89 :
 
| oclc || OCLC || OCLC ||
 
| oclc || OCLC || OCLC ||
 
|-
 
|-
| fulltext || Texte intégral || Teljes szöveg ||
+
| volumes || Tomes || Kötetek || Used if the work is composed of several volumes.
 +
|-
 +
| fulltext || Texte intégral || Teljes szöveg || Link to the full text, see [[#Full text|below]].
 
|}
 
|}
  
  
 +
===Short description===
 +
After the infobox, you can add a short description of the text.
 +
 +
 +
===Links to readings, images, audio and video===
 +
Automatic reference lists are called with the help of <code><nowiki>{{Référence}}</nowiki></code> or <code><nowiki>{{Referencia}}</nowiki></code> tag. In the case of texts, you don't need to add any parameters.
 +
 +
If there are links with "Refers to" (or "Fait référence à") [[Help/Semantic_links#Properties_to_use_in_the_Rich_Annotator_System|property]] pointing to the page, they are automatically listed.
 +
* If you call the <code><nowiki>{{Référence}}</nowiki></code> tag, links are listed after this text: "Les lectures suivantes font référence à ce texte&nbsp;:".
 +
* If you call the <code><nowiki>{{Referencia}}</nowiki></code> tag, links are listed after this text: "Az alábbi olvasatok utalnak erre a szövegre:".
 +
 +
If there are links with "Linked to" (or "En lien avec") [[Help/Semantic_links#Properties_to_use_in_the_Rich_Annotator_System|property]] pointing to the page, they are automatically listed.
 +
* If you call the <code><nowiki>{{Référence}}</nowiki></code> tag, links are listed after this text: "Images, vidéos ou présentations en lien avec ce texte&nbsp;:".
 +
* If you call the <code><nowiki>{{Referencia}}</nowiki></code> tag, links are listed after this text: "A szöveg az alábbi képekhez, videókhoz, prezentációkhoz köthető:".
 +
 +
{{#far:bell}} You only have to use the ''reference'' tag '''once'''; the two types of links are called with the same tag.
 +
 +
 +
===Category tag===
 +
* <code><nowiki>[[Category:Textes]]</nowiki></code> for French texts.
 +
* <code><nowiki>[[Category:Olvasmányok]]</nowiki></code> for Hungarian texts.
 +
 +
 +
===Full text===
 +
Full texts should be uploaded to separate pages. Data pages should only contain link to the full text. The link is added in the infobox (see [[#Infobox|above]]).
 +
 +
{{#far:bell}} Do '''''not''''' categorize the full text page as a text page. If you categorize the full text page, the categorization will be doubled for the same text, and the system will recognize the text data page ''and'' the full text page as two different works.
 +
 +
====Creating a new page for full text====
 +
To upload the legally accessible full text of a work, [[Help/Starting a new page|create a new page]]. It is recommended to use a '''subpage''' of the text data page for the full text.
 +
 +
Slashes (/) within a page name break the page into parent and subpages, recursively, e.g.:
 +
* [[Madame Bovary]] – the text data page;
 +
* [[Madame Bovary/Texte intégral]] – the full text subpage.
 +
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).
 +
 +
It is recommended to start the full text page with a <code><nowiki><div></nowiki></code> element containing basic information about the text.
 +
 +
For example, [[Madame Bovary/Texte intégral]] begins with this <code><nowiki><div></nowiki></code> element:
 +
<pre>
 +
<div style="text-align: center; border: 1px solid #aaa;">
 +
'''[[Gustave Flaubert]]'''<br>
 +
'''Madame Bovary (1857)'''<br>
 +
<small>Louis Conard, 1910 (p. ix-481).</small>
 +
</div>
 +
</pre>
 +
Which gives:
 +
<div style="text-align: center; border: 1px solid #aaa;">
 +
'''[[Gustave Flaubert]]'''<br>
 +
'''Madame Bovary (1857)'''<br>
 +
<small>Louis Conard, 1910 (p. ix-481).</small>
 +
</div>
 +
{{#far:bell}} Note that you should '''''not''''' annotate the link which points to the author. Indeed, the "Work of" ("Oeuvre de") property is already added to the text data page, and if you add this property to the full text subpage, the semantic annotation will be doubled, and the system will recognize the text data page ''and'' the full text page as two different works of the given author.
 +
 +
====Full text divided into multiple parts====
 +
You may create '''multiple subpages''' for the full text, e.g. <code>Du côté de chez Swann/Partie 1</code>, <code>Du côté de chez Swann/Partie 2</code> and <code>Du côté de chez Swann/Partie 3</code>.
 +
 +
In this case, you can assemble these parts in a single full text page without having to copy the whole text, with the [[Help/Transclusion|transclusion]] function. For example, the page <code>Du côté de chez Swann/Texte intégral</code> assembles the three parts with the help of the transclusion markup. For more details, see [[Help/Transclusion#Partial transclusion|Partial transclusion]].
 +
 +
====Add links in the full text====
 +
You can add links that point to ''[[Help/Readings|readings]]'' refering to the text. Hence not only the ''reading'' can point to the text (data page) (with the "Refers to" property), but also the original (full) text can point to the ''reading'', with the "Cited by" ("Cité par") property.
 +
 +
For example, the ''reading'' [[Du vrai, du beau, des notes - à propos d'une note de Chateaubriand (Claude Pérez)]] cites [[François-René de Chateaubriand|Chateaubriand's]] ''[[Génie du christianisme]]''. The ''reading'' points not only to the text data page (with the "Refers to" property annotation), but also to the exact point of the quoted excerpt in the full text (''without'' the "Refers to" property annotation) with the help of [[Help/Links|anchors]] (see also [[Help/Readings|Readings]]). The given excerpt points in return from the full text to the ''reading'' with the "'''Cited by'''" property annotation:
 +
<pre>
 +
[[Cité par::Du vrai, du beau, des notes - à propos d'une note de Chateaubriand (Claude Pérez)|Saint-Denis est désert&#160;; l’oiseau l’a pris pour passage, l’herbe croît sur ses autels brisés&#160;: et au lieu du cantique de la mort, qui retentissait sous ses dômes, on n’entend plus que les gouttes de pluie qui tombent par son toit découvert, la chute de quelque pierre qui se détache de ses murs en ruine, ou le son de son horloge, qui va roulant dans les tombeaux vides et les souterrains dévastés]]
 +
</pre>
  
  

Version actuelle datée du 3 novembre 2020 à 13:18

Literary texts uploaded to the Rich Annotator System must have first of all a data page with relevant data and eventually a short description. The title of the data page is the title of the literary work itself.

The data page contains:

  1. An infobox with essential data and a link to the full text (if available);
  2. A short description (optional);
  3. Links to readings refering to the text, or to images, audio and video connected to the text;
  4. The category tag.

The data page layout is hence as follows:

Wiki markup or text in the page Description
1. {{Infobox-fr {{Infobox-hu calls the infobox in Hungarian.
| parameters
}}
The Infobox template creates a floating box, which can contain an image and basic data.
2. Free text (optional) You can add a short text that describes the work. General formatting rules apply.
3. {{Référence}} {{Referencia}} calls the references in Hungarian. Automatic references, created with the help of correct category and semantic annotation use, are called with this tag.
4. [[Category:Textes]] Use Olvasmányok instead of Textes for Hungarian texts. Categorize the page as a text.


Infobox

This is the first element of a text's data page. It is created with an infobox template.

For example, the first lines of the page named Médua are as follows:

{{Infobox-fr
|image = Maurice_Careme_Medua.png
|booktitle = Médua
|author = [[Oeuvre de::Maurice Carême]]
|genre = roman
|country = Belgique
|editor = [https://fr.wikipedia.org/wiki/La_Renaissance_du_livre La Renaissance du livre]
|date = 1976
}}

Which gives:

Médua
Maurice Careme Medua.png
Auteur Maurice Carême
Titre Médua
Éditeur La Renaissance du livre
Pays Belgique
Genre roman
Date de publication 1976

You should start the infobox with the {{Infobox-fr line if you want to have an infobox in French, and with the {{Infobox-hu line if you want to have an infobox in Hungarian. After the first line, every line begins with a pipe (|) followed by a parameter name and the value of the parameter (|parameter = value). After the parameters, don't forget to close the infobox with the }} tag.

Parameter names are always in English, but parameter values can be added in any language. Actually, if you use the French Infobox ({{Infobox-fr), you will probably want values to be in French.

Parameters

The following parameters can be added to an infobox. All parameters are optional. You can use text formatting markup and links. The order of parameters does not have any effect on the infobox layout. If you need other parameters, please contact administators.

Parameter name Parameter name rendered in French Parameter name rendered in Hungarian Notes
title no rendered text no rendered text If omitted, the page title is used. The title is in top middle of the infobox in bold characters.
image no rendered text no rendered text The name of an image without the File: or Fichier: part.
author Auteur Szerző You should use the "Work of" property in the link (as above), see Semantic links.
author-fem Auteure not relevant
authors Auteurs Szerzők
booktitle Titre Cím
original_title Titre original Eredeti cím Used if the original title is for example in another language.
language Langue Nyelv
editor Éditeur Kiadó
country Pays Ország
genre Genre Műfaj
date Date de publication Kiadás dátuma
translation Traduction Fordítás Used if the text is a translation.
pages Pages Oldal
isbn ISBN ISBN
oclc OCLC OCLC
volumes Tomes Kötetek Used if the work is composed of several volumes.
fulltext Texte intégral Teljes szöveg Link to the full text, see below.


Short description

After the infobox, you can add a short description of the text.


Links to readings, images, audio and video

Automatic reference lists are called with the help of {{Référence}} or {{Referencia}} tag. In the case of texts, you don't need to add any parameters.

If there are links with "Refers to" (or "Fait référence à") property pointing to the page, they are automatically listed.

  • If you call the {{Référence}} tag, links are listed after this text: "Les lectures suivantes font référence à ce texte :".
  • If you call the {{Referencia}} tag, links are listed after this text: "Az alábbi olvasatok utalnak erre a szövegre:".

If there are links with "Linked to" (or "En lien avec") property pointing to the page, they are automatically listed.

  • If you call the {{Référence}} tag, links are listed after this text: "Images, vidéos ou présentations en lien avec ce texte :".
  • If you call the {{Referencia}} tag, links are listed after this text: "A szöveg az alábbi képekhez, videókhoz, prezentációkhoz köthető:".

You only have to use the reference tag once; the two types of links are called with the same tag.


Category tag

  • [[Category:Textes]] for French texts.
  • [[Category:Olvasmányok]] for Hungarian texts.


Full text

Full texts should be uploaded to separate pages. Data pages should only contain link to the full text. The link is added in the infobox (see above).

Do not categorize the full text page as a text page. If you categorize the full text page, the categorization will be doubled for the same text, and the system will recognize the text data page and the full text page as two different works.

Creating a new page for full text

To upload the legally accessible full text of a work, create a new page. It is recommended to use a subpage of the text data page for the full text.

Slashes (/) within a page name break the page into parent and subpages, recursively, e.g.:

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).

It is recommended to start the full text page with a <div> element containing basic information about the text.

For example, Madame Bovary/Texte intégral begins with this <div> element:

<div style="text-align: center; border: 1px solid #aaa;">
'''[[Gustave Flaubert]]'''<br>
'''Madame Bovary (1857)'''<br>
<small>Louis Conard, 1910 (p. ix-481).</small>
</div>

Which gives:

Gustave Flaubert
Madame Bovary (1857)
Louis Conard, 1910 (p. ix-481).

Note that you should not annotate the link which points to the author. Indeed, the "Work of" ("Oeuvre de") property is already added to the text data page, and if you add this property to the full text subpage, the semantic annotation will be doubled, and the system will recognize the text data page and the full text page as two different works of the given author.

Full text divided into multiple parts

You may create multiple subpages for the full text, e.g. Du côté de chez Swann/Partie 1, Du côté de chez Swann/Partie 2 and Du côté de chez Swann/Partie 3.

In this case, you can assemble these parts in a single full text page without having to copy the whole text, with the transclusion function. For example, the page Du côté de chez Swann/Texte intégral assembles the three parts with the help of the transclusion markup. For more details, see Partial transclusion.

Add links in the full text

You can add links that point to readings refering to the text. Hence not only the reading can point to the text (data page) (with the "Refers to" property), but also the original (full) text can point to the reading, with the "Cited by" ("Cité par") property.

For example, the reading Du vrai, du beau, des notes - à propos d'une note de Chateaubriand (Claude Pérez) cites Chateaubriand's Génie du christianisme. The reading points not only to the text data page (with the "Refers to" property annotation), but also to the exact point of the quoted excerpt in the full text (without the "Refers to" property annotation) with the help of anchors (see also Readings). The given excerpt points in return from the full text to the reading with the "Cited by" property annotation:

[[Cité par::Du vrai, du beau, des notes - à propos d'une note de Chateaubriand (Claude Pérez)|Saint-Denis est désert ; l’oiseau l’a pris pour passage, l’herbe croît sur ses autels brisés : et au lieu du cantique de la mort, qui retentissait sous ses dômes, on n’entend plus que les gouttes de pluie qui tombent par son toit découvert, la chute de quelque pierre qui se détache de ses murs en ruine, ou le son de son horloge, qui va roulant dans les tombeaux vides et les souterrains dévastés]]


Back to contents