Getting Started (ComputerCraft)/fr


 * Please note that this guide is very much a WiP (Work in Progress) at this time. Please PM AgentTadpole on the forums with any comments or corrections

Introduction
 consiste essentiellement en trois composants importants; l', les s, et les  qui se relient aux deux éléments précédemment cités pour étendre leurs fonctionnalités de base. Il est possible de crafter les trois sans jamais écrire un vrai programme, en utilisant seulement les programmes intégrés fournis par le mod... mais ce serait ignorer le vrai potentiel de ComputerCraft. Ce guide présume que l'utilisateur n'a aucune expérience du Lua, le langage de programmation utilisé par ComputerCraft, et expliquera les bases au fur et à mesure de sa progression. Veuillez également noter que ce guide abordera seulement quelques uns des concepts et des composants de base de ComputerCraft; de l'information supplémentaire peut être trouvée sur le site officiel de ComputerCraft ainsi que sur ce wiki et dans des guides qui viendront dans le futur.

L'ordinateur
Le premier et plus simple des composants de ComputerCraft est le. La recette est assez peu coûteuse et il peut être crafté relativement tôt si vous avez la chance de trouver de la redstone. Le Computer peut être placé où le joueur le souhaite et peut être récupéré en le cassant avec n'importe quel outil.

Faire un clic droit sur le ouvre la ligne de commande de CraftOS (CraftOS est le système d'exploitation par défaut pour les s); c'est à partir d'ici que la plupart des utilisateurs lancent des programmes sur leurs s.

Commandes CraftOS basiques
Les commandes basiques utilisées dans CraftOS sont, pour la plupart, identiques ou très proches des commandes basiques utilisées par presque toutes les distributions des systèmes d'exploitation *nix; ainsi, la plupart des utilisateurs (même ceux qui ont occasionnellement utilisé la ligne de commande dans d'autres OS, comme Windows ou OSX) devraient se familiariser facilement avec celles-ci. Toutes les commandes sont exécutées depuis CraftOS. Notez que les paramètres en italique sont considérés optionnels.

{| class="wikitable" width="100%" ! command/command alias ! Command description/use
 * help  
 * On its own, returns a list of help topics. Specifying the topic after the command returns information on that topic.
 * programs
 * Lists the available programs to be run.
 * apis
 * Returns a list of available APIs (application programming interfaces) that one can use (via Lua) from within CraftOS. More information on various APIs can be obtained by typing using the help command followed by the API name.
 * ls/list  
 * Lists the contents of a directory. If no directory is given lists the contents of the current one.
 * cd
 * Changes the current directory; can be used to go to the parent directory of where the command is issued.
 * mkdir
 * Creates a new directory with the given name.
 * mv/move/rename
 * cd
 * Changes the current directory; can be used to go to the parent directory of where the command is issued.
 * mkdir
 * Creates a new directory with the given name.
 * mv/move/rename
 * mv/move/rename
 * mv/move/rename

Simple, n'est-ce pas? Enregistrez le fichier et fermez l'éditeur, puis entrez le nom du programme. Si tout va bien, ce qui suit devrait apparaître dans la fenêtre de CraftOS...

Félicitations pour vos premiers pas dans n'importe quel langage de programmation. Même si il ne fait qu'une ligne, ce programme montre comment afficher du texte dans la fenêtre. C'est généralement la principale manière de renvoyer de l'information à un utilisateur (en dehors du graphisme, qui est hors du cadre de ce guide).

Hello Username
Tandis que renvoyer du texte est important, il est aussi important de recevoir une entrée (que ce soit de l'information utilisable par le programme directement ou utilisable pour la navigation dans une interface). Ce programme va étoffer les explications à propos de la fonction print, ainsi qu'introduire le concept de variables et les fonctions read et write.

Ouvrez un nouveau fichier dans l'éditeur (nom recommandé: "hello2"). Entrez y ce qui suit...

Enregistrez et fermez l'éditeur, puis exécutez le programme. Il attendra une saisie de l'utilisateur, mais la sortie devrait globalement avoir l'air de cela...

La fonction print dans cet exemple concentre plusieurs arguments, c.-à-d. que  revient à écrire cet exemple montre comment créer un programme, comment afficher des informations à l'écran facilement, lire une entrée, et stocker les données dans une variable.

Ordinateur-interrupteur
Cet exemple requiert un peu plus de matériel que le  basique. À gauche de l'ordinateur, placez soit un peu de redstone soit un (un seul bloc suffit). À côté, placez une lampe (le type n'a pas d'importance). Notez que l'on peut faire cette installation de n'importe quel côté de l'ordinateur, toutefois, cela modifiera la manière dont le code doit être écrit (quoique c'est plutôt explicite).

Dans cet exemple, un certain nombre de nouvelles fonctions/déclarations sont introduites incluant la boucle while, les déclarations conditionnelles if...then...else, os.pullEvent, print, redstone.setOutput, et les commentaires (pour faciliter la navigation/l'identification des sections du code). Le texte qui se trouve après un  sont des commentaires.

Entrez le code suivant (n'hésitez pas à omettre les commentaires, ils sont présent pour faciliter la lecture du code, mais il est compréhensible que quelqu'un trouve que cela fait un peu trop à taper)...

Exécuter ce code affichera quelque chose comme ce qui suit à l'écran... Pour allumer la lampe, appuyez sur L. Pour quitter, appuyez sur n'importe quelle autre touche.

(En supposant que l'utilisateur appuie sur L, la lampe s'allume et ce qui suit s'affiche...)

Pour éteindre la lampe, appuyez sur L. Pour quitter, appuyez sur n'importe quelle autre touche.

Appuyer sur n'importe quelle autre touche renverra l'utilisateur vers l'invite de commande CraftOS. Ce programme a l'air compliqué, mais en réalité c'est seulement très désordonné (et il viole quelques conventions, en fait). Cependant, écrire ce code montre à l'utilisateur l'essence de ce qui se passe et le prépare pour le prochain exemple.

Ordinateur-interrupteur V2
Cet exemple utilisera l'installation de l'exemple précédent. Ici, l'utilisateur apprendra à utiliser les fonctions ainsi que d'autres aspects de l'API Redstone pour contrôler la lampe et éviter un code "volumineux". Il est recommandé de commencer un nouveau programme plutôt que d'éditer l'ancien (en raison de la manière dont fonctionne l'éditeur de CraftOS). Par simplicité je vais omettre la plupart des commentaires précédents pour permettre d'apréhender le code plus facilement. Ce programme utilise une nouvelle partie de la Redstone API, redstone.getOutput(direction), qui permet èa l'ordinateur de lire si il émet un courant de redstone ou pas, et admet un seul argument, la direction.

Interrupteur intelligent
Contenu à venir.

Que Faire Quand Les Choses Ne Fonctionnent Pas
Cela vous arrivera; on passe du temps à écrire méticuleusement du code seulement pour enregistrer et exécuter le programme et se rendre compte que... ça ne marche pas. Il y a généralement quelques choses à vérifier avant de jeter sa souris sur le premier curieux...


 * 1) Vérifier les messages d'erreur... 99.999% du temps ils vous disent exactement où vous avez fait une erreur (syntaxe incorrecte, oubli de déclaration end, etc).
 * 2) Vérifier la casse (lettres en majuscules et minuscules). Souvenez vous, les fonctions commencent généralement avec une lettre minuscule mais des 'mots' supplémentaires auront une majuscule (par exemple - redstone.setOutput).
 * 3) Vérifier les déclarations de contrôle (while, for, if, etc). Assurez vous qu'ils sont correctement déclarés et terminés correctement (quelquefois un end manquant ne sera pas enregistré avant quelques lignes).
 * 4) En cas de doute, réécrivez le. On est quelquefois surpris de voir comme une erreur est flagrante quand on la réécrit... malgré qu'on l'ait ratée la première fois.
 * 5) Demandez à la Communauté. Parfois les choses sont plus compliquées qu'il n'y parait, mais il est possible que quelqu'un ait fait la même erreur et ait compris comment s'en sortir, cependant, si ce n'est pas le cas, il est aussi possible qu'un autre regard sur le problème permette de le résoudre, voire de trouver une meilleure manière d'arriver au même résultat! Pensez juste à chercher dans les anciens posts sur les forums avant de lancer une nouvelle discussion.