Liberty BASIC Community Forum
« Searchable LB Helpfiles »

Welcome Guest. Please Login or Register.
Jul 26th, 2017, 05:53am


Rules|Home|Help|Search|Recent Posts|Notification


« Previous Topic | Next Topic »
Pages: 1  Notify Send Topic Print
 sticky  Author  Topic: Searchable LB Helpfiles  (Read 1279 times)
Alyce Watson
Administrator
ImageImageImageImageImage


member is offline

Avatar




Homepage PM

Gender: Female
Posts: 14915
thumbup Searchable LB Helpfiles
« Thread started on: May 9th, 2015, 09:44am »

When Liberty BASIC changed to HTML help, we lost the ability to search the help system. There are two ways to solve this problem.

First, note that Carl Gundel of Shoptalk Systems reserves the right to distribute the help files. Nobody else may do so.

CHM help is compiled HTML help. It is searchable. The LB help files can be compiled to a single CHM file. Since users cannot distribute such a file, each user must compile it himself. I have created a tool that allows you to compile the LB HTML help. It is in tokenized form and will run from LB4.04. The zip also contains a shortcut.dll. When you run this program you may select options to create shortcuts, keep or delete temporary files, and view the log. You must have Microsoft's HTML Help Workshop on your system. It already exists on my Windows 8.1 computer, so I did not need to download it. A download link is provided on the webpage should you need it.

Liberty BASIC Help CHM Creator

----

There is another way to allow searching in the HTML help system. This forum ran a contest a few years ago to create a search tool. Several fine entries are available. Stefan Pendl's entry won the contest. These entries are written in LB, so you can see exactly how they work and even modify one as you wish.

Help Search Contest Entries
User IP Logged

Alyce
Liberty BASIC Workshop - a complete IDE for Liberty BASIC


Alyce's Restaurant
for Liberty BASIC code, tools and references
Alyce Watson
Administrator
ImageImageImageImageImage


member is offline

Avatar




Homepage PM

Gender: Female
Posts: 14915
thumbup Re: Searchable LB Helpfiles
« Reply #1 on: May 15th, 2015, 06:36am »

I'm surprised to see no responses to this thread. Have any newer LB users tried any of the help search tools? I think some of them are really good. I also think they show off some of the neat features of LB itself. It's always fun to write tools for your favorite language IN your favorite language. wink


edit: the thread was accidentally locked, so of course there were no responses!
« Last Edit: May 15th, 2015, 06:37am by Alyce Watson » User IP Logged

Alyce
Liberty BASIC Workshop - a complete IDE for Liberty BASIC


Alyce's Restaurant
for Liberty BASIC code, tools and references
mmiscool
Team Liberty BASIC


member is offline

Avatar



AIM
Homepage PM

Gender: Male
Posts: 225
thumbup Re: Searchable LB Helpfiles
« Reply #2 on: May 15th, 2015, 9:00pm »

Personally when I need to search the help files I use google.

If you put in to the query string "listbox site:www.libertybasicuniversity.com" google will search that site and that site alone for in this example "listbox"

Its pretty great as the help files and the lb news letters are located on that site. A very easy way to query only liberty basic content.
User IP Logged

http://mmiscool.com
http://esp8266basic.com
http://smbisoft.com
tooanalytical


member is offline

Avatar




PM


Posts: 1161
thumbup Re: Searchable LB Helpfiles
« Reply #3 on: May 15th, 2015, 10:37pm »

mmiscool,
That site is amazing. I never knew that the old newsletters were there. Many other items on the site, too.

As great as that site is, still the point of the topic was about making LB helpfiles. The original posting can be a re-start for promoting the HELP CHM Creator and and the contest entries for creating help files for Liberty BASIC.
User IP Logged

tooanalytical


member is offline

Avatar




PM


Posts: 1161
xx Re: Searchable LB Helpfiles
« Reply #4 on: May 15th, 2015, 10:41pm »

on May 9th, 2015, 09:44am, Alyce Watson wrote:
When Liberty BASIC changed to HTML help, we lost the ability to search the help system. There are two ways to solve this problem.

First, note that Carl Gundel of Shoptalk Systems reserves the right to distribute the help files. Nobody else may do so.

CHM help is compiled HTML help. It is searchable. The LB help files can be compiled to a single CHM file. Since users cannot distribute such a file, each user must compile it himself. I have created a tool that allows you to compile the LB HTML help. It is in tokenized form and will run from LB4.04. The zip also contains a shortcut.dll. When you run this program you may select options to create shortcuts, keep or delete temporary files, and view the log. You must have Microsoft's HTML Help Workshop on your system. It already exists on my Windows 8.1 computer, so I did not need to download it. A download link is provided on the webpage should you need it.

Liberty BASIC Help CHM Creator

----

There is another way to allow searching in the HTML help system. This forum ran a contest a few years ago to create a search tool. Several fine entries are available. Stefan Pendl's entry won the contest. These entries are written in LB, so you can see exactly how they work and even modify one as you wish.

Help Search Contest Entries


