Re: [Gimp-docs] czech po files
> anybody knows where i could find czech po files for gimp documentation? > there exists czech translation of gimp 2.2 but the po files are not in > the gimp-help-2 repo. > Hi, cz PO files don't exist in the gimp-help-2 module. If you want to start a new translation for your language, you have to add "cz" to the gimp-help-2/configure.ac file, line 60. Then, run ./autogen.sh --without-gimp ALL_LINGUAS="cz en" (you can add other languages if you want). Then make po-cz, and you will get your PO files with all strings untranslated. Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] some docs fixes
> i have 10 patches in my local git repo now fixing various problems, and > now even in the proper format. i just did not want to spam bugzilla more. Hi Miroslav, I'll take care of your patches in Bugzilla. In magnify_to_zoom.patch, there are changes in po of different languages. Usually, patches are only for source xml files. I am not sure translators will agree foreign changes in their work. I'll apply only changes in source xml files. Your new look at GIMP Help is precious. All the best, Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] some docs fixes
Hi again, In magnify_to_zoom patch: #: src/toolbox/tool-zoom.xml:50(para) msgid "" -"The Magnify Tool is used to change the zoom level of your working image. If " +"The Zoom Tool is used to change the zoom level of your working image. If " src/toolbox/tool-zoom.xml doesn't exist. We presently have src/toolbox/zoom.xml where no "Magnify" is present. Which version of gimp-help-2 are you working on? You must do git clone git://git.gnome.org/gimp-help-2 In the gimp-help-2 directory you get, you run ./autogen.sh --without-gimp ALL_LINGUAS="cz en" make html-en to get the up-to-date English html. Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] czech po files
Le 19/12/2010 22:57, Miroslav Šulc a écrit : > i just found that in that time .po files were not used yet, all > translations were done in the xml files with language attributes. i > wonder what was the way you used to migrate the translations from xml > files to po files, unless you did it manually. There has been so many changes in the gimp-help-2 tree since we migrated to po that an automatical tranfer is not possible now, IMO. Ulf, who made this migration would give a more documented advice. Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] some docs fixes
Le 19/12/2010 17:34, Miroslav Šulc a écrit : >>> >>> I'll apply only changes in source xml files. >> cool, thanks. i have more patches on my disk, and planning to make a >> patch for other stuff too, like the capitalization of titles (and >> uncapitalization of image labels), tagging ui objects etc ... just need >> to know what is supposed to be the right style for the docs as it is not >> obvious to me yet. >> I have several English books and in all, title are capitalized. Image legends are not capitalized, excepted when they they refer to a command. Example: "The Save as Brush dialog, showing a sample brush". >> also, i agree with you that the fixes should probably be done only in >> src dir, the translation teams will get them once they update their po >> files as it affects also msgid items. i have no idea how much it will >> break their work as the msgid values will be new and will not match what >> comes from the main xml files. from this point of view patching also >> msgid lines would be better, but it's a question whether some inner po >> logic will not be broken by that. >> Modifying msgid strings manually is nonsense. A normal workflow is: - git pull --rebase This will update, in your repo, src/*.xml files and synchronize po files if another translator made changes in them. - make pot-xx This updates pot files according to changes in xml files. - make po-xx This updates your po files: msgid strings are updated and marked with a "#, fuzzy" comment. >> up to that, the changes are just in english language, so it affects >> either the untranslated texts or the msgid lines, not their translations. > just as thinking about it, please let me know what way you wanna apply > the patches. if you wanna change just src files, i can adjust the > patches. i used mostly grep and sed for these patches so they were fast > to create, but there were also cases with one line ending with "the" and > following line beginning with "the" so some changes were not that trivial. > Patches are applied to the src/*.xml files. > also, as these issues occur both in gimp-help-2-6-0 and in master, in my > opinion they should go first to branch gimp-help-2-6-0 and then should > be merged to master (and after that master should be searched for any > ommitted cases), but i noticed there is quite a lot (exactly 9) unmerged > changes between gimp-help-2-6-0 and master so i am not sure you port > everything from 2.6 branch to master. up to that, some changes, though > not merged from the branch, are in the master anyway, which confuses me > even more :-) > Don't worry about gimp-help-2.6.0. We work on master only. Our boss, Roman, periodically makes a new release of this help (which is always behind the master...) > after this, i can adjust the patches and prepare the rest of patches (i > have total 10, just 6 are at bugzilla atm) and i will know how to > prepare the rest. Please send patches directly to me, so that I am not obliged to retrieve them from Bugzilla. Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] some docs fixes
Le 19/12/2010 17:17, Miroslav Šulc a écrit : > my git repo is up to date, what is not probably up to date is po files > of some translations. just run this to see yourself: > If your repo is up-to-date, go to src/toolbox. You must find the zoom.xml file. Open it in a text editor : you will see that there is no "Magnify". > git grep src/toolbox/tool-zoom.xml > This command shows reference to tool-zoom.xml in the old changelogs that we no longer fill since we migrated to git from svn. Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] some docs fixes
Oh sorry, I understand now what you want to do with your patch. I was accustomed to have a #, fuzzy comment for one lettre changed. I just resumed work after six monthes absence. I have lost familiarity with gimp-help and I had gorgotten that there are two zoom.xml :-( But I get now into a problem: When I run git-apply --check xxx.patch I get the error "Command not found". Trying to resolve it... Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] some docs fixes
Hi Miroslav, > well, i have no idea what is the rule now, but imo making extra work for > translation teams just because there was a typo in english version does > not make sense to me :-) You are right. But here what I get when applying patches: ~/gimp-help-2> git apply select_to_channel.patch ~/gimp-help-2> git apply access_to.patch error: patch failed: po/es/toolbox.po:2754 error: po/es/toolbox.po: patch does not apply ~/gimp-help-2> git apply magnify_to_zoom.patch error: patch failed: po/es/toolbox.po:183 error: po/es/toolbox.po: patch does not apply ~/gimp-help-2> git apply duplicate.patch ~/git-patches/gimp-help-2> The es toolbox.po files has been updated after you made patches. The problem is that there are 1769 lines only in this file and that line 183 looks perfectly normal. Do you have a solution? Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] some docs fixes
Hi Miroslav, Your patches have been pushed. Good work! Could you tell us how you modified msgid strings in po files? A command line? A script? Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
[Gimp-docs] Translated strings in po remain in English in html
Hi, Some translated strings in my po files remain in English when transformed to html. I remember that was a problem of different "make", but I don't know how to resolve it :-( Please help me. Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] Translated strings in po remain in English in html
Hi, > what strings exactly you mean? #: src/dialogs/templates-dialog.xml:34(para) msgid "" "Templates are templates for an image format to be created.GIMP offers you a lot of templates and you can create your owns. When you create a New image, you can access to the list of existing templates but you can't manage them. The Templates dialog allows you to manage all these templates." msgstr "" "Il s'agit de modèles pour un format d'image à créer.GIMP vous offre un certain nombre de modèles, et vous pouvez créer vos propres modèles. Quand vous créez une Nouvelle image, vous pouvez accéder à la liste des modèles existants, mais vous ne pouvez pas les gérer. La fenêtre de dialogue Modèles vous donne la possibilité de gérer ces différents modèles." This French string is displayed in English in the French Html. I tried deleting the fr string, and saving dialogs.po; then reopening dialogs.po and translating the string again, saving again. make html-fr: the string is still English :-( Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] Translated strings in po remain in English in html
> did you try to run "make clean" before "make html-fr"? you can also make > sure xml directory is deleted after "make clean" (as files in this > directory are used for generating of the html files). ~/gimp-help-2> make clean Making clean in quickreference make[1]: entrant dans le répertoire « /home/julien/gimp-help-2/quickreference » rm -rf docbook rm -rf svg rm -rf xml rm -f .xml2po.mo make[1]: quittant le répertoire « /home/julien/gimp-help-2/quickreference » Making clean in . make[1]: entrant dans le répertoire « /home/julien/gimp-help-2 » make[1]: quittant le répertoire « /home/julien/gimp-help-2 » ~/gimp-help-2> make html-fr Makefile:488: xml/de/.deps.mk: Aucun fichier ou dossier de ce type Makefile:488: xml/fr/.deps.mk: Aucun fichier ou dossier de ce type [SRC] src/preface/authors.xml [DEP] xml/fr/.deps.mk [DEP] xml/de/.deps.mk [POT] pot/appendix.pot [POT] pot/dialogs.pot Traceback (most recent call last): File "./tools/xml2po.py", line 191, in main(sys.argv[1:]) File "./tools/xml2po.py", line 184, in main xml2po_main.to_pot(filenames) File "/home/julien/gimp-help-2/tools/xml2po/__init__.py", line 570, in to_pot self.current_mode.preProcessXml(doc.doc, self.msg) File "/home/julien/gimp-help-2/tools/xml2po/modes/gimphelp.py", line 85, in preProcessXml root = doc.getRootElement() File "/usr/lib64/python2.6/site-packages/libxml2.py", line 4199, in getRootElement if ret is None:raise treeError('xmlDocGetRootElement() failed') libxml2.treeError: xmlDocGetRootElement() failed make: *** [pot/dialogs.pot] Erreur 1 There is a serious problem! If you understand that... Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] Translated strings in po remain in English in html
Hi, > > Remove and recreate xml/fr/dialogs/templates-dialog.xml. > All is OK now Thank you and Merry Xmas! Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] Introduction
Welcome, The GIMP-HELP-2 project is at present ticking over, probably waiting GIMP-2.8. Your arrival is a good thing to wake the project up. especially as an English native speaker. > > First of all, how do things work in this project, in terms of process, > decision-making, etc? My aim is to make the documentation better by > changing things such as "how to be a gimp wizard" and other > miscellaneous strange terms in the documentation, and make it easier for > a user to find what they > are looking for (wizardry, I suspect, is not among them). > But obviously not all changes are well received by everyone, so what I > most need to know, is who has the power to accept or reject changes? How > do you review / discuss changes? Is the manual in other languages 100% > identical to the English one and how does that affect my ability to > change the English manual? Roman is in charge of the project. He should have answered to your question normally, but he is very busy for the moment. Ulf is an important contributor, and knows XML, GIT... very well. And me, Julien, who is working on the project since the beginning, and had to get acquainted with SVN, GIT, XML, GETTEXT... These three persons are permanent contributors. Some other bring intermittent contribution. > > I think until I figure that out I'll restrict myself to learning the > system, and cut my teeth on some low-hanging fruit such as finding > instances of "The Gimp" and replacing them with "Gimp". It must be GIMP (GIMP in XML files). > > Now, to technical matters: Working with GIT and the XML. > > I'm on Ubuntu 10.10, and have downloaded a copy of the GIT repository as > described in the "help us" page. Now, the thing is, I'm no programmer. > I'm familiar with version control - specifically Microsoft Team > Foundation server (at work), but I've never really worked on code, just > art resources. So I'm kinda lost when it comes to GIT. Is there a > recommended front end / GUI to access it? Or do you do all your checkout > and commits in the terminal? As an artist I'm much more GUI-oriented. > GIT is difficult. You will find good tutorials on the WEB (http://www.spheredev.org/wiki/Git_for_the_lazy for instance). You don't have to know all about GIT to start. You easily understand that you can't push your fist files to the git repository directly. You can send them to me personnally, so that I can verify them. > I browsed the repository and I see help pages are written in XML. Do you > hand-code everything, or do you have some easier way to write pages in > an editor? And is there documentation on how to write said XML or do I > just read the existing pages and do my best to emulate that? > Yes, we write documentation with a text editor (I use Kate). For new files, you will find templates in gimp-help-2/docs/templates. Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] concepts
Hi Michael, OK for substance. Some remarks about form: > Lastly, how important is the way these files are indented? I always use > tabs, and any editor I'm familiar with uses tabs to indent lines, while > these files seem to use spaces. Is is important to indent the XML in > this way? - TAB are set to 2 spaces. - Lines are less than 80 characters and spaces. - When explaining a term, please add an Resolution This will automatcally appear in the "index" chapter: last line in the html summary. - I noticed 2 typos: "reslution" and "noticable". You probably have a spelling command in your editor. > what > is the significance of adding "acronym" and "quote" tags? what are they > for? they seem to have no influence on the final output. > For "acronym>, I don't know. But "quote" is important for internationalization. With Hello, I automatically get the French quotes in French html (« Hello ») with indivisible spaces! I made these changes in your xml file. Do you want I push your changes? Regards, Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] concepts
> - When explaining a term, please add an > > Resolution > >This will automatcally appear in the "index" chapter: last line in > the html summary. > > > I've been meaning to ask about this: There were 7 terms in concepts.xml > but only one of them, channels, had an indexterm. So if I understand > correctly, the reason is that those other terms are explained at length > elsewhere, and THOSE places are linked to in the index, while there is > no other reference to resolution in the help? > That is docbook rules: there is no varlistentry parent for indexterm but there is title. In varlistentry you must include indexterm within tags. Please see > http://docbook.org/tdg/en/html/indexterm.html There are some inconsistencies in the index. It has to be reviewed. > I made these changes in your xml file. Do you want I push your changes? > > > Sure. Done http://git.gnome.org/browse/gimp-help-2/ ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
[Gimp-docs] Starting help for gimp-2.8
Hi, According to the GIMP developers wiki http://gimp-wiki.who.ee/index.php/GIMP_Roadmap, only layer groups and single-window mode will change until gimp-2.8 release (and probably only for bug fixes). We can reasonably consider that gimp-2.8 will be released within a few monthes. More than 6 monthes were necessary to update gimp-help-2 to 2.6. So, I think we should start writing gimp-2.8 help now. For that, we need: - a separated git module for gimp-help-2.8, containing a copy of the present gimp-help-2 at first. - a gimp-doc-wiki(like the old we had) with the list of features that must be updated, and the possibility of knowing who works on what. Unfortunately, I have not the knowledge to build a git module or a gimp wiki :-(. Greetings, Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] Starting help for gimp-2.8
Hi Roman, > On Thu, Mar 03, 2011 at 07:07:00AM +0100, Julien Hardelin wrote: >> For that, we need: >> - a separated git module for gimp-help-2.8, containing a copy of the >> present gimp-help-2 at first. >> - a gimp-doc-wiki(like the old we had) with the list of features that >> must be updated, and the possibility of knowing who works on what. > Perhaps for this, the developers wouldn't mind if the documentation team > could use the wiki as well? > > I could perhaps ask on the developer mailing list for this > opportunity... > The wiki is not the most important as long as contributors are few. But what about a separated module for gimp-help-pre-2.8? Michael sent a re-written quickie.xml file. This tutorial is much better than the present one, but it refers to the Export command, which is a gimp-2.7 feature. I can't push it to the gimp-help-2 repository. Michael is a valuable recruit for gimp-help. I'm afraid he will turn discouraged if its work is not validated. Cheers, Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] more changes to help
> 2. Running GIMP > > 1. Running GIMP > > 1.1. Known Platforms > 1.2. Language > 1.3. Command Line Arguments > > > 1.4. For Photoshop Users > > > 1.5. Starting GIMP for the first time > > 1.6. Before you proceed > 2. Running GIMP 2.1. Known Platforms 2.2. Language 2.3. Command Line Arguments 2.4. Starting GIMP for the first time 2.5. Before you proceed 2.6. For Photoshop Users Julien ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs