« Wikilivres/Créer un wikilivre » : différence entre les versions

Un livre de Wikilivres.
Contenu supprimé Contenu ajouté
Aucun résumé des modifications
Davantage de respect des auteurs
Ligne 23 : Ligne 23 :
Pour en savoir plus sur les techniques de présentation, les formules mathématiques, les images, les animations, ... le mieux est d'aller lire le wikicode des livres existants, en cliquant sur "Modifier le wikicode" de leurs pages. N'ayez pas peur de cliquer sur cet onglet pour lire le code sans le modifier. Aucune modification n'est enregistrée tant que vous ne cliquez pas sur "Publier les modifications".
Pour en savoir plus sur les techniques de présentation, les formules mathématiques, les images, les animations, ... le mieux est d'aller lire le wikicode des livres existants, en cliquant sur "Modifier le wikicode" de leurs pages. N'ayez pas peur de cliquer sur cet onglet pour lire le code sans le modifier. Aucune modification n'est enregistrée tant que vous ne cliquez pas sur "Publier les modifications".


N'hésitez pas, dans l'élaboration d'un livre, à vous inspirer des livres présentés sur la [[Wikilivres:Vitrine|vitrine]] de Wikilivres.
== Avant de commencer ==
; Êtes-vous prêt à vous lancer dans la rédaction d'un nouveau livre ? : Démarrer un nouveau livre est une tâche fastidieuse. Il faudra sans doute y consacrer de nombreuses heures avant que votre projet ne commence à prendre forme.
; Êtes-vous prêt à travailler avec d'autres contributeurs ? : La rédaction d'un livre est parfois un travail collectif, Un tel livre n'appartient à personne en particulier, ni à celui qui l'a créé, ni même à ses contributeurs les plus réguliers. Toute personne peut donc librement contribuer de manière constructive à son élaboration, au même titre que n'importe quel autre contributeur. Les [[Wikilivres:Règles|règles consensuelles]] de cette collaboration sont peu nombreuses, peu contraignantes à l'usage, mais il est important de les respecter.


La suite présente des informations et des recommandations, non des obligations, pour les auteurs débutants.
: Plus souvent, un ou quelques auteurs sont clairement les auteurs du livre. Toutes les contributions constructives sont toujours accueillies, mais le ou les auteurs sont libres de refuser les modifications proposées.
N'hésitez pas, dans l'élaboration d'un livre, à vous inspirer des livres présentés sur la [[Wikilivres:Vitrine|vitrine]] de Wikilivres se distinguant par leur qualité.


== Les livres doivent-ils avoir un auteur ? ==

Quelques livres, ce livre d'aide par exemple, répondent à une volonté collective. Ces livres n'appartiennent à personne en particulier, ni à ceux qui les ont créés, ni à leurs contributeurs les plus réguliers. Toute personne peut librement contribuer de manière constructive à leur élaboration, au même titre que n'importe quel autre contributeur. Les [[Wikilivres:Règles|règles consensuelles]] de cette collaboration sont peu nombreuses, peu contraignantes à l'usage, mais il est important de les respecter. Bien sûr, de tels livres ne doivent pas être signés.

Plus souvent, un ou quelques auteurs sont clairement les auteurs du livre. Ils peuvent, ou non, s'identifier comme tels. Toutes les contributions constructives sont toujours accueillies, mais le ou les auteurs sont libres de refuser les modifications proposées.
== À qui s'adresse le livre ? ==
== À qui s'adresse le livre ? ==
Un livre ne s'adresse pas toujours à tous les publics : novices ou spécialistes du domaine abordé, étudiants ou enseignants, enfants ou adultes. Le contenu du livre doit être adapté au public choisi. Ce choix doit être visible par le lecteur dès le début du livre. Exemples :
Un livre ne s'adresse pas toujours à tous les publics : novices ou spécialistes du domaine abordé, étudiants ou enseignants, enfants ou adultes. Le contenu du livre doit être adapté au public choisi. Ce choix doit être visible par le lecteur dès le début du livre. Exemples :
Ligne 36 : Ligne 38 :
* Le projet [[Wikijunior]] « consiste à réaliser une compilation de livres et un magazine destinés aux enfants âgés de 8 à 11 ans »
* Le projet [[Wikijunior]] « consiste à réaliser une compilation de livres et un magazine destinés aux enfants âgés de 8 à 11 ans »


