[AIDE PUREBASIC] Mises à jour.

Ar-S · Message par **Ar-S** » jeu. 02/avr./2020 9:53

Mesa a écrit : Je sais que Fred fait attention à ce que l'aide soit la plus "petite" possible pour ne pas alourdir son install, c'est peut-être pour ça...

Sûrement même mais bon..

Marc56 · Message par **Marc56** » jeu. 02/avr./2020 10:20

Pour passez le temps, voici comment moderniser l'aide de PB (juste un coup de peinture)

en attendant.
Objectif: remplacer le fond jaune "Windows 3.1" par du blanc et remplacer la fonte courier par Consola (les exemples, en monospace)

Edit 03/04/20: Suivez le tuto de Mesa qui explique bien mieux !

Personnaliser l'aide de Purebasic

Note: ceci n'est pas destructif pour votre installation PB ni pour Windows.

Outils:
- HTML Help Workshop v1.3 (à télécharger chez Microsoft.) Wikipedia
- Un outil capable de faire des recherche/remplacer dans un tas de fichier texte

Décompilez le fichier d'aide .CHM vers un répertoire

Code : Tout sélectionner

hh -decompile HelpPB572New\ PureBasic.chm

Effectuez les remplacement dans le code HTML de toutes les pages

Code : Tout sélectionner

--- Fond jaune par fond blanc
Chercher:
<body bgcolor="#FFFFDF"
Remplacer par:
<body bgcolor="#FFFFFF"

(2113 matches in 2113 files)

Fonte des exemples (Courier New par Consolas)
Chercher:
<font face="Courier New
Remplacer par:
<font face="Consolas

(2090 matches in 1328 files)

Recompilez
- Lancez Html Help Workshop
- File > New > Project
- Suivant
- Allez dans le répertoire où sont les répertoires et fichiers (ainsi que "Index.hhk" et "Table of Contents.hhc")
- Donnez un nom de projet (ex: PBHelp .hhp)
- Suivant
- Cochez les deux premières cases (.hhc et .hhk)
- Suivant
- Spécifiez les fichiers (ils sont dans le répertoire, en bas)
- Terminer
- Cliquez sur la troisième icône (compile Help File) ou File > Compile
- Validez
Si tout ce passe bien, après quelques secondes vous avez un message du type

Code : Tout sélectionner

Microsoft HTML Help Compiler 4.74.8702
Compiling d:\Help\HelpPB572\HelpNew.chm
Compile time: 0 minutes, 4 seconds
2,124	Topics
24,119	Local links
111	Internet links
286	Graphics
Created d:\Help\HelpPB572\HelpNew.chm, 4,014,025 bytes
Compression decreased file by 7,694,375 bytes.

Quittez

Vous pouvez le tester
(La première page donnera une erreur la première fois, mais est ok ensuite)

Pour l'intégrer à PB
Fermer PB si ouvert
Renommez PureBasic.chm en autre chose
Copiez votre .chm en PureBasic.chm

Et voilà

J'ai essayé de procéder de même pour changer le texte (mettre Verdana), mais les tableaux ont aussi des définition de fontes et pas aux bons endroits. Si vous êtes habitué au html, il est possible de moderniser l'ensemble des pages en mettant une feuille de style, ce qui éviterait de modifier toutes les pages. En attendant peut-être un jour une modernisation officielle quand l'équipe aura du temps.

Zorro · Message par **Zorro** » ven. 03/avr./2020 8:20

attention toutefois a la tentation de vouloir changer l'ordre des rubriques
voir a la creation de rubriques nouvelles ...

les editeurs se fient a l'organisation actuelle de l'aide pour ouvrir la bonne page lorsqu'on surligne un mot
mais si vous changez l'ordre alors ça ne marchera plus ....

donc un conseil, ne réorganisez pas les rubriques de l'aide

Marc56 · Message par **Marc56** » ven. 03/avr./2020 9:10

Hello,

Pour ceux qui voudraient essayer la version modernisée mais n'auraient pas la patience de faire toute les manipulations, j'ai mis une version en téléchargement avec page d'explication (lisez la page jusqu'en bas avant de signaler un bug svp)

