Utilisez Markdown pour rédiger des articles ou tutoriels sur Developpez.com

En plus des autres outils toujours disponibles

Le 2016-02-15 15:38:23, par Anomaly, Responsable technique

Chers membres du Club,

J'ai le plaisir de vous annoncer qu'il est désormais possible de rédiger des cours, tutoriels, et articles en utilisant le langage de balisage Markdown. Ceci s'ajoute aux autres méthodes actuellement disponibles pour rédiger sur Developpez.com !

Écrire un cours, tutoriel ou article sur Developpez.com, c'est très facile ! Vous avez plusieurs méthodes, la plus simple étant de rédiger l'article depuis OpenOffice, LibreOffice ou Microsoft Office ; mais vous avez également accès à un format XML, un éditeur en ligne ainsi qu'un éditeur hors ligne, et maintenant le format Markdown. Vous pouvez rédiger que vous soyez sous Windows, Linux ou Mac OS, que vous ayez une connexion Internet permanente ou pas.

Enfin, vous pouvez même rédiger immédiatement en utilisant votre Blog sur Developpez.com qui est toujours disponible, en utilisant le BBCode familier du forum.

Publier un cours, tutoriel ou article sur Developpez.com, c'est le rendre accessible à 4 millions de visiteurs uniques par mois, et un public majoritairement développeur et IT pro. Découvrez les nombreux avantages de publier sur Developpez.com.

Proposez vos articles ou idées d'article et rejoignez la Rédaction.

Nous vous souhaitons une agréable navigation sur les forums, le site et le Chat de Developpez.com.

L'équipe de rédaction de Developpez.com

Discussion forum

41 commentaires

Anomaly
Responsable technique

Envoyé par Pierre Fauconnier

A quand un outil en ligne? J'ai pour l'instant un rédacteur qui ne publie pas son article parce que pour installer les outils qui permettent la publication, ben c'est galère...

Pour l'édition directement en ligne, le plus facile reste effectivement les Blogs, comme l'a déjà souligné un commentateur.

Mais il est aussi possible d'utiliser un éditeur XML en ligne pour ceux qui rédigent les articles à l'ancienne en XML, le format d'origine des articles.

Après je suppose que dans le cas du Markdown il sera facile de l'étendre pour pouvoir supporter notamment le format Markdown plutôt que le XML.

C'est tout nouveau, les outils s'améliorent au fur et à mesure.

le 15/02/2016 à 19:31
tomlev
Rédacteur/Modérateur

Excellente nouvelle
Je serai peut-être un peu moins réticent à me lancer dans la rédaction d'un nouvel article si je n'ai pas besoin d'installer OpenOffice + plugin + Perl + Java

Par contre, en pratique, comment on fait ? Il suffit de déposer le fichier markdown sur son hébergement, ou il y a autre chose à faire ?

le 15/02/2016 à 17:05
djibril
Responsable Perl et Outils

Bonjour à tous,

Je vais essayer de vous éclairer sur ce sujet qui passionne les foules. Pour ceux qui le savent, Developpez.com propose plusieurs outils pour rédiger des tutoriels. Tous se basent sur un fichier final qui est au format XML. Ils permettent de rédiger un tutoriel sur son PC avec ou sans Internet.
Rédiger directement en XML n'est pas à la portée de tout le monde et pas forcément simple, même s'il était le seul moyen il y a plusieurs années et cela a fonctionné pendant plus de dix ans ainsi.
Depuis quelques mois voire années maintenant, les rédacteurs de developpez.com ont la possibilité de rédiger leurs tutoriels en .docx (via Microsoft Word et une extension), en .odt (via OpenOffice ou LibreOffice et une extension). Pour rédiger, vous n'avez besoin que de cela.
Maintenant depuis quelques semaines, vous avez la possibilité de rédiger en Markdown. Les connaisseurs de Markdown le savent, il existe une multitude d'extensions de Markdown, il est donc difficile de se baser sur tout. La rédaction via ce nouveau format ne fonctionne qu'avec la syntaxe basique de Markdown comme son créateur l'avait mis en place. Il y a quelques nouvelles syntaxes qui ont été rajoutées pour coller au mieux avec les possibilités de developpez.com. Mais ne vous attendez pas à créer des sous-tableaux de tableaux en Markdown, chaque format a ses limites.

Vous avez donc un nouveau format de rédaction.

En ce qui concerne la publication par la suite, le procédé reste le même. Le Kit de rédaction contient un programme pour convertir votre article rédigé en Markdown vers le format XML...

Donc pour rédiger, vous n'avez pas besoin de Perl, JAVA... que ce soit en Markdown ou non et ce depuis des lustres.
Le seul moment où vous avez besoin d'installer des prérequis, c'est pour la publication finale. Et c'est installé une fois pour de bon.
Pour Perl, les recommandations sont d'installer Strawberry Perl et non ActivePerl. De plus, il existe une version portable de StrawBerry Perl, ce qui permet pour les personnes non admin de pouvoir l'utiliser.

Voilà, j'espère avoir été clair. Pour les personnes souhaitant le tester et ayant ou non des soucis, n'hésitez pas à m'en faire part dans le forum outils privé et je me ferais un plaisir de vous aider.

le 24/02/2016 à 17:12
Pierre Fauconnier
Responsable Office & Excel

