ThePythonGameBook

learn Python. Create Games

User Tools

Site Tools


fr:aide

Aide & Licence

Comment naviguer dans ce Wiki

Ce wiki est organisé en pages. Contrairement à un livre en papier, une page peut devenir relativement longue. Utilisez le défilement et les touches <key>PageSuivante</key>, <key>PagePrécédente</key> afin de vous assure d'avoir lu la page en entier.

Sur le gros en-tête au-dessus de chaque page, vous devriez voir le nom de la page à droite, et un lien vers la page d'accueil à gauche. Si vous cliquez sur le nom de la page à droite, vous verrez une liste des sites (de ce wiki) pointant vers le site actuel. Utilisez la fonction “Retour” (ou “Précédent”) de votre navigateur pour revoir le site actuel.

À droite de chaque page, vous pouvez voir une zone contenant quelques liens permanents, le Logo du Python Game Book (Tux en train de lire un livre) et un menu navigation avec une arborescence. Cliquez sur les liens individuels (espaces de noms) and le menu de navigation pour voir si plus de liens (pages ou espaces de noms secondaires) deviennent visibles.

Comment améliorer le Python Game Book

  • en lisant et en commentant par e-mail (cf. contacter l'auteur)
  • en créant un compte (c'est gratuit) sur The Python Game Book, en vous connectant et:
    • en créant un site personnel ici: personnes
    • en relisant et en corrigeant les erreurs
    • en traduisant dans votre langue (cette fonctionnalité est mise en pause jusqu'à ce que la partie à propos de Pygame en anglais soit réalisée)
    • en améliorant et en modifiant le code, les textes et les médias
    • en ajoutant votre propre code, vos textes et vos médias
  • en rejoignant la page Facebook du Python Game Book et en faisant connaître le site
  • en devenant un site partenaire (vous placez le logo de ce site sur le vôtre et je place votre logo sur le mien)

Donations

devenez un sponsor du Python Game Book:

Soutiens Flattr

Dons Bitcoins

vous pouvez faire des dons bitcoins à cette adresse (de Horst JENS): 12ERTTag6CeouWszhcZbo6oYZKRbwfBK8b



Comment utiliser ce Wiki (Faire des changements, Créer des pages)

Est-ce la première fois que vous utilisez un wiki ou dokuwiki ? Vous aurez besoin de vous identifier en utilisant un compte (la création est gratuite, vous n'aurez besoin que d'une adresse e-mail valide). Pour faire vos premiers pas dans l'édition de pages wiki, je vous conseille de vous rendre dans le bac à sable et d'y écrire quelques bricoles.

Dans la boîte Commandes à la droite de chaque page se trouve un lien vous permettant d'éditer la page. Afin d'utiliser cette fonction, vous aurez besoin d'être identifié (à l'aide de votre nom d'utilisateur et de votre mot de passe) sur ce wiki. Ces liens se trouvent également dans chaque section si vous êtes identifié.

Si vous éditez une page, vous verrez une petite fenêtre d'édition avec quelques icônes sur le dessus. Elles vous permettent d'envoyer des images ou des fichiers, et vous aide à utiliser la syntaxe Dokuwiki. Sous la fenêtre d'édition se trouvent trois icônes importantes: <key>Enregistrer</key>, <key>Aperçu</key> et <key>Annuler</key>.

Si vous voulez en apprendre plus sur la syntaxe et l'édition d'une page (ou la création d'une nouvelle page), rendez-vous sur la page Formating Syntax où la syntaxe dokuwiki est expliquée. Ce livre utilise quelques modules additionnels. Si vous voyez quelques syntaxes wiki étranges comme:

{{tag>license, copyright}}

ou

{{include>about}}

c'est que vous voyez un de ces modules en action. Pour plus d'informations, cherchez le nom des modules (comme “tag” ou “include”) sur la page des modules Dokuwiki 1)



Lignes de conduite internes pour les auteurs

Voici quelques lignes de conduite, surtout utiles pour Horst et les autres auteurs réguliers.

Première personne, référence personnelle

Si vous voulez faire référence à vous-même dans une phrase (des mots comme je, moi, mon, mien etc.), utilisez le module WRAP et sur la gauche, un petit avatar ou une photographie de vous-même. Il y a une icône au-dessus de la fenêtre d'édition pour cette fonctionnalité. Syntaxe:

<WRAP round box>{{avatar-pic.jpg?50 }}Je pense pouvoir m'enorgueillir de ce code, fruit des heures et des heures passées derrière mon clavier.</WRAP>

Liens externes

À cause de la version papier, la traduction, le CD live, d'autres versions hors-lignes et une mauvaise utilisation de ce wiki par des liens de spammers: Les liens externes, comprennant les liens wikipedia, devraient se retrouver dans l'espace de noms "glossaire" 2).

Syntaxe:

dans cette page:
Voilà vraiment un [:fr:glossaire:t:truc_cool|truc cool]] sur le web.
La page du glossaire:
====== truc cool ======
Voilà un [[wp>truc cool|truc cool]].
==== liens externes: ====
* http://www.truc.cool

L'espace de noms "glossaire"

Pour ajouter un nouvel espace dans l'espace de noms fr:glossaire, assurez-vous d'avoir mis un espace de noms secondaire avec la première lettre de l'entrée du glossaire. Par exemple:

L'entrée du glossaire pour truc_cool ne doit pas être:
fr:glossaire:truc_cool
mais plutôt:
fr:glossaire:t:truc_cool

Ce afin d'éviter de surcharger la barre latérale de navigation avec trop d'entrées. Avoir un survol de glossaire dans un ordre alphabétique paraît également plus propre, comme dans un livre papier.

Clavier, touches et raccourcis

Si possible, utilisez le module key pour indiquer que des touches doivent être pressées. Ce module est également utile pour dessiner de petites boîtes autour d'un mot. Il y a une icône au-dessus de la fenêtre d'édition pour cette fonctionnalité. Syntaxe:

Veuillez appuyer sur <key>PageSuivante</key>

L'étiquetage

Il est possible et même bienvenu d'étiqueter tout et n'importe quoi. La fonctionnalité d'étiquetage est très simple:
{{tag>mot-clé1 mot-clé2 mot-cléX}}

Si (dans une page du glossaire ou ailleurs) une liste de pages avec une certaine étiquette est désirée, entrez:
{{topic>mot-clé}}

Il est possible de faire des combinaisons AND ou OR dans les mots-clés. Cette fonctionnalité permet de n'afficher les étiquettes que d'un espace de nom voulu. Cf. licences pour exemple.



Licence

logo creative-commons BY-SA The Python Game Book est sous licence cc-by-sa, ce qui signifie que son contenu en-ligne quel qu'il soit restera libre. Vous être libre d'utiliser ce contenu pour vos travaux personnels / livres / projets, à condition de partager vos travaux gratuitement également, et en contribuant auprès de l'auteur d'origine (en plaçant un lien vers http://ThePythonGameBook.com). Je me réserve le droit de réaliser une “version papier deluxe” du livre à partir de ce Python Game Book, et de le vendre. Son contenu, cependant, demeurera gratuit et libre, et toujours disponible depuis ce site et sous licence cc.

Si vous n'êtes pas à l'aise avec cette licence, merci de ne pas contribuer.

N'oubliez pas non plus de vérifier que les contenus de parties tierces doivent également être compatibles avec cette licence CC-BY-SA.

1)
naturellement, cette page est aussi un dokuwiki, mais différent de ceux du Python Game Book.
2)
traduction approximative du propos d'origine
/var/www/horst/thepythongamebook.com/data/pages/fr/aide.txt · Last modified: 2014/01/09 11:07 (external edit)