Rien n'est destructif: renommez votre ancien PureBasic.chm en autre chose et mettez celui-ci à la place en le renommant en PureBasic.chm

PS. Liens des rubriques déplacées sont bien connectés, j'ai vérifié (Merci à Zorro d'avoir indiqué ce possible problème). Mesa a bien fait le boulot, ou alors la TOC (Table Of Contents) fait le lien toute seule ?

Mesa · Message par **Mesa** » ven. 03/avr./2020 10:18

J'ai fait un tuto en 2011.
https://www.purebasic.fr/french/viewtop ... 21&t=12392

En fait, il n'y a aucun problème sauf si on change l'organisation car dans ce cas il faut aussi mettre à jour les fichiers Index.hhk" et "Table of Contents.hhc" qui contiennent tous les liens. Le "PureBasic.hhp" contient le lien de la page à afficher au démarrage du chm.

Je ne vois pas ce que "les" éditeurs viennent faire ici ??? car s'ils sont bien programmés alors ils utilisent soit le chm soit la "Table of Contents.hhc".

Attention html workshop est gavé de bugs et plante tout le temps.

M.

Marc56 · Message par **Marc56** » ven. 03/avr./2020 13:38

Merci Mesa, c'est donc bien plus simple que mon explication

(j'aurais dû chercher sur le forum avant

)
En plus avec ton .hhp je n'ai pas le bug de la première page qui s'affichait mal.

Ça va me permettre de faire un batch de mise à jour automatique maintenant que tu montre qu'on peut aussi recompiler en ligne de commandes.

J'en ai profité pour refaire une nouvelle version, dans laquelle je change aussi la fonte par défaut (Arial / Verdana)

Pour ceux qui voudraient bricoler, voici les 4 chercher/remplacer à faire dans l'ensemble des fichiers (~2000 fichiers)
Vous pouvez utiliser la fonction Rechercher dans les sous-dossiers de Notepad++ (CTRL+MAJ+F) qui fera ça en quelques secondes.

Code : Tout sélectionner

--- Fond
<body bgcolor="#FFFFDF"
<body bgcolor="#FFFFFF"

--- Fontes des exemples (monospace)
<font face="Courier New
<font face="Consolas

--- Fontes du texte normal
<font face="Arial"
<font face="Verdana"

--- Fontes du texte dans les tableaux
font-family:Arial
font-family:Verdana

La nouvelle version est à télécharger ici

Micoute · Message par **Micoute** » ven. 03/avr./2020 15:54

Merci Marc56 pour ce partage, au moins ça change, j'aime bien.

Shadow · Message par **Shadow** » ven. 03/avr./2020 19:42

Est ce que toutes les petite coquille et soucis qui ont été listé ici sont corrigés ?
Pourquoi je n'est pas la section World3D dans l'aide ?

Marc56 · Message par **Marc56** » sam. 04/avr./2020 6:48

Shadow a écrit :Est ce que toutes les petite coquille et soucis qui ont été listé ici sont corrigés ?

Je n'ai rien changé dans le texte, juste la mise en forme (couleurs et fontes uniquement).

Shadow a écrit :Pourquoi je n'ai pas la section World3D dans l'aide ?

Elle y est.
(Les noms de sections suffixés par un '+' sont à ouvrir. C'est aussi le principe de cette version classée par Mesa)

Shadow · Message par **Shadow** » sam. 04/avr./2020 14:10

Mais alors ça sert a quoi tous ça si rien n'est corrigé ?
Pourtant ya écris mise a jour, je pensais que les coquilles et tous était régler non ?
Ou est l'aide mise ajour et corrigé ?

Merci oui j'ai bien la section mais ils erais bien de faire un lien sur la page ou ya tous les lien (manuel).

Marc56 · Message par **Marc56** » dim. 05/avr./2020 8:17

Shadow a écrit :Mais alors ça sert a quoi tous ça si rien n'est corrigé ?

Tu n'a rien lu (comme d'habitude

)
Dans le fichier d'aide (chm), les coquilles sont corrigées.
Exemple avec une que j'avais signalé
https://www.purebasic.fr/french/viewtop ... 31#p206231

