site  contact  subhomenews

Easy Help overhauled

August 08, 2017 — BarryK
In Quirky, and all pups, there is a "Help" entry in the menu, clicking on which launches the web browser and brings up a local web page, /usr/share/doc/index.html

I have overhauled the help mechanism. index.html has javascript in it, which HelpSurfer cannot handle.

help.sh
index.html is now removed, and clicking "Help" in the menu runs /usr/share/doc/easy/help.sh, which launches a language-translated file 'help.htm' in HelpSurfer.
This has to work without being online, so there are translations of major languages for help.htm, in /usr/share/doc/easy.

welcome.sh
This replaces 'welcome1stboot' and launches a translated 'welcome.htm'. Again, has to work offline.

doc-launcher.sh
index.html had pull-down menus to select a package, application or utility, and launch local or online help. That uses javascript, so there is now a script, /usr/sbin/doc-launcher.sh.
help.htm has a link to launch doc-launcher.

There has been a major cleanup of /usr/share/doc, old help files thrown out. Much of it is better suited to be online.

Comments

The default homepage of the web browser, at least for my SeaMonkey PETs, is /usr/share/doc/home.htm. This has links to sites, such as the Puppy Forum.

I have replaced the content of /usr/share/doc/home.htm with a single <meta> tag, that redirects to a translated home.htm inside /usr/share/doc/easy.

When a locale is chosen in QuickSetup (/usr/sbin/quicksetup), it modifies /usr/share/doc/home.htm to redirect to the correct translation, if one exists.

Of course, google can be used to dynamically translate web pages, however, home.htm has to work offline.

So, locally, there are welcome.htm, help.htm and home.htm translated pages. One useful outcome is that online hyperlinks in these pages will also be automatically translated.
Hence, my online website can be in English only, and google will render it in any desired language.

Tags: linux