Personnaliser KompoZer avec ChromeUtils

[Kazé]

Bonjour,

ceci s'adresse à ceux qui souhaitent apporter de petites modifications à KompoZer, ou aux développeurs qui souhaitent contribuer des rustines de code (patches).

Pré-requis :

• connaissance et pratique de JavaScript et CSS ; pour les interfaces, il sera nécessaire de se familiariser avec XUL : http://xulfr.org/xulplanet/xultu/
• les scripts 'ChromeUtils' :
  • GNU/Linux : http://kompozer.net/zip/ChromeUtils-20070728.tgz
  • Windows™: http://kompozer.net/zip/ChromeUtils-20070728.zip
• un bon éditeur texte : les développeurs utiliseront le leur, pour les autres je recommande vivement les éditeurs basés sur Scintilla : Scite, Notepad++, Geany, ...

et c'est tout. Pas la peine de télécharger le code source ni d'installer un compilateur.

Mise en oeuvre :

• dézipper 'ChromeUtils' dans le répertoire de KompoZer.
  Attention : vous devez avoir des droits en écriture dans ce répertoire ! Sous Windows™ c'est vrai pour les 99% d'utilisateurs qui utilisent cet OS avec un compte administateur (au mépris de la plus élémentaire des règles de sécurité, jdcjdr), sous Linux c'est le contraire. Je recommande dans ce cas de télécharger une version ZIP ou TGZ de KompoZer et de la dézipper dans son répertoire "Documents".
• un dossier 'chrome.utils' a été créé dans le répertoire de KompoZer. Pour l'instant il ne contient qu'un README et deux scripts : compare et flatten. Sous Windows™ j'ai ajouté un dossier 'wbin' qui contient 7-zip et les utilitaires GNU nécessaires.
• lancer 'flatten' (.sh sous Linux, .bat sous Windows™) :
  • le répertoire 'chrome' est archivé en 'chrome.orig' ;
  • les fichiers JAR du répertoire 'chrome' sont mis à plat : à la place de chaque fichier JAR, il y a désormais un dossier éponyme contenant des fichiers *.xul, *.js et *.css, le tout bien rangé dans trois dossiers :
    • content : le code et l'interface graphique (*.js, *.xul)
    • locale : les chaînes localisées (*.dtd, *.properties)
    • skin : les styles appliqués au(x) thème(s) installé(s) (images + *.css)
  • KompoZer utilisera désormais ces fichiers mis à plat, il sera même probablement un peu plus rapide sur les PC modestes.
• on peut donc modifier ces fichiers xul/js/css avec un éditeur texte et relancer KompoZer pour voir les changements. La plupart des choses intéressantes sont dans 'chrome/content/editor'.
• Vous avez fait une modification dont vous êtes fier ? Lancez le script 'compare' ! Cela va générer une rustine de code (patch) que vous pourrez proposer ici ou m'envoyer par mail. Accessoirement cette rustine sera une sauvegarde de votre travail.
• Vous avez cassé KompoZer ? Rien de grave, il suffit de supprimer le dossier 'chrome', de renommer 'chrome.orig' en 'chrome'... et de relancer 'flatten' pour ré-essayer.

J'ai très peu testé ces scripts mais ils sont tellement simples qu'ils devraient fonctionner correctement ! S'ils font des adeptes, j'ajouterai un script 'patch' pour qu'on puisse s'échanger et tester des patches.

À vos éditeurs !

Edit : s/comm/chrome/

[Mongo Bob]

ça marche, Kaze, merci, plus de bordures rouges mais je pense que tu voulais dire, à la place de :

La plupart des choses intéressantes sont dans 'comm/content/editor'.

plutôt : dans 'chrome\content\editor\EditorContent.css
(c'est dans ce fichier que j'ai pu mettre en commentaires la règle des bordures rouges, c'est ça qu'il fallait faire? En tout cas, ça a marché)
J'ai mis le fichier que compare m'a créé en ligne, mais à l'ouvrir je sais pas si c'est ce que tu voulais :
http://jlwebnet.free.fr/kz-200708202314.patch

à+ merci encore

[Mongo Bob]

Aïe!
Après la nv 0.7.10, installé chromeutils, et lancé flatten, Kpz ne se lance plus. J'ai recommencé en supprimant tout, lancé Kpz après install de chromeutils, OK, Kpz se lance, c'est bien juste après flatten qu'il veut plus.
J'ai renommé chrome.orig en chrome, relancé flatten, cette fois, j'arrive à relancer Kpz, je fais ma modif dans Editorcontent (suppression des bordures rouges pour les <div> sous commentaires css "/* */") lancé Kpz, OK, mais plus de Cascades ni dans les outils ni dans la barre d'outils principale...
J'ai tout supprimé et réinstallé sauf chromeutils pour l'instant, Kpz se lance et Cascades est réapparu, à bientôt.



PS : tu avais vu ça, post précédent ?

je pense que tu voulais dire, à la place de :
Citation:
La plupart des choses intéressantes sont dans 'comm/content/editor'.
plutôt : dans 'chrome\content\editor\EditorContent.css
(pour correction dans le tuto qui crée le topic)

[Kazé]

KompoZer 0.7.10 win32, aucune extension installée.
Je n'ai constaté aucun problème avec ChromeUtils, 'flatten' fonctionne correctement.
Je ferai plus de tests à l'occasion, pour voir si des extensions peuvent mettre le souk là-dedans.

je pense que tu voulais dire, à la place de :

La plupart des choses intéressantes sont dans 'comm/content/editor'.

plutôt : dans 'chrome\content\editor\EditorContent.css

Non, je voulais dire 'chrome/content/editor'. J'ai corrigé le premier billet.
Le fichier EditorContent.css ne fait que modifier l'apparence du contenu de la fenêtre d'édition, tous les autres fichiers permettent de modifier le comportement de KompoZer. A terme je souhaite que ces scripts permettent à des développeurs du dimanche de me proposer des améliorations ou des corrections sur KompoZer.

[Mongo Bob]

KompoZer 0.7.10 win32, aucune extension installée.
Je n'ai constaté aucun problème avec ChromeUtils, 'flatten' fonctionne correctement.

oui, ben c'est comme ça qu'il faut faire, à savoir installer Chromeutils en 1er avant toute extension.
Accessoirement, j'ai ensuite fait ma modif sur les bordures rouges des <div>, mais j'eus pu la faire en dernier... Puis, installé les ext une à une (1/ Handcoder 2/French 3/Lorem 4/ NSM) en redémarrant entre chaque pour bien surveiller, eu le message "toolbar button id:NSMedit button" en-dessous de la barre d'état après install de Handcoder au redémarrage, message disparu après install de French au redémarrrage, à la fin Cascades est là et bien là et donc tout va bien.
Je suppose donc que si install de Chromeutils désirée, mieux vaut repartir de 0 et installer celui-ci en 1er.
Damn! est-ce que le fait d'avoir supprimé mon profil en même temps que Kpz avant de réinstaller celui-ci a joué?
Sais pas.