Par contre elle ne l'est pas dans l'aide en ligne, mais là je pense que seul Fred à l'accès.
https://www.purebasic.com/french/docume ... ember.html

Ce serait bien de supprimer l'ancienne version SVN de l'aide (plus mis à jour depuis 5.46) et mettre la nouvelle sur GitHub par exemple pour que chacun puisse proposer directement les corrections et compiler éventuellement sa version.
https://www.purebasic.fr/french/viewtop ... 22#p202222

Ollivier · Message par **Ollivier** » mar. 14/avr./2020 10:25

Sanut Mesa,

meilleurs voeux, dans la page FileSeek(), on devrait préciser la base 0 ou 1 de la position.

Position 0 : 1er octet
Position 1 : 2ème octet
Etc...

Cordialement

Naheulf · Message par **Naheulf** » jeu. 28/mai/2020 23:42

Bonjour ! Je viens de voir quelques corrections à apporter pour la gestion des adresses IPv6 :

IPAddressField()
Argument Champ :

Le champ à renvoyer, numéroté de gauche à droite.

Cette valeur doit être comprise :
entre 0 et 3 pour les adresses IPv4.

entre 0 et 7 pour les adresses IPv6.

Valeur de retour :

Renvoie la valeur du champ spécifié :
de 0 à 255 pour les adresses IPv4.

de $0000 à $FFFF pour les adresses IPv6.

(J'ai volontairement mis de l'hexadécimal pour IPv6 car ça correspond à la représentation "normale" de ces adresses.)

IPAddressGadget()
Pour l'instant j'ai l'impression que ce gadget ne supporte juste PAS les adresses IPv6.
Au choix :

soit ça ne supporte réellement pas les IPv6 : dans ce cas, il faudrait demander à Fred de corriger ça (probablement en ajoutant un champ "Flag" optionnel qui prendrait #PB_Network_IPv4 (par défaut) ou #PB_Network_IPv6 en paramètre). Puis ajouter actualiser l'aide en fonction.
soit les IPv6 sont actuellement supportées : dans ce cas, il faudrait ajouter un exemple à l'aide et me répondre.

MakeIPAddresse()
Argument Champ0, Champ1, Champ2, Champ3

Les différents champs de l'adresse.
Chaque champ a une valeur qui doit être comprise :
entre 0 et 255 pour les adresses IPv4.
entre $0000 et $FFFF pour les adresses IPv6.

(J'ai volontairement mis de l'hexadécimal pour IPv6 car ça correspond à la représentation "normale" de ces adresses.)

Argument Champ4, Champ5, Champ6, Champ7 (optionnels)

...
Chaque champ a une valeur qui doit être comprise entre $0000 et $FFFF.

...

(J'ai volontairement mis de l'hexadécimal pour IPv6 car ça correspond à la représentation "normale" de ces adresses.)

Guillot · Message par **Guillot** » ven. 29/mai/2020 16:34

salut tout le monde,

quelqu'un peux me dire pourquoi c'est pas cette version de la doc qui est distribuer par défault avec PB
qu'on utilise ou pas la 3D, c'est toujours mieux d'avoir le contenu hierachisé, les recherches sont plus rapides

(j'ai pas envie de lire les 17 pages...)

Mesa · Message par **Mesa** » sam. 30/mai/2020 9:44

Apparement le gadget ipaddress ne prend pas en charge l'ipv6, ça sera noté dans l'aide.

En attendant, vous pouvez créez votre prope gadget avec le canvas...

Une petite procedure:

Code : Tout sélectionner

Procedure.s IPStringV6(IP)
  Protected tmp$
  For i=0 To 15 Step 2
    tmp$=tmp$+RSet(Hex(PeekB(IP+i),#PB_Byte),2,"0")+
         RSet(Hex(PeekB(IP+i+1),#PB_Byte),2,"0")+":"
  Next i
  ProcedureReturn Mid(tmp$,1,Len(tmp$)-1)  
EndProcedure

IP = MakeIPAddress($0123, $4567, $89ab, $cdef, $fedc, $ba98, $7654, $3210) ; Crée une IPv6 
Debug IPStringV6(IP)

M.

PureBasic

[AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.

Re: [AIDE PUREBASIC] Mises à jour.