site  contact  subhomenews

MoManager: documentation files

February 24, 2012 — BarryK
Continuing to enhance MoManager to be a one-stop-shop for language translation of everything in Puppy, I have added management of documentation files.

Forum member esmourguit, who is working on a 'fr' langpack, was wondering how to handle /usr/local/petget/help.htm. This is a help file for Puppy Package Manager.

An application usually has help or other doc files with naming to identify the language, for example 'help.htm', 'help-de.htm', 'help-fr.htm', etc.

So, I have modified /usr/local/petget/ui_Classic and ui_Ziggy to use a translation file if it exists, for example 'help-fr.htm'. In fact, I have put 'help-fr.htm' into Woof as esmourguit has already created it and it is a good example.

Translation of such documentation files is now handled by MoManager via /usr/share/sss/doc_strings/doc_strings -- the easiest way to understand it would be to look at that file.

The end result is that it is now in MoManager, you choose 'doc_strings' and click 'Edit' or 'Create', and an appropriate editor will open with the file to be translated -- in the case of HTML files, the 'defaulthtmleditor' is used, which is usually Composer.

Currently only the PPM help file is being managed by MoManager. I will have to identify other help files and add them to /usr/share/sss/doc_strings/doc_strings.

To see the details, and grab the latest files if you want, here is the Woof commit:


PPM help

Doc translations
Username: BarryK
"I have significantly enhanced MoManager to manage [i]all[/i] documentation files in Puppy, at least, those that are from Woof. It is a fairly simple process of sequencing through them via the GUI. I have worked out how files such as home.htm can be in a langpack, but it required modifications to Woof. Will announce details soon, after I have tested it.

3builddisto bug
Username: 01micko
"@line 2130 this works, whereas the old errored: [code]cp -rf rootfs-complete/usr/share/doc/nls/* devx/usr/share/doc/nls/ rm -r rootfs-complete/usr/share/doc/nls[/code]

re 3builddistro bug
Username: BarryK
"Thanks, fixed.

3builddistro bug 2
Username: 01micko
"@line 2085 you have $KMSFLAG ... should be: [code] case $KMSFLG in[/code] I was wondering why there was no entry when I flipped!

Username: BarryK
"Thanks again!

MoManager working
Username: BarryK
"I have done a test build, MoManager is now handling all of the documentations files, works well. I fixed a few bugs, various enhancements to MoManager, fixed a bug with desktop icons going back to English when the SFS layers change. It is fairly late here, 10pm, will relax now and will do another build in the morning, a sanity check, then will upload latest Woof. Wary/Racy beta2 should also be coming tomorrow.

desktop icons
Username: rodin.s
"[i]fixed a bug with desktop icons going back to English when the SFS layers change[/i] That's great.

re drive icons
Username: BarryK
"01micko, Was that when you used xrandr in QuickSetup to change resolution? I have put in a change to cause drive icons to redraw in that situation.

Accessibility 4 vission impaired
Username: technosaurus
"I have previously compiled the espeak package for converting text to speech, but I never really did anything really useful with it. I think it would be fairly straightforward to add a gettext/textviewer wrapper to /etc/functions4puppy (or something similar in the NLS packages) that would speak all text passed to gettext and/or defaulttexteditor/viewer if an environment variable is set. Let me know if you are interested (AFAIK, Knoppix is the only distro with something similar to support the vision impaired)

re re drive icons
Username: 01micko
"Actually no. What I did was use my "unload_nouveau" script to unload nouveau and reboot. It boots straight to desktop but "vesa" is chosen. Vesa sets the res at 1440x1024 (iirc) which works on my monitor but is out of range. (I get a persistent splash from the monitor in centre screen "Out of range" but the screen still shows). This is when I see the sda icons redrawn at an appropriate position and the sdb icons still halfway up screen. The highest res for the monitor is 1280x1024 and that's what nouveau sets it at. I didn't touch xrandr or use quicksetup at that point. My "unload_nouveau" script is based on the files that come with the "official" proprietary nvidia driver and it works quite well (see your attachment in PM). By the way, when I boot racy I get "vesa" loaded by default, must "choose" nouveau in xorgwizard. In racy I still get the odd behaviour of 1440x1024 resolution. (This is with racy 522, haven't got bet 5.3 yet). Hope this sheds some light.

Re unload_nouvea
Username: BarryK
"01micko, Put this into unload_nouveau: [i]echo "ICONWIPE" > /var/local/pup_event_icon_change_flag[/i] /root/.xinitrd calls clean_desk_icons which reads the above and wipes the desktop drive icons and they get redrawn.

Username: 01micko
"just saw the commit in the woof tree for nouveau_unload. Should you have added to the [i]disablefunc[/i] function [i]echo "ICONWIPE" > /var/local/pup_event_icon_change_flag [/i] ?

Re iconwipe
Username: BarryK
"I noticed that xorgwizard does it, right at bottom of script.

re re iconwipe
Username: 01micko
"ok, but nouveau_unload avoids xorgwizard altogether.. goes straight to reboot or quits. I think you were right to suggest it in the first place in the case where my machine reboots straight to desktop with vesa at a different res. Actually, it just occurred to me that xorgwizard can't run if nouveau is loaded, so maybe I need a bit of a logic shake up. Busy day tomorrow so Tuesday. :)

Tags: woof