Voir la source de Help/Texts

'''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:
# An [[#Infobox|infobox]] with essential data and a [[#Full text|link to the full text]] (if available); 
# A [[#Short description|short description]] (optional);
# [[#Links to readings, images, audio and video|Links]] to readings refering to the text, or to images, audio and video connected to the text;
# 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===
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:
<pre>
{{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
}}
</pre>
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.

====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]].
{| class="wikitable sortable" style="text-align:left;"
! Parameter name !! class="unsortable"|Parameter name rendered in French !! class="unsortable"|Parameter name rendered in Hungarian !! class="unsortable"|Notes
|-
| 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> || The name of an image ''without'' the <code>File:</code> or <code>Fichier:</code> part.
|-
| 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> ||
|-
| 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 ||
|-
| 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ő:".


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

====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.
 
====Add links to 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>


[[User help|{{#fas:caret-left}} Back to contents]]
[[Category:Help]]
{{interlanguagelink:en|Help-Texts}}