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 Unix; 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 it's 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...

The print function in this example concentrates the multiple arguments( ie  is the same as  this example shows how to create a program, how to simply print information to the screen, simply reading input, and storing data in a 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)...

Running this code will show something like the following on the screen... To turn lamp on, press L. To exit, press any other key.

(Assuming user presses L, the lamp turns on and the following shows up...)

To turn lamp off, press L. To exit, press any other key.

Pressing any other key will return the user to the CraftOS prompt. This program looks complicated, but in reality it's just very messy (and actually violating a few conventions). However, writing this code shows the user the essence of what is happening and sets one up for the next example.

Computer Light Switch Mk. II
This example will use the setup from the previous example. Here, the user will learn to use functions as well as other aspects of the Redstone API to control the lamp and avoid "bulky" code. It is recommended to start a new program file rather than editing the old one (due to the way the CraftOS editor works). For simplicity I will omit most of the previous comments to allow the code to be seen easier. this program uses a new part of the redstone API, redstone.getOutput(side), this allows the computer to read if the computer is powering redstone or not, and takes only one argument, side.

Smart Computer Light Switch
Content coming.

What To Do When Things Don't Work
It will happen; one will spend time meticulously writing code only to save and run their program to find... it won't work. There's usually a few important things to check before throwing the mouse at the nearest innocent bystander...


 * 1) Check the error message... 99.999% of the time it will tell one exactly where the mistake was made (improper syntax, missing end statement, etc).
 * 2) Check the use of case (upper and lower case letters). Remember, functions are usually start with a lower case letter but additional 'words' will have upper case in them (for example - redstone.setOutput).
 * 3) Check control statements (while, for, if, etc). Make sure they're declared right and terminated correctly (sometimes a missing end statement won't register for quite a few lines).
 * 4) When in doubt, write it out. One can sometimes be surprised how glaring an error is when rewriting something... despite missing it the first time.
 * 5) Ask the Community. Sometimes things are trickier than they appear to be but chances are someone has made the same mistake and figured it out, however, there's also a good chance that with another pair of eyes on the problem everyone can learn how to do it... maybe even find a better way! Just remember to search the forums for previous posts before making a new thread.