 |
Other languages Deutsch ; English ; Español ; Français ; Portuguese (Portugal) ; Türkçe ; português brasileiro ; |
| Synopsis: Help, many screenshots are still missing for localised versions of our user manuals. Please upload some missing screenshots for your language somewhere, and send a link to them to the doc-discuss mailing list (after becoming a member of that list). |
Contents
Script to find the missing screenshots
Please get a file with the missing screenshots for your language, using this script and make it executable with the command chmod +x ./missing_screenshots.sh.
Execute the script in the folder where it is downloaded:
| $ ./missing_screenshots.sh xy |
where xy stands for the language code (list here). e.g.:./missing_screenshots.sh sv for Swedish and ./missing_screenshots.sh pt_br for Brazilian Portuguese.
The script should result in four files, one for draklive, and one for installer, one for MCC, and one for netinstall help, like those for French, placed in the same folder than the script:
Missing_fr_draklive_sss_<date>.txt
Missing_fr_installer_sss_<date>.txt
Missing_fr_MCC_sss_<date>.txt
Missing_fr_netinstall_sss_<date>.txt
If a localised screenshot has a different name than the same one in English, the screenshot will be listed both as missing (for the English file name) and as not existing in English, like this:
| MISSING: http://docteam.mageia.org.uk/WebHelp/en/installer/content/images/dx2-selectInstallClass.png |
| NOT_IN_ENGLISH: http://docteam.mageia.org.uk/WebHelp/$1/installer/content/images/dx2-selectinstallClass.png |
(-> may be an error in the localised screenshot filename --> Yes (--marja 11:04, 24 February 2015 (UTC)), but if the screenshot is there it is no problem, it means the same error exists in the link to the screenshot).
You also have a report in the console:
">" means the screenshot is present in the English images directory on docteam.mageia.org.uk, but not in the chosen language.
"<" means the screenshot is *not* present in the English directory, while it is in the chosen language. (useful to detect typos errors in the filenames)
The script only works correctly if no English screenshots were uploaded to the directory for your language in Calenco (Calenco is where we create our documentation), but only screenshots in the localised version.
| Note: not all those languages exist for different manuals! |
| Note: the script does not work for pt, but only for Brazilian (pt_br), pt_pt (Portuguese Portuguese) is mostly a bad copy of pt_br |
Publications with screenshots missing
For the WebHelp publications, the missing localised screenshots can be replaced by the English ones, before they are packaged or published on our website. That is not possible for the PDF and EPUB publications. You can see those with more than a few missing screenshots here:
PDF publications in Asian languages don't render their characters well. However, they are too incomplete, so still in the "Incomplete" directory. The fix for the Japanese PDF publications might work for them, too, just look at the extra settings of these Japanese publications and copy them.
Doing screenshots
Please use PNG (Portable Network Graphics) as fileformat for the screenshots.
If possible, then please take the screenshots in cauldron, without window decoration.
For the full MCC and traditional installer screens, the needed size is 800x600.
MCC
Take the MCC ones in a MCC that has never been resized. The screenshots will then automatically have the right size. The default size of MCC (without window decoration) is 800 x 600 px.
If you did resize it, then edit (as root) /etc/mcc.conf and set HEIGHT=600 and WIDTH=800.
Traditional installer
Start the ISO. In the boot screen, Mageia is highlighted by default. Press "e" to change the "vga:..." setting to "vga:788" and save the change. This will make the installer screens and the screenshots have the right size.
Installer screenshots can be taken by pressing F2 in every screen you need a picture of, while installing. The PNGs can be found after reboot in /root/DrakX-screenshots/.
DrakLive and NetInstall
Most NetInstall screenshots are screenshots from traditional installer. The remaining NetInstall screenshots and the DrakLive ones can only be made when using VirtualBox to install these ISOs. To be tried: (how to) set the resolution to 800x600 in Virtualbox? Or just start the ISOs with vga:788?
| Note: If you want to compress the screenshots, some suggestions on how to best do that were done in this thread on dev ml Compression can make the PDF publication fail, so don't throw the uncompressed original images away before the compressed ones have proven to work well in the PDF. Please do not make the background transparent, because that certainly gave problems with PDF publications. |
Temporarily use the English screenshots for the working copy of the webhelp (help in HTML format)
It is possible to temporarily use the English screenshots instead of missing localised ones, for the non-compressed webhelp/html publications in the non-English language code directories that you see in this list.
Someone with ssh access to docteam.mageia.org.uk can do that by going to the public_html directory and running: ./use_en_screenshots
After doing that, it is still possible to get the list of missing screenshots for any language with the script to find missing screenshots.
The English screenshots will be removed every time a html/webhelp publication is regenerated. So the command will need to be redone, then.