== Préalables ==
== Prérequis ==
La lecture d'un livre peut supposer un minimum de connaissances préalables. Pour l'auteur, cela peut être un moyen d'éviter de reformuler des notions trop élémentaires, que le public concerné aura de toute manière déjà acquises et qui n'auront que peu d'intérêt pour lui. Il est important dans ce cas, dans l'intérêt du lecteur, de spécifier et préciser ces pré-requis, afin de lui éviter la frustration de perdre son temps, son énergie et sa volonté à tenter de lire un texte trop difficile. Ces pré-requis doivent être accompagnés des références vers la littérature appropriée : textes introductifs, articles de wikipédia, autres wikilivres, etc.
La lecture d'un livre peut supposer un minimum de connaissances préalables. Il est important dans ce cas, dans l'intérêt du lecteur, de spécifier et préciser ces prérequis, et de les accompagner des références vers la littérature appropriée : textes introductifs, articles de wikipédia, autres wikilivres, etc.


== Objectifs pédagogiques ==
== Objectifs pédagogiques ==
Les objectifs pédagogiques du livre doivent être définis et présentés en quelques phrases sur la page de garde ou dans l'introduction. Le lecteur doit pouvoir comprendre de manière claire ce que la lecture du contenu du livre est susceptible de lui apporter. Exemple :
Il est souhaitable que les objectifs pédagogiques du livre soient définis et présentés en quelques phrases sur la première page. Le lecteur doit pouvoir comprendre de manière claire ce que la lecture du contenu du livre est susceptible de lui apporter. Exemple :
* « Au terme de sa lecture, le lecteur aura tous les éléments requis pour choisir, assembler lui-même, installer et même dépanner son PC. ». tiré de l'introduction de [[Monter un PC]] donnée en page de garde.
* « Au terme de sa lecture, le lecteur aura tous les éléments requis pour choisir, assembler lui-même, installer et même dépanner son PC. ». ([[Monter un PC]]).


== Préparation du plan ==
== Première page ==
Soignez la première page, elle doit donner envie d'aller plus loin.
Le plan d'un livre est une aide vitale à l'élaboration de son contenu. Même si ce plan n'a en général rien de définitif - attendez-vous à ce qu'il subisse de profondes modifications au cours de la rédaction du livre - il est important d'en établir un dès la création du livre. Une simple liste de sections et chapitres liés à des pages non encore existantes sur la page de garde suffit à créer un plan, et à fournir aux autres contributeurs une base de travail.

Voici un exemple de patron de page de garde pouvant servir de base :


== Page de garde ==
Soignez la page de garde, telle une couverture. Il s'agit de la vitrine du livre, et elle doit donner envie d'aller plus loin. Voici un exemple de patron de page de garde pouvant vous servir de base :
<source lang="text">
<source lang="text">
{{nouveau livre}}
{{nouveau livre}}
Nom d'auteur, ou noms des auteurs (s'ils souhaitent s'identifier)


== Introduction ==
Ici votre texte d'introduction


Ici un court texte d'introduction
== Table des matières ==

# [[/Truc|Titre du chapitre au sujet du truc]]
'''Table des matières'''
# [[/Bidule|Titre du chapitre au sujet de bidule]]
# [[/Titre du premier chapitre/]]
# [[/Titre du second chapitre/]]
# ...
# ...


'''A qui s'adresse ce livre ?''' ...
</source>


'''Objectifs pédagogiques''' : ...
Votre texte d'introduction devrait comporter :
* une introduction du sujet (le titre n'est peut être pas suffisant pour décrire tout ce que le livre aborde, profitez de l'introduction pour lever toute ambiguïté) ;
* le public ciblé (à qui s'adresse ce livre : des docteurs en physique quantique ou des élèves d'école primaire ?) ;
* pré-requis (quelles connaissances sont nécessaires à la lecture de votre livre ?) ;
* les objectifs de la lecture (qu'est ce que lecteur saura de plus qu'avant après sa lecture) ;
* éventuellement, une illustration.
L'introduction que vous rédigerez n'est évidemment pas définitive, vous pourrez la modifier ou la compléter par la suite.