Maybe more wiki entries about it? Maybe short tutorials and small projects, or series of tutorials and related small projects?
User IP Logged

Alyce Watson
Administrator
ImageImageImageImageImage


member is offline

Avatar




Homepage PM

Gender: Female
Posts: 14915
xx Re: Searchable LB Helpfiles
« Reply #5 on: Sep 2nd, 2015, 11:08am »

UPDATED FOR Liberty BASIC 4.5.0, September, 2015
CHM help is compiled HTML help. It is searchable. The LB help files can be compiled to a single CHM file. Since users cannot distribute such a file, each user must compile it himself. I have created a tool that allows you to compile the LB HTML help. It is in tokenized form and will run from LB4.5.0. The zip also contains a shortcut.dll. When you run this program you may select options to create shortcuts, keep or delete temporary files, and view the log. You must have Microsoft's HTML Help Workshop on your system. It already exists on my Windows 8.1 computer, so I did not need to download it. A download link is provided on the webpage should you need it.

Liberty BASIC Help CHM Creator

User IP Logged

Alyce
Liberty BASIC Workshop - a complete IDE for Liberty BASIC


Alyce's Restaurant
for Liberty BASIC code, tools and references
michael
Guest
thumbup Re: Searchable LB Helpfiles
« Reply #6 on: Sep 2nd, 2015, 9:07pm »

I have used the help files for reference at times considering I always have to carry notes to help me code effectively. I focused on programming to help my memory.
It is a hobby also. Its good exercise for the mind. I have also used the search engine in this forum after you mentioned that you used it when helping others.
Practice makes perfect.
Your concerns are important. We should try to remind people to use the search engines.

« Last Edit: Sep 2nd, 2015, 9:10pm by michael » User IP Logged

hooshnik
Full Member
ImageImageImage


member is offline

Avatar




PM

Gender: Male
Posts: 105
thumbup Re: Searchable LB Helpfiles
« Reply #7 on: Sep 21st, 2015, 5:40pm »

Just a note for those using wine / playonlinux on debian jessie to run Stephan's LB help add-on. I kept getting a general protection fault protection violation after running it using a generic prefix using the system wine version (1.6.2). I told it to use the latest staging release 1.7.51-staging and now not only does it not crash but an old bug with not saving the radio button settings is fixed. Freeform and lbworkshop seem to work fine sharing the same prefix.

If you are using playonlinux goto tools -> manage wine versions and add a new x86 version (there are many). Then configure the prefix to use that version. The staging versions are supposed to have more fixes.
« Last Edit: Sep 23rd, 2015, 08:55am by hooshnik » User IP Logged

looking for file "include" support? Check out Aplomb Scribe http://libertybasic.conforums.com/index.cgi?action=display&board=open&num=1434746448
hooshnik
Full Member
ImageImageImage


member is offline

Avatar




PM

Gender: Male
Posts: 105
thumbup Re: Searchable LB Helpfiles
« Reply #8 on: Sep 23rd, 2015, 08:58am »


I had to enable the virtual desktop option in the graphics tab of the main configuration in order to stop it from crashing on minimize and resize even with the new version. Learned more about wine with LB programs with this exercise but going the chm route with a viewer would have been better.

Anybody know how to get radio buttons to save?
User IP Logged

looking for file "include" support? Check out Aplomb Scribe http://libertybasic.conforums.com/index.cgi?action=display&board=open&num=1434746448
JohnnyD
Guru
ImageImageImageImageImage


member is offline

Avatar

"If something should, then it doesn't, isn't, can't, hasn't or won't"


Homepage PM

Gender: Male
Posts: 759
thumbup Re: Searchable LB Helpfiles
« Reply #9 on: Sep 23rd, 2015, 10:28am »

Hi all,

I just tried this and although it appears to create the file, it will list the topics on the left but the right hand pane remains blank, no matter which topic I click on.

JohnnyD
User IP Logged

Alyce Watson
Administrator
ImageImageImageImageImage


member is offline

Avatar




Homepage PM

Gender: Female
Posts: 14915
xx Re: Searchable LB Helpfiles
« Reply #10 on: Sep 23rd, 2015, 12:52pm »

on Sep 23rd, 2015, 10:28am, JohnnyD wrote:
Hi all,

I just tried this and although it appears to create the file, it will list the topics on the left but the right hand pane remains blank, no matter which topic I click on.

JohnnyD


Hooshnik appears to be addressing Stefan's code. Which solution gives you this problem, JohhnyD?
User IP Logged

Alyce
Liberty BASIC Workshop - a complete IDE for Liberty BASIC


Alyce's Restaurant
for Liberty BASIC code, tools and references
Pages: 1  Notify Send Topic Print
« Previous Topic | Next Topic »

Rules|Home|Help|Search|Recent Posts|Notification

Donate $6.99 for 50,000 Ad-Free Pageviews!

| |

This forum powered for FREE by Conforums ©
Sign up for your own Free Message Board today!
Terms of Service | Privacy Policy | Conforums Support | Parental Controls