pyCoinCoin 0.7 - Guide d'utilisation

Pour commencer

Installation

Composants requis

• Python, toutes versions à partir de la 2.1. Si vous ne l'avez pas sur votre système, allez faire un tour ici. Et comme je suis bon, voici des liens pour les fainéants :
• Python 2.2.1 pour Windows
• Python 2.2.1 pour MacOS
• Tarball des sources de Python 2.2.1 à se compiler à la mimine
• Pycc 0.7 a besoin du module Pmw. Téléchargez-le depuis ce site et détarrez l'archive dans le répertoire suivant :
• <rep_de_python>/lib/site-packages/ si vous avez Python >=2.2.
• <rep_de_python>/Lib/ si vous avez Python 2.1.

Petite note à l'usage des debiannistes : les modules Tkinter et xml, utilisé par pycc, sont dans des paquets séparés de Python lui-même. Une moule qui a testé pour vous (merci Quantum !) recommande : apt-get install python2.2 python2.2-tk python2.2-xml
Sans oublier de mettre Pwm dans /usr/local/lib/python2.2/site-packages/.

Lancement de pycc-0.7

• Récupérer cette archive et détarrez-la où vous voulez.
• Le programme principal est coin.py. Peut se lancer en ligne de commande : python coin.py. Assurez-vous que le répertoire de lancement est bien celui de pycc, sinon cela ne fonctionnera pas (en clair, si vous lancez en ligne de commande, faites un cd <rep_de_pycc> avant).
• Pycc utilise des fichiers de config en XML (pycc est aware, pycc est hype) et par conséquent il lui faut un parseur XML. Normalement, Python en fournit d'origine, mais on a pu constater que dans certaines distributions, ça blaireaute légèrement à ce niveau-là. Donc, si jamais la commande python coin.py vous insulte avec un message du style :
  xml.sax._exceptions.SAXReaderNotFound: No parsers found,
  sachez alors que vous faites partie des heureux élus. Solution : installez-vous le module PyXML (vous le trouverez ici).

Premier lancement

Pycc possède (des siècles avant wmccc ;-> kikoo jr) des assistants de configuration extrêmement évolués.

pyCoinCoin First Run Wizard

Cet assistant permet de configurer plusieurs paramètres généraux.

• Proxy : attention à la syntaxe. Respectez le http:// du début et le / final. Laissez le champ vide si votre connexion au web ne passe par aucun proxy.
• Commande pour le browser : attention de mettre le chemin complet (absolu) de la commande, et attention en cas de chemin comportant des espaces : mettre des guillemets autour. On peut mettre une ligne de commande complète, avec des options/arguments si on veut. "%url" peut être utilisé pour désigner l'url à ouvrir. Si on ne le précise pas, %url est automatiquement ajouté à la fin. Ceci permet de construire des lignes de commandes plus complexes.
• Exemple basique :
  "C:/Mon chemin avec espaces/mon browser.exe"
• Exemple plus compliqué :
  "C:/Mon chemin/mon browser.exe" -url:%url -option "argument avec espaces"

Da Bouchot Config Wizard

Cet assistant va vous permettre de configurer votre premier bouchot. Par la suite, pour configurer d'autres bouchots, l'assistant peut être relancé via le menu Canard > Nouveau bouchot.

La plupart des paramètres se configure de manière plutôt intuitive. Voir la section configuration pour plus de détails. Quelques précisions néanmoins :

• Le nom du bouchot est le nom par lequel le bouchot sera désigné dans pycc (qui apparaît sur l'onglet). Seuls les caractères alphanumériques, '-' et '_' sont autorisés.
• Cookie de session : ce champ n'est pas obligatoire, mais le spécifier vous permettra :
  • de poster authentifié dans la tribune,
  • d'avoir vos XPs et votes affichés dans la barre d'état de pyCoinCoin,
  • de consulter votre messagerie daCode depuis pyCoinCoin, et d'être prévenu quand de nouveaux messages arrivent.
  Pour les 2 derniers points, la case "messagerie" doit être activée.
  Pour trouver la valeur de votre cookie de session, le plus simple est d'aller sur votre page de préférences sur le site : avec daCode >=1.4, une liste de cookies valides est présentée en bas de cette page. Sinon, les méthodes barbares :
  • Avec Mozilla : Allez dans Preferences > Privacy and security > Cookies > Manage stored cookies, faites afficher les cookies de linuxfr et recopiez la valeur du champ session_id.
  • Avec Internet Explorer : recherchez le répertoire Cookies dans votre dossier personnel ; celui-ci doit contenir un fichier texte stockant les cookies de linuxfr. Dans ce fichier, vous trouverez la valeur du champ session_id.
  • Avec Opera : Opera stocke les cookies dans un fichier binaire nommé cookies.dat. En regardant bien les chaînes de caractères texte dans un éditeur, on peut quand même trouver la valeur du cookie session_id. C'est juste un peu plus casse-pieds :-)
• User agent : si on utilise les séquences spéciales '%v' et '%l', elles seront remplacées respectivement par le numéro de version de pyCoinCoin et le login utilisateur.
• Services : voir les sections Post Processor et Bots pour savoir ce qui se cache derrière cette redoutable technologie.