'''Table des matières détaillée'''
Si il n'y a pas d'ordre séquentiel entre les chapitres mais qu'il s'agit plutôt d'un découpage par thèmes, vous pouvez utiliser des * au lieu des #.
# [[/Titre du premier chapitre/]]
## Titre de la première section
...


</source>
== Choix du titre ==
Le titre du livre doit suivre les [[Wikilivres:Conventions sur les titres|conventions sur les titres]].


S'il n'y a pas d'ordre séquentiel entre les chapitres mais qu'il s'agit plutôt d'un découpage par thèmes, vous pouvez utiliser des * au lieu des #.
== Conseils pour éviter les faux-pas les plus courants ==


== Choix du titre ==
Voici quelques faux-pas issus de l'expérience des contributeurs, qui ont eux-mêmes commis et dû corriger ces erreurs. Les éviter permettra à tous, auteurs et lecteurs, de ne pas perdre un temps et une énergie précieux.
Le titre du livre doit suivre les [[Wikilivres:Conventions sur les titres|conventions sur les titres]].

=== Nommez les sous-pages créées par leur titre, et ne le numérotez pas ===


== Ne numérotez pas les titres des chapitres ==
Cette erreur consiste à appeler les sous-pages d'un livre « Mon livre/Chapitre 1 », « Mon livre/Chapitre 2 », etc. Le nom donné à une page doit permettre de se faire une idée de son contenu. D'autre part, le plan du livre a toutes les chances d'être modifié à la longue : modification de l'ordre des chapitres, introduction de chapitres intermédiaires, fusion ou scission de chapitres, etc. Toute modification de cette sorte nécessitera un renommage laborieux de toutes les pages dont le numéro est obsolète.


Vous voudrez peut-être modifier le plan du livre : ordre des chapitres, insertion de chapitres intermédiaires, fusion ou scission de chapitres, etc. Toute modification de cette sorte nécessitera un renommage laborieux de toutes les pages dont le numéro est obsolète.
Le choix de nommer une page par son titre ou un résumé de son titre, sans aucune indication d'ordre, est à la fois le plus flexible et celui permettant d'organiser le mieux le contenu d'un livre. Une fois le plan du livre à peu près stabilisé, l'ordre des pages pourra dans un second temps être spécifié sur chaque page à l'aide d'un [[:Catégorie:Modèle pour la navigation|modèle de navigation]] permettant de passer d'un chapitre à l'autre.


== Voir aussi ==
== Voir aussi ==
* [[Wikilivres:Cycle de vie d'un livre|Cycle de vie d'un livre]]
* [[Wikilivres:Cycle de vie d'un livre|Cycle de vie d'un livre]]
[[en:Using Wikibooks/Starting A New Wikibook]]


{{AutoCat}}
{{AutoCat}}

Version du 27 avril 2017 à 08:50

Si vous voulez créer un nouveau livre, il suffit d'éditer un lien

[[Titre du livre]]

en modifiant le texte source (le wikicode) de votre page utilisateur, ou de toute autre page qui existe déjà. Après avoir publié la modification, ou seulement en la prévisualisant, vous devriez alors voir le lien cliquable en rouge, comme ceci : Titre du livre. Cliquez dessus et vous arriverez à une page intitulée "Création de Titre du livre". Vous pouvez alors commencer à travailler sur votre nouveau livre. Attention, dès que vous aurez cliqué sur "Publier la page", la première page de votre livre sera publiée. Elle pourra être supprimée si finalement vous renoncez à votre projet. Il est toujours recommandé de cliquer sur "Prévisualiser" avant de publier.

Si vous voulez créer un nouveau chapitre, il suffit d'éditer un lien

[[/Titre du chapitre/]]

sur la première page du livre, pour y écrire la table des chapitres. Il suffit alors de cliquer sur le lien rouge, comme précédemment.

Le texte-source (le wikicode) peut être édité comme sur un traitement de texte ordinaire. Pour le commençant, il suffit de connaître l'usage des signes d'égalité pour identifier les sections d'un chapitre (sur Wikibooks, un chapitre est simplement une page) et leurs sous-sections :

