Getting Started (ComputerCraft)/fr

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; plus d'informations peuvent ê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%" ! commande/alias  ! Description de la commande/utilisation Récupère le contenu du code Pastebin fourni et l'enregistre dans le fichier spécifié. Le code est typiquement les chiffres/lettres qui se trouvent dans le lien Pastebin après http://pastebin.com (par exemple, si le lien est http://pastebin.com/NotValid1 alors NotValid1 est le code). Cette commande est très utile pour partager le code que l'on crée ainsi que pour permettre d'écrire du code dans un éditeur externe puis de l'importer dans le jeu. Pastebin a 2 principaux arguments, put et get. Pastebin get
 * help  
 * Seul, retourne une liste de toutes les pages d'aide. Indiquer le nom du sujet après la commande retournes de l'information sur ce sujet.
 * programs
 * Liste les programmes pouvant être exécutés.
 * apis
 * Retourne la liste des APIs (application programming interfaces) disponibles que l'on peut utiliser (par le Lua) depuis CraftOS. Plus d'informations sur diverses APIs sont disponibles en tapant la commande help suivie du nom de l'API.
 * ls/list 
 * Liste le contenu d'un répertoire; si aucun nom de dossier n'est transmis, liste le contenu du répertoire courant.
 * cd 
 * Change le répertoire courant, .. peut être utilisé pour aller dans le dossier parent de celui dans lequel la commande est exécutée.
 * mkdir 
 * Crée un nouveau dossier avec un nom de répertoire donné.
 * mv/move/rename
 * Si utilisé sans un chemin de destination, renomme le fichier; sinon, déplace et renomme le fichier.
 * edit
 * Ouvre un éditeur de texte simple pour modifier le fichier donné; si le fichier n'existe pas, il sera créé à la sauvegarde de son contenu. Appuyer sur CTRL ouvrira le menu des commandes, où l'on peut enregistrer ou fermer l'éditeur.
 * reboot
 * Redémarre CraftOS.
 * pastebin 
 * Important: Cette commande ne fonctionnera que si l'API HTTP est activée (elle l'est par défaut avec la plupart des packs FTB, mais peut être désactivée pour diverses raisons par les admins d'un serveur ou les créateurs d'un modpack).
 * Si utilisé sans un chemin de destination, renomme le fichier; sinon, déplace et renomme le fichier.
 * edit
 * Ouvre un éditeur de texte simple pour modifier le fichier donné; si le fichier n'existe pas, il sera créé à la sauvegarde de son contenu. Appuyer sur CTRL ouvrira le menu des commandes, où l'on peut enregistrer ou fermer l'éditeur.
 * reboot
 * Redémarre CraftOS.
 * pastebin 
 * Important: Cette commande ne fonctionnera que si l'API HTTP est activée (elle l'est par défaut avec la plupart des packs FTB, mais peut être désactivée pour diverses raisons par les admins d'un serveur ou les créateurs d'un modpack).
 * pastebin 
 * Important: Cette commande ne fonctionnera que si l'API HTTP est activée (elle l'est par défaut avec la plupart des packs FTB, mais peut être désactivée pour diverses raisons par les admins d'un serveur ou les créateurs d'un modpack).
 * Important: Cette commande ne fonctionnera que si l'API HTTP est activée (elle l'est par défaut avec la plupart des packs FTB, mais peut être désactivée pour diverses raisons par les admins d'un serveur ou les créateurs d'un modpack).

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 l' de base. À 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.

The set of If statements can be simplified to:

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.