Différences entre versions de « Help/Texts »
(21 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|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=== | ===Infobox=== | ||
Ligne 25 : | Ligne 39 : | ||
{{Infobox-fr | {{Infobox-fr | ||
|class = infobox | |class = infobox | ||
+ | |title = Médua | ||
|image = Maurice_Careme_Medua.png | |image = Maurice_Careme_Medua.png | ||
|booktitle = Médua | |booktitle = Médua | ||
− | |author = [[ | + | |author = [[Maurice Carême]] |
|genre = roman | |genre = roman | ||
|country = Belgique | |country = Belgique | ||
Ligne 33 : | Ligne 48 : | ||
|date = 1976 | |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>). | + | 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"| | + | ! 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. | | 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 66 : | 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 74 : | 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 :". | ||
+ | * 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 :". | ||
+ | * 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 ; 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]] | ||
+ | </pre> | ||
Version actuelle datée du 3 novembre 2020 à 12: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:
- An infobox with essential data and a link to the full text (if available);
- A short description (optional);
- Links to readings refering to the text, or to images, audio and video connected to the text;
- 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:
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.:
- 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 <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]]