[v4] Corrections & Améliorations de la doc FR

Archive.
Patrick88
Messages : 1564
Inscription : mer. 21/janv./2004 18:24

Message par Patrick88 »

problème avec la doc, F1 = j'ai ce message

Code : Tout sélectionner

Navigation vers la page Web annulée 
   
   Essayez la chose suivante : 
     Saisissez à nouveau l’adresse. 
http://purebasic.developpez.com/documen ... eBasic.chm

arg

pat
Avatar de l’utilisateur
GeBonet
Messages : 453
Inscription : ven. 29/févr./2008 16:17
Localisation : Belgique

Message par GeBonet »

Salut,

Malgré tout le travail que cela te donne...
comtois a écrit : Et j'ai aussi mis le fichier d'aide au format chm en ligne, vous pouvez le télécharger ici.
C'est la version la plus à jour.
Le lien "ici" fonctionne, mais le "PureBasic.chm" téléchargé de 2338 Ko ne donne que les titres des sujets... Et pas de contenu lorsque l'on clics ?

Est-ce ??? Cela m'était déjà arrivé avec une autre version sous la même forme.

Merci et bonne année
:lol:
comtois
Messages : 5172
Inscription : mer. 21/janv./2004 17:48
Contact :

Message par comtois »

oui , faut que je mette le chm dans un zip sinon le firewall ou l'antivirus refuse d'ouvrir le fichier correctement !!

mais c'est le même que dans la version 4.30 , je n'ai pas compilé un nouveau chm pour l'instant.
http://purebasic.developpez.com/
Je ne réponds à aucune question technique en PV, utilisez le forum, il est fait pour ça, et la réponse peut profiter à tous.
Patrick88
Messages : 1564
Inscription : mer. 21/janv./2004 18:24

Message par Patrick88 »

oky merci
comtois
Messages : 5172
Inscription : mer. 21/janv./2004 17:48
Contact :

Message par comtois »

Je viens de passer un petit moment à comparer le fichier catalog français avec le fichier catalog anglais de l'IDE et j'ai trouvé ces différences

SourcePattern est déjà traduit, c'est juste pour vous montrer ce qui changera dans l'IDE.

Un petit coup de pouce pour le reste de la traduction ?
SourcePattern = Fichier PureBasic (*.pb, *.pbi)|*.pb;*.pbi|Source PureBasic (*.pb)|*.pb|Fichier inclu PureBasic (*.pbi)|*.pbi|Tous les fichiers (*.*)|*.*

Color32 = Warning Background (Debugger)
Color33 = Warning Symbol (Debugger)

WarningMode = Choose Warning level
WarningsIgnore = Ignore Warnings
WarningsDisplay = Display Warnings
WarningsError = Treat Warnings as Errors

Profiler = Profiler
ProfilerStartup = Start Profiler on program startup

Warning = Warning
WarningTotals = Compilation succeeded with %warnings% warning(s).
LogCompiler = [COMPILER]

SelectWarning = Use Warning mode

ExecutableType = Executable type

LogError = [ERROR]
LogWarning = [WARNING]

VersionError = The Version of debugger and executable do not match!%newline%Try recompiling the executable.%newline%If the problem persists, reinstall PureBasic.
ExeQuitError = The debugged executable quit unexpectedly.
TimeoutError = The debugged executable did not respond to communication for 5 seconds. Disconnecting.

[StandaloneDebugger]
CommandFile = Cannot read command file '%filename%'.
http://purebasic.developpez.com/
Je ne réponds à aucune question technique en PV, utilisez le forum, il est fait pour ça, et la réponse peut profiter à tous.
Patrick88
Messages : 1564
Inscription : mer. 21/janv./2004 18:24

Message par Patrick88 »

il y a un nouveau gadget non décrit dans la doc :
ButtonImageGadgetNoSkin()

pat
Avatar de l’utilisateur
GeBonet
Messages : 453
Inscription : ven. 29/févr./2008 16:17
Localisation : Belgique

Message par GeBonet »

Salut et bonne année...

