PureHELP Maker : fast help builder for userlibraries

ABBKlaus · **Posted:** Tue Jan 16, 2007 1:13 am

Hi Gnozal,

i have another request :twisted:

sorting of Topics (without the user topics/Index/License ?)

Regards Klaus

NoahPhense · **Posted:** Tue Jan 16, 2007 4:03 am

Flype wrote:

thank a lot gnozal. that's a great tool.

yeah it is.. nice work

- np

gnozal · **Posted:** Tue Jan 16, 2007 8:39 am

ABBKlaus wrote:

Hi Gnozal,

i have another request :twisted:

sorting of Topics (without the user topics/Index/License ?)

Regards Klaus

You mean sort the functions ? A manual sort is already possible : you can move a function topic up/down with the [up]/[down] keys. The order is not changed when you update the library, the new functions will be added at the end of the functions list. So you only have to do it once.

eddy · **Posted:** Sat Sep 08, 2007 5:22 pm

hi,

I have some feature request

1 - Can you add a splitterbar to resize Example / Description sections ?
( or a tabber to switch between Example / Description sections )
2 - color tag :
<pb></pb> -----> #006666
<const></const> -----> #924B72

Actually I use CSS hack :

Code:

<style type='text/css'>u { color:#924B72;text-decoration:none }; i { color:#009999;text-decoration:none;font-style:normal }</style>

gnozal · **Posted:** Tue Oct 23, 2007 8:55 am

Update

Changes :
- updated PB folder detection for PB4.10 beta 4

maadjordan · **Joined:** Tue Oct 09, 2007 8:00 am **Posts:** 2

"gnozal" did you read my post at end here
http://www.purebasic.fr/english/viewtop ... c&start=15

at is a way i use to reduce CHM file size..

i'd like to hear your view

for example i've tested my techniques to your CHM file inside purehelp zip file and i reached

PureHELPMaker.chm
original reduced %
105,406 bytes 40,550 bytes 38.47

you can get it here and test it yourself

http://rapidshare.com/files/65709279/pu ... r.zip.html

gnozal · **Posted:** Mon Oct 29, 2007 9:13 am

maadjordan wrote:

"gnozal" did you read my post at end here
http://www.purebasic.fr/english/viewtop ... c&start=15

at is a way i use to reduce CHM file size..

i'd like to hear your view

My opinion : your post is interesting, but :

maadjordan wrote:

1- optimize HTML by removing comments and other non-viewable ref.

PureHelpMaker does not generate any comments or non-viewable html code

maadjordan wrote:

2- optimize GIF files with Trout's GIF Optmizer.
3- optimize PNG files with optipng,advpng,advdef,pngout,deflopt
4- optimize jpeg files with "jpegoptim"

It's your responsability to add optimized images to the help file, PureHelpMaker does not (and probably never will) do any image optimization.
Remember it's just a tool to easily create help files for user libraries, nothing more.
If you want more features, have a look at Vizacc : http://www.vizacc.com/

Update

Changes :
- minor UI fixes
- PureHelpMaker now remembers the last project directory

gnozal · **Posted:** Mon May 17, 2010 4:50 pm

Update (version 1.03)

Changes :
- new icon
- new feature : you may now add a user index (right-click on topic list, like for a user topic)
Thanks LSI (french forum) for this feature (and the icon

).

Le Soldat Inconnu · **Posted:** Tue May 18, 2010 4:12 pm

I Add this changes too

- Correction of HTML code generated
- Correction of some small bugs (like add extension automatically on save)

Le Soldat Inconnu · **Posted:** Sat Jun 19, 2010 6:07 pm

Gnozal, i do small mistake

before

Code:

Procedure.l CreateFunctionHelpFile(Filename.s)
  Protected Description.s, Example.s, Overview.s, Stream.l, ReturnValue.l, ListIconText.s, UserIndexOpen.l
  Stream = CreateFile(#PB_Any, Filename)
  If Stream
    Overview = HTMLHelpFiles()\SyntaxOrOverview
    Description = HTMLHelpFiles()\Description
    Example = HTMLHelpFiles()\Example
    WriteStringN("<html><head><title>" + HTMLHelpFiles()\PageTitle + "</title><meta name= " + #g + "GENERATOR" + #g + "content=" + #g + "PureHELP Maker (c) gnozal" + #g + "></HEAD>")
    WriteStringN("<body bgcolor=" + #g + "#FFFFDF" + #g + " link=" + #g + "#009999" + #g + " vlink=" + #g + "#006666" + #g + " alink=" + #g + "#006666" + #g + ">")
    WriteStringN("<font face=" + #g + "Arial" + #g + " size=" + #g + "2" + #g + "><p align=" + #g + "center" + #g + "><b><font size=" + #g + "4" + #g + ">" + HTMLHelpFiles()\PageTitle + " </Font></b></p>")
    If HTMLHelpFiles()\UserPage
      WriteStringN("<blockquote><font face=" + #g + "Arial" + #g + "size=" + #g + "2" + #g + ">")
      Description = ReplaceString(Description, #CRLF, "<br>" + #CRLF)
      WriteStringN(Description)
      WriteStringN("</font></blockquote>")
    ElseIf HTMLHelpFiles()\UserIndex
      If Overview
        WriteStringN("<p><b>"+ Language_Overview + "</b></p>")
        Overview = ReplaceString(Overview, #CRLF, "<br>" + #CRLF)
        WriteStringN(Overview)
        WriteStringN("<Font></blockquote>")
      EndIf

on last WriteStringN("<Font></blockquote>"), there is <Font> and you have to remove it

after

Code:

Procedure.l CreateFunctionHelpFile(Filename.s)
  Protected Description.s, Example.s, Overview.s, Stream.l, ReturnValue.l, ListIconText.s, UserIndexOpen.l
  Stream = CreateFile(#PB_Any, Filename)
  If Stream
    Overview = HTMLHelpFiles()\SyntaxOrOverview
    Description = HTMLHelpFiles()\Description
    Example = HTMLHelpFiles()\Example
    WriteStringN("<html><head><title>" + HTMLHelpFiles()\PageTitle + "</title><meta name= " + #g + "GENERATOR" + #g + "content=" + #g + "PureHELP Maker (c) gnozal" + #g + "></HEAD>")
    WriteStringN("<body bgcolor=" + #g + "#FFFFDF" + #g + " link=" + #g + "#009999" + #g + " vlink=" + #g + "#006666" + #g + " alink=" + #g + "#006666" + #g + ">")
    WriteStringN("<font face=" + #g + "Arial" + #g + " size=" + #g + "2" + #g + "><p align=" + #g + "center" + #g + "><b><font size=" + #g + "4" + #g + ">" + HTMLHelpFiles()\PageTitle + " </Font></b></p>")
    If HTMLHelpFiles()\UserPage
      WriteStringN("<blockquote><font face=" + #g + "Arial" + #g + "size=" + #g + "2" + #g + ">")
      Description = ReplaceString(Description, #CRLF, "<br>" + #CRLF)
      WriteStringN(Description)
      WriteStringN("</font></blockquote>")
    ElseIf HTMLHelpFiles()\UserIndex
      If Overview
        WriteStringN("<p><b>"+ Language_Overview + "</b></p>")
        Overview = ReplaceString(Overview, #CRLF, "<br>" + #CRLF)
        WriteStringN(Overview)
        WriteStringN("</blockquote>")
      EndIf

Sorry

Le Soldat Inconnu · **Posted:** Sat Jun 19, 2010 10:54 pm

and again one on line 946, i had system to add link on function but i forgot to add () after function name to search function.

en gros, j'ai zappé les () lors de la recherche des noms de fonction et du coup avec des fonctions du style CreateSkinWindow et CreateSkinWindowError, ça ne marche pas car je détecte CreateSkinWindow dans CreateSkinWindowError

Code:

Description = ReplaceString(Description, HTMLHelpFiles()\FunctionName + "()", "<a href=" + #g + HTMLHelpFiles()\FunctionName + ".html" + #g + ">" + HTMLHelpFiles()\FunctionName + "()</a>")

gnozal · **Posted:** Tue Jun 22, 2010 10:07 am

Le Soldat Inconnu wrote:

and again one on line 946, i had system to add link on function but i forgot to add () after function name to search function.

en gros, j'ai zappé les () lors de la recherche des noms de fonction et du coup avec des fonctions du style CreateSkinWindow et CreateSkinWindowError, ça ne marche pas car je détecte CreateSkinWindow dans CreateSkinWindowError

Code:

Description = ReplaceString(Description, HTMLHelpFiles()\FunctionName + "()", "<a href=" + #g + HTMLHelpFiles()\FunctionName + ".html" + #g + ">" + HTMLHelpFiles()\FunctionName + "()</a>")

Il me semble l'avoir corrigé dans la version disponible sur mon site ?
(I think it's already fixed ?)

Le Soldat Inconnu · **Posted:** Wed Jun 23, 2010 9:11 pm

Aucune idée, je tourne la version que j'ai compilé :mrgreen:

Et pour le </Font> en trop ?

gnozal · **Posted:** Thu Jun 24, 2010 7:33 am

Le Soldat Inconnu wrote:

Aucune idée, je tourne la version que j'ai compilé :mrgreen:

Et pour le </Font> en trop ?

Je ne me souviens plus trop... Je n'ai pas le code sous la main.
J'ai fait quelques modifications dans la source avant de la compiler.

Et j'ai recompilé quelques CHM sans problèmes.

gnozal · **Posted:** Sat May 21, 2011 8:44 am

Update (version 1.04)

Changes :
- some minor bug fixes
- added 'multi-library' support
For example, PureCOLOR has 3 libs : PureCOLOR, PureCOLOR-Buttons, PureCOLOR-Menu.
Simply select 'PureCOLOR', PureHELP Maker will detect the other two libraries to generate a unique help file.

PureBasic Forum

PureHELP Maker : fast help builder for userlibraries

Who is online