Comment rédiger un article ou un tutoriel ?

**Alcatîz** · 15/11/2014, 13h02

Bonjour à toutes et à tous,

Si vous souhaitez rédiger un article, un tutoriel, un cours complet, une traduction, etc., il ne faut pas que l'aspect technique de la chose vous rebute. Voici donc comment cela se passe concrètement.

Qui dois-je prévenir ?

Pour rédiger, vous allez avoir besoin de certains outils et d'un peu de documentation. Pour que nous puissions vous les fournir et vous donner les explications nécessaires, la meilleure façon est d'envoyer un MP ou un e-mail au (ou à un des) responsable(s) de la rubrique, dont le nom figure au bas de toutes les pages de la rubrique.

De quels outils ai-je besoin ?

Eh bien vous possédez déjà plus que probablement l'outil principal de rédaction : votre traitement de texte.

Nous vous fournissons un plugin à ajouter à votre traitement de texte, avec des styles prédéfinis et une barre d'outils vous permettant d'insérer des images, des liens, des zones de code, etc.

Voici à quoi cela ressemble sur Libre office :

En utilisant les styles de titres et de texte fournis, et en prenant soin d'utiliser les boutons de la barre d'outils pour insérer des éléments dans le texte, votre document sera directement prêt à être publié, sans que vous ayez à vous tracasser d'un quelconque format ou d'une quelconque charte graphique.
Difficile de faire plus simple, n'est-ce pas ?

Lorsque sera venu le moment de publier votre article, vous aurez la possibilité d'obtenir votre domaine personnel pour l'héberger. Un outil supplémentaire vous sera alors fourni pour mettre votre article en ligne, ainsi que pour créer automatiquement une version pdf, une version e-books et une archive.

Aurai-je de l'aide ?

Bien sûr, et sous plusieurs formes !

D'abord, vous aurez accès à toute la documentation des outils, sous forme de wiki, d'articles et même en vidéo.
Ensuite, vous aurez accès à un forum privé, où vous pourrez demander des conseils pratiques, mais aussi demander de l'aide par exemple pour faire le plan de votre article, pour une relecture technique, etc.
Et si vous n'êtes pas trop à l'aise avec l'orthographe, n'ayez pas d'inquiétude : une équipe de correcteurs relira votre article.
Vous pourrez bien sûr également vous adresser directement au(x) responsable(s) de rubrique ou à un membre de la rédaction si vous avez un souci.

Franchement, ce n'est pas le côté technique de la rédaction d'un article qui doit vous faire reculer. Foncez !

Invité · 16/11/2014, 14h54

Envoyé par Alcatîz

Franchement, ce n'est pas le côté technique de la rédaction d'un article qui doit vous faire reculer. Foncez !

Bonjour,

Oui, oui... On dit cela. Mais ce Kit -qui ne m'est vraiment pas "naturel"- a failli me rendre -enfin ce n'est pas sûr qu'il n'y soit pas arrivé- complètement "cinglé"... et faute de réussir ce que j'essayais, j'ai failli lâcher. Heureusement que l'Equipe était dans le coin

Donc je m'accroche. Je devrais bientôt pouvoir 'éditer" quelque chose de manière à peu près autonome et reproductible... Enfin, il n'y a pas que le premier pas qui compte, ni la bonne volonté

**Alcatîz** · 17/11/2014, 06h21

Bonjour Gilles,

La tendance, au départ, est d'essayer de faire ressembler le document Office au rendu final de l'article. C'est bien compréhensible mais... vain.

Si l'on se contente d'appliquer les styles et d'utiliser la barre d'outils pour insérer des éléments, certes le rendu ne sera pas beau dans le traitement de texte mais ce n'est pas le but : le kit analysera le document et s'occupera tout seul d'en faire un article au format définitif. Je reconnais que nous n'insistons probablement pas assez sur ce point.

**SergioMaster** · 17/11/2014, 07h39

Bonjour,

Envoyé par Alcatîz