Pour cela moi je propose cela comme traduction....
**********************************************************
Color32 = Warning Background (Debugger)
= Fond d'écran d'attention !
Color33 = Warning Symbol (Debugger)
= Fond d'écran de la ligne à être Déboguer
-----------------------------------------------
WarningMode = Choose Warning level
= Choix du niveau d'alerte (attention)
WarningsIgnore = Ignore Warnings
= Ignorer l'alerte
WarningsDisplay = Display Warnings
= Afficher l'alerte
WarningsError = Treat Warnings as Errors
= Traiter l'alerte comme une erreur
Profiler = Profiler
= Profileur (Donne le profil)
ProfilerStartup = Start Profiler on program startup
= Démarrer le profilage du programme.
Warning = Warning
= Attention
WarningTotals = Compilation succeeded with %warnings% warning(s).
LogCompiler = [COMPILER]
= Compilation terminée avec %warnings% point d'attentions. a voir dans LogCompiler = [COMPILER]
Attention je ne suis pas certains du fichier Log ?

SelectWarning = Use Warning mode
= Utilisez le mode d'alerte
ExecutableType = Executable type
= Type executable
LogError = [ERROR]
= ERREUR
LogWarning = [WARNING]
= [ATTENTION]
VersionError = The Version of debugger and executable do not match!%newline%Try recompiling the executable.%newline%If the problem persists, reinstall PureBasic.
= La version du debbuger est différente de l'executable /newline% Essayer de recompiler l'executable %newline%. Si le problème continue, réinstaller PureBasic.
ExeQuitError = The debugged executable quit unexpectedly.
= Le debugger s'est arrêté anormalement
TimeoutError = The debugged executable did not respond to communication for 5 seconds. Disconnecting.
= L'executable en train d'être debugger ne répond pas depuis 5 secondes. Il se desconnecte
[StandaloneDebugger]
Debugger autonome]
CommandFile = Cannot read command file '%filename%'.
= Impossible le lire le fichier de commande '%filename%'
********************************************************
Autre chose :

Je suppose que tu parle de "Editor.catalog"... ??

Parce que en Anglais il y a :

Compiler.catalog du (28/08/2008)
Editor.catalog du (13/12/2008)
Debugger.catalog du (16/12/2008)
Libraries.catalog du (16/12/2008)


Alors qu'en français il n'y a que :

Compiler.catalog du (28/08/2008)
Editor.catalog du (21/04/2006) Ici pas été revue depuis ?????
Visual Designer Language.catalog (Inchangé depuis... mars 2006)


Maintenant question... :

- Debugger.catalog et Librairies.catalog ?
N'existe pas en français ?
- Ou pas encore traduit ? Ou se sont de nouveau code d'erreur ?


La traduction doit partir de l'explication en anglais ... ? Alors qu'il apparait que même dans la forme anglaise il y ai certaines expressions pas très correctes...

Genre : >> SaveAs = Save &As... qui devient "En&registrer sous..." <OK parfait>

LoadError = Cannot load Source code! qui devient "Impossible de charger le fichier !"devrait être
qui devrait être= Load Error ! ou "Erreur de chargement"

MiscLoadError = Cannot load file! donc devient "Erreur de chargement"
MiscLoadError = Misc Load Error or Miscellaneous load error... ou aussi "Impossible de charger le fichier !"

Alors bien sur dans les deux cas on ne sait pas charger le fichier mais is il semble que
l'expression de l'erreur soit différente alors l'explication devrait aussi être différente

A partir de cela, je pourrais aider à traduire quelques lignes par jours, pour autant que j'ai des sources exactes des fichiers crée à disposition...
Que tu me les enverrais par "mail" et restituerais par la même voie pour que tu supervise...
Car moi, par exemple je ne suis pas spécialement un spécialiste de PB et donc pourrait me planter non pas spécialement sur la traduction littérale mais sur l'intention d'une forme d'expression complètement lié à la "fonction PB" dans un certain contexte....

Voilà, voilà.
Gerhard
comtois
Messages : 5172
Inscription : mer. 21/janv./2004 17:48
Contact :

Message par comtois »

Maintenant question... :

- Debugger.catalog et Librairies.catalog ?
N'existe pas en français ?
- Ou pas encore traduit ? Ou se sont de nouveau code d'erreur ?
Le fichier compiler.catalog est tout nouveau, depuis la 4.30.
J'imagine que pour les fichiers Debugger.catalog et Librairies.catalog ça sera pour une prochaine version ? le terrain est préparé.
J'ai quand même essayé de copier le fichier Librairies.catalog dans le répertoire Francais, j'ai modifié une ligne , et j'ai provoqué une erreur pour l'afficher , mais c'est le texte anglais qui apparait, apparemment ce fichier n'est pas encore pris en compte dans le répertoire francais. ?

