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

Un livre de Wikilivres.
Contenu supprimé Contenu ajouté
Aucun résumé des modifications
Ligne 24 : Ligne 24 :


== Avant de commencer ==
== 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. Vous pouvez commencer par contribuer à la rédaction d'un ou plusieurs chapitres d'un livre déjà existant, cela vous donnera un aperçu de l'effort à produire.
; Ê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 peut être 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. Plus souvent, un ou quelques auteurs sont clairement les auteurs du livre. Toutes les contributions constructives sont toujours accueillies, mais la règle est que les livres ne soient pas modifiés contre la volonté de leurs auteurs.
; Ê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. : 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é. Vous pouvez aussi dans une certaine mesure vous inspirer de la structure ou du contenu d'un livre non libre, en particulier d'un livre de référence sur le domaine abordé, mais veillez dans ce cas à ne commettre aucun plagiat ou violation de droit d'auteur.
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é.


== À qui s'adresse ce livre ? ==
== À qui s'adresse ce livre ? ==
Un livre ne pourra pas s'adresser à 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 :
* « 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 [[Algorithmique impérative/Avant-propos|Avant-propos]] dans une section intitulée « À qui s'adresse ce livre ? ».
* « 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 [[Algorithmique impérative/Avant-propos|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 »
* Le projet [[Wikijunior]] « consiste à réaliser une compilation de livres et un magazine destinés aux enfants âgés de 8 à 11 ans »

Version du 26 avril 2017 à 12:00

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

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 règles consensuelles de cette collaboration sont peu nombreuses, peu contraignantes à l'usage, mais il est important de les respecter. : 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 vitrine de Wikilivres se distinguant par leur qualité.

À qui s'adresse ce 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éalables

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.

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 :

  • « 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.

Préparation du plan

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.

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 :

{{nouveau livre}}

== Introduction ==
Ici votre texte d'introduction

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

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.

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

Choix du titre

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

Conseils pour éviter les faux-pas les plus courants

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.

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

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.

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 modèle de navigation permettant de passer d'un chapitre à l'autre.

Voir aussi