La tendance, au départ, est d'essayer de faire ressembler le document Office au rendu final de l'article. C'est bien compréhensible mais... vain.

Si l'on se contente d'appliquer les styles et d'utiliser la barre d'outils pour insérer des éléments, certes le rendu ne sera pas beau dans le traitement de texte mais ce n'est pas le but : le kit analysera le document et s'occupera tout seul d'en faire un article au format définitif. Je reconnais que nous n'insistons probablement pas assez sur ce point.

il est vrai que lorsque l'on introduit des éléments autres que le texte ,des images en particulier, le document office n'est plus à la hauteur de nos espérances

Heureusement préparer le xml, puis le transformer grâce au kit afin de voir le résultat hors-ligne rassure sur la qualité du produit fini . Un grand bravo à l'auteur du KitUnix (3° options de la barre) qui intègre toutes les manipulations pour en faire de simple "pousse bouton" .

Bon il est vrai que la mise en place de ce kit n'est pas simplissime , mais les vidéos d'aide sont très bien faites . Les nombreuses fenêtres commandes qui s'affichent sont également , j'allais dire déroutantes mais non je dirais plutôt simplement inesthétiques .
Chaque fois que j'utilise ce kit , je fini bluffé par le résultat

"houa , c'est moi qui ai pondu ça !"

Envoyé par Alcatîz

Franchement, ce n'est pas le côté technique de la rédaction d'un article qui doit vous faire reculer. Foncez !

Je souscrit à cette affirmation et encouragement

Ayez le bonheur de sauter le pas , animez votre forum préféré

A vous aussi l'angoisse de la page blanche, le doute sur votre prose , les recherches approfondies , les relectures à la recherche des fautes et bêtises avant d'oser proposer en lecture à d'autres de peur de passer pour un ....

ça sent mon vécu

non , franchement , écrire sur un sujet qui vous passionne , vous permettra d'approfondir vos connaissances sur le sujet et ça , c'est la cerise sur le gâteau .
Partagez votre savoir faire , c'est le but même du forum

Serge

**Roland Chastain** · 17/11/2014, 14h12

Bonjour !

Au risque de répéter ce qui a été dit, j'ajouterai mon grain de sel.

C'est vrai qu'il y a un temps à prendre au départ pour installer l'outil et le prendre en main. Il m'est arrivé de m'arracher les cheveux parce que je ne trouvais pas comment faire dans Libre Office certaines choses très simples. Le problème aussi est que comme j'utilise l'outil de façon sporadique, j'oublie d'une fois sur l'autre tous les automatismes. Du coup j'essaie de m'en servir de temps en temps pour des documents à usage personnel, histoire de ne pas perdre la main.

Mais une fois que vous maîtrisez l'outil, quelle puissance ! Vous obtenez en un clic un document de qualité, dans tous les formats existants, sans avoir eu à vous soucier ni de la mise en page, ni du style...

**Paul TOTH** · 17/11/2014, 17h55

personnellement tant qu'à ne pas se soucier de la mise en page, j'aurais de loin préféré une notation de type Wiki. Avec un tout petit peu d'effort on pourrait même imaginer que les article soient rédigés directement sur le site en mode Wiki avec un onglet discussion (comme WikiMedia) pour les correcteurs par exemple.

**e-ric** · 24/11/2014, 21h23

Salut

J'adhère complètement à l'idée de Paul, je traduis des articles depuis quelques temps sur le wiki de FreePascal, c'est très pratique et ça se prend assez rapidement en main.

Question : où se procurer le plugin ?

Cdlt

**clementmarcotte** · 24/11/2014, 21h36

Bonjour,

Je sais bien que je ne connais rien en Delphi, mais je pense à quelque chose du côté de VB.net ou MS Office. Je vais cogiter là-dessus. Mais, pour l'Instant, ma principale priorité est de récupérer mes fichiers d'aide de Visual Studio. Parce que, sans fichier d'aide, cela va mal.