En fait , je viens de finir la traduction , mais comme j'ai toujours des doutes, j'aime bien avoir une autre version pour comparer.

Notamment dans ce passage :
ExeQuitError = The debugged executable quit unexpectedly.
= Le debugger s'est arrêté anormalement
TimeoutError = The debugged executable did not respond to communication for 5 seconds. Disconnecting.
= L'executable en train d'être debugger ne répond pas depuis 5 secondes. Il se desconnecte
Je vois que tu as hésité aussi , un coup tu parles du débogueur, un coup du fichier en cours de débogage.

Finalement j'opterais bien pour le débogueur ? mais j'ai un doute ? est-ce que quelqu'un peut le lever ?
http://purebasic.developpez.com/
Je ne réponds à aucune question technique en PV, utilisez le forum, il est fait pour ça, et la réponse peut profiter à tous.
Avatar de l’utilisateur
GeBonet
Messages : 453
Inscription : ven. 29/févr./2008 16:17
Localisation : Belgique

Message par GeBonet »

Finalement j'opterais bien pour le débogueur ? mais j'ai un doute ? est-ce que quelqu'un peut le lever ?
Ben oui, obligé de parlé des deux forme... Dans le cas de "Déboguer" il est l'outil et quand on évoque le "débogage" c'est le travail qu'il fait ou à été fait... Mais en réalité déboguer ="Supprimer les bogues d'un programme (c) Larousse"... Dans ton expression ci dessous la forme exact c'est :
= Le debogage s'est arrêté anormalement...

En fait "Débogage" n'existe pas... Il n'existe que le verbe transitif "Déboguer" (ci-avant)
C'est une transposition personnelle et apparemment des "traducteurs"...
A+
Avatar de l’utilisateur
Thyphoon
Messages : 2697
Inscription : mer. 25/août/2004 6:31
Localisation : Eragny
Contact :

Message par Thyphoon »

Il y a quelques choses qui me manque, c'est le type de varible que retourne une fonction et le type de variable attendu pour une fonction
Dans l'aide il y a juste marqué :
Resultat = ElapsedMilliseconds()

alors qu'il faudrait marqué
Resultat.l = ElapsedMilliseconds()