Envoyé par tomlev

Excellente nouvelle
Je serai peut-être un peu moins réticent à me lancer dans la rédaction d'un nouvel article si je n'ai pas besoin d'installer OpenOffice + plugin + Perl + Java

Par contre, en pratique, comment on fait ? Il suffit de déposer le fichier markdown sur son hébergement, ou il y a autre chose à faire ?

Je ne peux que plussoyer, en y ajoutant mon grain de sel: A quand un outil en ligne? J'ai pour l'instant un rédacteur qui ne publie pas son article parce que pour installer les outils qui permettent la publication, ben c'est galère...

le 15/02/2016 à 18:59
Anomaly
Responsable technique

Envoyé par tomlev

Je serai peut-être un peu moins réticent à me lancer dans la rédaction d'un nouvel article si je n'ai pas besoin d'installer OpenOffice + plugin + Perl + Java

Alors en effet il faut Perl et Java installés pour faire fonctionner le Kit de rédaction. En revanche, OpenOffice et son plugin ne sont nécessaires... que si tu choisis d'utiliser OpenOffice en guise d'outil de rédaction.

Envoyé par tomlev

Par contre, en pratique, comment on fait ? Il suffit de déposer le fichier markdown sur son hébergement, ou il y a autre chose à faire ?

Actuellement il faut avoir le kit installé, et simplement lancer la commande qui fabrique l'article depuis le source Markdown. Mais d'autres possibilités seront bientôt en place pour rendre le processus encore plus facile.

le 15/02/2016 à 19:28
Gugelhupf
Modérateur
Bonsoir,

Je suis prêt à publier des tutoriels sur lesquels j'ai bossé si les outils Developpez me permettent de les publier. J'ai rencontré de nombreux difficultés avec le plugin Word par exemple.

Le BBCode c'est bien, Markdown c'est bien aussi, mais Markdown ne permet pas de créer des tableaux de manière standard. Il faudrait par exemple dire quel est le format Markdown pour créer des tableaux sous Developpez. Il faut aussi prendre en compte les tableaux Markdown pouvant contenir 2 colonnes avec du code (si vous à faire cela, je pense que ce sera bon système de tableau).

L'idéal c'est d'avoir quelque chose de simple :
- Utiliser un langage de balisage léger (un Markdown qui gère les tableaux ou rester sur du BBCode), surtout pas ne pas mettre en place une sorte de Word intégré (trop complexe à gérer, pas suffisamment responsive).
- Un navigateur pour écrire directement à partir du site Developpez (donc rien de spécifique à télécharger : Office, Java, Perl etc)
- Pouvoir prévisualiser le tutoriel quand on le souhaite, sans avoir à uploader des fichiers (un peu comme les article de blog en fait)
- Pouvoir écrire l'article en one-shot (single page) ou partie par partie.
Plus complexe : gérer le versionning...

Cordialement,
le 15/02/2016 à 19:59
Anomaly
Responsable technique
Alors pour répondre aux questions du mieux que je peux :

Le KitMarkDown est fait "maison", à ma connaissance. Il supporte le dialecte basique et de minimes extensions spécifiques pour supporter les spécificités des articles Developpez.com.

Pour utiliser ce kit sous Windows, il faut avoir Strawberry Perl. Après s'il manque des modules, il faut juste faire ce qui est demandé dans le message d'erreur, c'est-à-dire :
Code :
```
ppm install Markdent::Parser
```
J'ai attiré l'attention des auteurs du KitMD (djibril et Michael Baron) pour qu'ils puissent vous répondre plus spécifiquement sur les questions que vous avez posées. En effet je ne suis que le messager

Cependant, Roland Chastain, tu devrais poser tes questions dans le forum privé des outils, auquel tu as accès en tant que rédacteur. En effet c'est là que tu peux télécharger les outils, c'est là que tu peux consulter la documentation spécifique du KitMD qui a été rédigée par djibril.
le 24/02/2016 à 15:17
Roland Chastain
Rédacteur/Modérateur

@Anomaly, djibril

Merci pour toutes ces informations.

Envoyé par Anomaly

Cependant, Roland Chastain, tu devrais poser tes questions dans le forum privé des outils, auquel tu as accès en tant que rédacteur. En effet c'est là que tu peux télécharger les outils, c'est là que tu peux consulter la documentation spécifique du KitMD qui a été rédigée par djibril.

Oui, effectivement.

@psychadelic

Les outils en question sont réservés à ceux qui rédigent des articles pour Developpez.com. Donc, pour en savoir plus, il faut devenir rédacteur.

Autrement les deux outils que j'ai cités dans mon précédent message fonctionnent bien. Pandoc permet de générer des documents dans un grand nombre de formats.

le 24/02/2016 à 18:00
djibril
Responsable Perl et Outils

Pandoc, c'est bien, mais tout dépend de ce que tu fais du futur document et d'où vient le fichier source. Je l'ai testé et des fois, !

le 24/02/2016 à 18:01
djibril
Responsable Perl et Outils

StackEdit utilise également ses propres extensions de Markdown, gère à sa manière certaines balises HTML alors que le kit ne le fait pas. Bref, de toute façon, chaque outil a sa propre usine à Gaz.

le 25/02/2016 à 13:52

Poster une réponse