
gedit-markdown: support du Markdown dans gedit
Téléchargement
Lien rapide de téléchargement de gedit-markdown.
Qu'est-ce que gedit-markdown?
gedit-markdown est un ensemble de fichiers permettant d'ajouter le support du Markdown dans gedit, l'éditeur de texte par défaut de Gnome.
Plus précisément, gedit-markdown ajoute:
- un type MIME pour les fichiers Markdown ainsi que la reconnaissance de l'extension
.mdtxt; - la coloration syntaxique des fichiers Markdown dans gedit ainsi que des extraits de code;
- le greffon Markdown Preview pour gedit.
Localisation
Les messages de l'installateur sont localisables depuis la version 1.1. Toute personne intéressée à effectuer une traduction peut donc copier le fichier gedit-markdown.pot situé dans le répertoire locale, le renommer en LANGUE.po, traduire les phrases contenues dans le fichier et m'envoyer le fichier .po.
Pour l'instant, gedit-markdown est disponible en français.
Dépendances
L'installateur a été fait pour GNU/Linux. Sous Windows XP, seule la coloration syntaxique fonctionne, et doit être installée à la main.
Pour utiliser les extraits de code de Markdown, il faut activer dans gedit le greffon Extraits de code dans Édition > Préférences > Greffons.
À partir de la version 10.04 d'Ubuntu, le paquet
python-gtkhtml2a été retiré des dépôts. Or, le greffon Markdown Preview dépend de ce paquet. Vous pouvez installer gedit-markdown et ne pas utliser ce greffon, mais si vous voulez l'utiliser, il faut télécharger une version antérieure depython-gtkhtml2et l'installer manuellement. Pour récupérer le paquet dans une console sous GNU/Linux:wget http://security.ubuntu.com/ubuntu/pool/main/g/gnome-python-extras/python-gtkhtml2_2.25.3-3ubuntu1.9.10.1_i386.debEnsuite, cliquer sur le fichier téléchargé. Un installateur devrait vous guider. Après l'installation, le fichier peut être supprimé.
Installation
GNU/Linux
Note importante: ce logiciel est développé sous Ubuntu et a été testé avec succès sous différentes versions d'Ubuntu. Je ne peux garantir que la marche à suivre pour l'installation est identique sur toutes les distributions GNU/Linux, ni même que ça fonctionne partout.
Télécharger l'archive de la dernière version de gedit-markdown sur http://www.jpfleury.net/gedit-markdown.
Décompresser l'archive. Dans une console sous GNU/Linux (dans le même dossier que celui où se trouve l'archive):
tar xvf nom-de-l_archive.tbz2Toujours dans la console, lancer l'installation:
gedit-markdown/gedit-markdown.sh installer
Le support de Markdown sera ajouté à l'utilisateur courant (l'installation se fait donc sans les droits du superadministrateur). Le dossier gedit-markdown créé par l'extraction de l'archive peut être effacé ou mis à la corbeille après l'installation.
Windows XP
Il n'y a qu'un fichier à copier, car seule la coloration syntaxique fonctionne. Dans l'archive de gedit-markdown, trouver le fichier suivant:
language-specs/markdown.lang
et le copier dans le dossier suivant:
C:\Program Files\gedit\share\gtksourceview-2.0\language-specs\
ce qui donne au final:
C:\Program Files\gedit\share\gtksourceview-2.0\language-specs\markdown.lang
Désinstallation
Dans une console sous GNU/Linux, lancer la désinstallation:
gedit-markdown/gedit-markdown.sh desinstaller
Utilisation
Si gedit est ouvert, redémarrez-le. Ensuite, aller dans Édition > Préférences > Greffons et activez Markdown Preview. Maintenant vous trouverez dans le menu Outils une action Markdown Preview, qui fera s'afficher l'aperçu du document courant dans le panneau inférieur (s'assurer que ce panneau est affiché en allant dans le menu Affichage).
Pour la coloration syntaxique, elle devrait s'activer automatiquement pour les fichiers reconnus comme étant des fichiers Markdown (extension .mdtxt), sinon choisir la coloration à la mitaine en allant dans Affichage > Mode de coloration > Balisage et cocher Markdown.
Précisions ou limitations
Markdown n'a pas d'extension officielle. J'ai donc fait un choix arbitraire en lui assignant l'extension
.mdtxt. Markdown n'a pas non plus de type mime officiel. Je lui ai assignétext/x-markdown. Ces choix me semblent quand même valables.Puisqu'il est possible d'ajouter du code HTML directement dans un texte écrit en Markdown, j'ai ajouté à la coloration syntaxique du Markdown celle pour le HTML. Il faut cependant savoir que selon la syntaxe officielle Markdown, du code Markdown dans un environnement HTML n'est pas transformé, il est affiché tel quel. Cependant, gedit-markdown fait présentement colorer syntaxiquement le code Markdown dans du HTML. Il faut se rappeller que ça ne devrait pas être le cas.
Markdown permet d'écrire du code dans un paragraphe en entourant le code d'un accent grave (`), ou de plusieurs, pourvu que le nombre soit identique de part et d'autre, et qu'il n'y ait pas dans le code un nombre identique d'accents qui se suivent. Exemples:
`lorem lorem lorem lorem` `lorem lorem `` lorem lorem` `lorem lorem ````` lorem lorem` ``lorem lorem lorem lorem`` ``lorem lorem ` lorem lorem`` ``lorem lorem ````` lorem lorem``Prendre note que gedit-markdown supporte la coloration jusqu'à 2 accents de part et d'autre du code.
Selon la syntaxe Markdown, pour écrire plusieurs paragraphes dans des listes, il faut indenter chaque paragraphe. Il y a donc conflit au plan de la coloration syntaxique entre un paragraphe indenté à l'intérieur d'une liste (4 espaces ou une tabulation) et une ligne de code indentée en dehors d'une liste (également 4 espaces ou une tabulation). La coloration en dehors de liste prime, ce qui signifie qu'un paragraphe à l'intérieur de liste va s'afficher comme du code. Cette limitation concerne quelques autres éléments, comme les citations à l'intérieur de liste. Je ne sais pas trop comment résoudre ce problème, étant donné qu'il n'est pas possible (en tout cas de ce que je connais de la coloration sous GtkSourceView 2) de savoir dans quel contexte on se situe et de faire dépendre la coloration d'une ligne de ce qui se trouve sur des lignes précédentes.
J'ai voulu utiliser une coloration syntaxique qui se rapproche du rendu par défaut du HTML, par exemple de l'italique pour une emphase légère, des liens soulignés, etc., le tout sans devoir créer un fichier de style personnalisé dans
/usr/share/gtksourceview-2.0/styles(ce qui forcerait les utilisateurs à choisir dans gedit le style personnalisé). Il y a donc quelques rendus imparfaits, comme l'emphase forte qui est en gras MAIS AUSSI en vert. Cette limitation est dépendante de la résolution du bogue http://bugzilla.gnome.org/show_bug.cgi?id=573653.
Captures d'écran
Visitez la galerie de captures d'écran de gedit-markdown.
Problèmes ou suggestions
Pour faire part d'un problème d'utilisation avec gedit-markdown, proposer une fonctionnalité ou poser une question, il y a quelques possibilités:
- laisser un commentaire sur la page de gedit-markdown;
- envoyer un message à partir du formulaire de contact;
- faire un rapport de bogue sur Launchpad;
- ou poser une question sur Launchpad.
Coordonnées et licence
- Auteur: Jean-Philippe Fleury
- Site web: http://www.jpfleury.net/gedit-markdown
- Contact: http://www.jpfleury.net/contact
gedit-markdown est distribué suivant les termes de la GNU General Public License telle que publiée par la Free Software Foundation: soit la version 3 de cette licence, soit (à votre gré) toute version ultérieure. Voir le fichier gpl-3.0.txt pour la version officielle de la licence, et le fichier gpl-3.0.fr.txt pour une traduction francophone non officielle.
Développement
bzr est utilisé pour le versionnage des fichiers. La version de développement est disponible sur Launchpad.
Changements et versions
Pour la liste des changements, voir le fichier ChangeLog dans l'archive du logiciel.
| Fichier attaché | Taille |
|---|---|
| gedit-markdown-1.1.6.tbz2 | 48.62 Ko |
| gedit-markdown-1.1.6.zip | 61.16 Ko |
Hi,
I followed you installation guide and it worked fine. As I'm not a python coder, my installation should be pretty plain. But the preview plugin crashed with this error:
$ gedit File "/home/blindgaenger/.gnome2/gedit/plugins/markdownpreview.py", line 4 SyntaxError: Non-ASCII character '\xc2' in file /home/blindgaenger/.gnome2/gedit/plugins/markdownpreview.py on line 4, but no encoding declared; see http://www.python.org/peps/pep-0263.html for details ** (gedit:31185): WARNING **: Error loading plugin 'Markdown Preview'I fixed it by setting the source code encoding of
markdownpreview.pyto UTF-8. So this should be the default:#!/usr/bin/python # -*- coding: utf-8 -*-Cheers, blindgaenger
Hi blindgaenger,
Thanks a lot for your message. The problem has been fixed in version 1.1.2.
Regards,
Jean-Philippe
Hi Jean-Philippe,
Great, will try it when I'm updating. Thanks!
Cheers, Bernd
Works like a charm! thanx!!!
You're welcome. :-)
Hi,
just a quick hint:
in the deactivate function, you do use
manager.remove_action_ui(windowdata["ui_id"])This should be changed to
manager.remove_ui(windowdata["ui_id"])Fixes gedit crashing on every exit.
Thanks a lot. Fixed in gedit-markdown-1.1.5
Hi!
I am on Ubuntu 10.04 Lucid Lynx.
Going to menu Edit > Preferences > Plugins and selecting Markdown Preview greys out the plugin description and the tickbox does not get ticked. All other plugins are deactivated.
Anyone knows why and how to make it work?
Same here. Can't check the tickbox for the plugin because it greys out. On Ubuntu 10.04 as well.
Anyone??
Yes, I confirm this bug on Ubuntu 10.04 too. I'll try to find the problem and fix it soon. I'll give feedback here.
Any news RE this 10.04 bug ?
Thxs ;-)
Markdown Preview depends on
python-gtkhtml2, but this package was removed from the Ubuntu 10.04 repository, so we must install it manually. We can download it for example at this URL: http://security.ubuntu.com/ubuntu/pool/main/g/gnome-python-extras/python-gtkhtml2_2.25.3-3ubuntu1.9.10.1_i386.debI updated the gedit-markdown description to explain it.
Thxs, I'll test that ASAP :)
Publier un nouveau commentaire