autre exemple
Resultat = CatchImage(#Image, AdresseMemoire [, Taille [, Options])
devrait donnée
Resultat.i = CatchImage(#Image.l, AdresseMemoire.i [, Taille.l [, Options.l])

qu'en pensez vous ? en tout cas ça permettrait de savoir quoi mettre comme type de variable moi j'avoue qu'il y a des fois je ne sais pas trop ...
Avatar de l’utilisateur
GeBonet
Messages : 453
Inscription : ven. 29/févr./2008 16:17
Localisation : Belgique

Message par GeBonet »

Bonjour,
Resultat=ElapsedMilliseconds()
A mon avis il ne peut s'agir que d'entier Resultat.l déjà qu'on parle de millisecondes.
Et dans ce cas comme à chaque fois que l'on parle opération qui donne un résultat mathématique il faudrait :
- Donner un exemple concret de calcul et du résultat (dans ce cas).
- Préciser que le type (.l,.i.q,f) est à utiliser en fonction de la portée du résultat attendu.

Ce qui reviendrait au moins à lever l'ambigüité de l'expression présentée s'il y a lieu.

Ce qui est vrai d'ailleurs dans d'autres cas. Il manque dans beaucoup d'explications qui se limite quand il y a exemple à l''expression elle même et pas au moins à une relation dans un ensemble.

En gros une intégration des exemples commentés du livre de "Kale" ou il y a un nombre d'exemple plus parlant.

Ce qui me fait dire que l'aide est une aide parfaite pour qui "connait" et qui à besoin de rafraichissement de la mémoire.
Hors, on se trouve ici quand même avec PureBasic dans le cadre d'un double usage :
1- L'aide dans le sens que je viens de dire (ou espèce de Dico)
2- Dans un cadre didactique ou manuel d'apprentissage ! Et ici il est un peu faible.
Pour simplifier, il devrait y avoir une partie "Initiation" plus restreinte mais plus didactique... Cela déjà à partir de la configuration des préférences de l'IDE (ou il faut savoir de quoi on parle), et l'introduction au langage et à la programmation avec PureBasic.
Avec les instructions basics mais ayant tout les concepts de déclarations, variables, macro et procédure... (au plus simple). Les listes chainées avec des exemples concrets et la particularité de fonctionnement par rapport à un tableau... Bref pas mal de travaille.

Puis laisser le manuel tel quel... Car après avoir été initié on peut l'utiliser !

C'est d'ailleurs tellement utile que Kale a penser à créer son livre, malheureusement en anglais, qu'il l'arrête et ne le met pas à jours.

ALORS c'est compensé partiellement par le Forum. et les Tutos... Qui pour la plupart sont bien fait...

Mais Le problème des Tutos c'est de savoir ce qu'on cherche... ET un débutant ça débute par quoi ? Et ça cherche quoi... ?
Qu'elles sont les relations entre la fonction machin et la chose cherchée ?
Voilà, excusez moi, mais je profite de ta question pour étendre la question au problème complet de la documentation !
Bien à vous !
comtois
Messages : 5172
Inscription : mer. 21/janv./2004 17:48
Contact :

Message par comtois »

Thyphoon a écrit :Il y a quelques choses qui me manque, c'est le type de varible que retourne une fonction et le type de variable attendu pour une fonction
Dans l'aide il y a juste marqué :
Resultat = ElapsedMilliseconds()

alors qu'il faudrait marqué
Resultat.l = ElapsedMilliseconds()

autre exemple
Resultat = CatchImage(#Image, AdresseMemoire [, Taille [, Options])
devrait donnée
Resultat.i = CatchImage(#Image.l, AdresseMemoire.i [, Taille.l [, Options.l])

qu'en pensez vous ? en tout cas ça permettrait de savoir quoi mettre comme type de variable moi j'avoue qu'il y a des fois je ne sais pas trop ...
C'est précisé dans l'aide, dans le chapitre 'Règles de syntaxe générales'
La valeur retournée par les commandes est le plus souvent un Integer. Dans le cas contraire, le type de la valeur est indiqué dans la description (ligne de syntaxe) de la commande.
Et comme le type par défaut, c'est le type integer, donc si tu ne précises rien, c'est bon :)
http://purebasic.developpez.com/
Je ne réponds à aucune question technique en PV, utilisez le forum, il est fait pour ça, et la réponse peut profiter à tous.
Avatar de l’utilisateur
MetalOS
Messages : 1492
Inscription : mar. 20/juin/2006 22:17
Localisation : Lorraine
Contact :

Message par MetalOS »

Salut tous le monde, je voulais juste signaler que dans la doc il manquait l'exemple sur l'utilisation des Gadget3D. Savez vous ou il à possibilité de trouver cet exemple ou si une mise à jour du fichier d'aide est bientôt prévue. Merci.
comtois
Messages : 5172
Inscription : mer. 21/janv./2004 17:48
Contact :

Message par comtois »

MetalOS a écrit :Salut tous le monde, je voulais juste signaler que dans la doc il manquait l'exemple sur l'utilisation des Gadget3D. Savez vous ou il à possibilité de trouver cet exemple ou si une mise à jour du fichier d'aide est bientôt prévue. Merci.
l'exemple et les fichiers qui vont bien se trouve dans cette archive

http://www.purebasic.com/Ogre1.6.zip
http://purebasic.developpez.com/
Je ne réponds à aucune question technique en PV, utilisez le forum, il est fait pour ça, et la réponse peut profiter à tous.
Avatar de l’utilisateur
GeBonet
Messages : 453
Inscription : ven. 29/févr./2008 16:17
Localisation : Belgique

Message par GeBonet »

Salut,

J'ai vu que tu participais à la traduction du livre de Kale... C'est peut-être aussi par là que tu devrais te rendre..
Chapitre 10 pour la 2D et 11 pour la 3D c'est évidement des intro...
Mais avec exemples et ça ferait peut-être pour toi d'une pierre deux coup :lol:

Enfin, c'est simplement une idée :?
Bonne nuit..
Répondre