== Titre d'une section ==
=== Titre d'une sous-section ===
==== Titre d'une sous-sous-section ====
Premier paragraphe...

Second paragraphe...

Pour en savoir plus sur les techniques de présentation, les formules mathématiques, les images, les animations, ... le mieux est d'aller lire le wikicode des livres existants, en cliquant sur "Modifier le wikicode" de leurs pages. N'ayez pas peur de cliquer sur cet onglet pour lire le code sans le modifier. Aucune modification n'est enregistrée tant que vous ne cliquez pas sur "Publier les modifications".

N'hésitez pas, dans l'élaboration d'un livre, à vous inspirer des livres présentés sur la vitrine de Wikilivres.

La suite présente des informations et des recommandations, non des obligations, pour les auteurs débutants.

Les livres doivent-ils avoir un auteur ?

Quelques livres, ce livre d'aide par exemple, répondent à une volonté collective. Ces livres n'appartiennent à personne en particulier, ni à ceux qui les ont créés, ni à leurs contributeurs les plus réguliers. Toute personne peut librement contribuer de manière constructive à leur élaboration, au même titre que n'importe quel autre contributeur. Les règles consensuelles de cette collaboration sont peu nombreuses, peu contraignantes à l'usage, mais il est important de les respecter. Bien sûr, de tels livres ne doivent pas être signés.

Plus souvent, un ou quelques auteurs sont clairement les auteurs du livre. Ils peuvent, ou non, s'identifier comme tels. Toutes les contributions constructives sont toujours accueillies, mais le ou les auteurs sont libres de refuser les modifications proposées.

À qui s'adresse le livre ?

Un livre ne s'adresse pas toujours à tous les publics : novices ou spécialistes du domaine abordé, étudiants ou enseignants, enfants ou adultes. Le contenu du livre doit être adapté au public choisi. Ce choix doit être visible par le lecteur dès le début du livre. Exemples :

  • « Ce livre s'adresse aux étudiants démarrant une formation autour de l'informatique théorique, c'est à dire principalement dans un cadre universitaire, en début de premier cycle. », extrait de Algorithmique impérative sur la page Avant-propos dans une section intitulée « À qui s'adresse ce livre ? ».
  • Le projet Wikijunior « consiste à réaliser une compilation de livres et un magazine destinés aux enfants âgés de 8 à 11 ans »

Prérequis

La lecture d'un livre peut supposer un minimum de connaissances préalables. Il est important dans ce cas, dans l'intérêt du lecteur, de spécifier et préciser ces prérequis, et de les accompagner des références vers la littérature appropriée : textes introductifs, articles de wikipédia, autres wikilivres, etc.

Objectifs pédagogiques

Il est souhaitable que les objectifs pédagogiques du livre soient définis et présentés en quelques phrases sur la première page. Le lecteur doit pouvoir comprendre de manière claire ce que la lecture du contenu du livre est susceptible de lui apporter. Exemple :

  • « Au terme de sa lecture, le lecteur aura tous les éléments requis pour choisir, assembler lui-même, installer et même dépanner son PC. ». (Monter un PC).

Première page

Soignez la première page, elle doit donner envie d'aller plus loin.

Voici un exemple de patron de page de garde pouvant servir de base :

{{nouveau livre}}
Nom d'auteur, ou noms des auteurs (s'ils souhaitent s'identifier)


Ici un court texte d'introduction

'''Table des matières'''
# [[/Titre du premier chapitre/]]
# [[/Titre du second chapitre/]]
# ...

'''A qui s'adresse ce livre ?''' ...

'''Objectifs pédagogiques''' : ...

'''Table des matières détaillée'''
# [[/Titre du premier chapitre/]]
## Titre de la première section
...

S'il n'y a pas d'ordre séquentiel entre les chapitres mais qu'il s'agit plutôt d'un découpage par thèmes, vous pouvez utiliser des * au lieu des #.

Choix du titre

Le titre du livre doit suivre les conventions sur les titres.

Ne numérotez pas les titres des chapitres

Vous voudrez peut-être modifier le plan du livre : ordre des chapitres, insertion de chapitres intermédiaires, fusion ou scission de chapitres, etc. Toute modification de cette sorte nécessitera un renommage laborieux de toutes les pages dont le numéro est obsolète.

Voir aussi