[wsjt-devel] Translations of the WSJT-X User Guide
Hi Anders, Borja, and all, I suggest that translations should probably start with the WSJT-X User Guide in the development branch -- that is, the Guide for Version 1.7.0. As it now stands, this document is not much different from the one for version 1.6. New sections need to be written for the "fast modes", in particular, and there will be some additions to the sections on VHF/UHF capabilities. But these sections are reasonably well isolated from other parts of the guide. So it's probably safe to start work on the existing material any time you wish. -- 73, Joe, K1JT -- Site24x7 APM Insight: Get Deep Visibility into Application Performance APM + Mobile APM + RUM: Monitor 3 App instances at just $35/Month Monitor end-to-end web transactions and take corrective actions now Troubleshoot faster and improve end-user experience. Signup Now! http://pubads.g.doubleclick.net/gampad/clk?id=267308311&iu=/4140 ___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
Re: [wsjt-devel] Translations of the WSJT-X User Guide
> On 12 Jan 2016, at 22:37, Joe Taylor wrote: > > Hi Anders, Borja, and all, > > I suggest that translations should probably start with the WSJT-X User > Guide in the development branch -- that is, the Guide for Version 1.7.0. Great, beginning :) 73, Borja EA2EKH -- Site24x7 APM Insight: Get Deep Visibility into Application Performance APM + Mobile APM + RUM: Monitor 3 App instances at just $35/Month Monitor end-to-end web transactions and take corrective actions now Troubleshoot faster and improve end-user experience. Signup Now! http://pubads.g.doubleclick.net/gampad/clk?id=267308311&iu=/4140 ___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
Re: [wsjt-devel] Translations of the WSJT-X User Guide
Hi Joe, Ok! I'll get started with the existing material and work the updates in to it when it's available. :-) 73 de SM7VRZ, Anders Den 12 jan 2016 22:41 skrev "Joe Taylor" : > Hi Anders, Borja, and all, > > I suggest that translations should probably start with the WSJT-X User > Guide in the development branch -- that is, the Guide for Version 1.7.0. > As it now stands, this document is not much different from the one for > version 1.6. New sections need to be written for the "fast modes", in > particular, and there will be some additions to the sections on VHF/UHF > capabilities. But these sections are reasonably well isolated from > other parts of the guide. So it's probably safe to start work on the > existing material any time you wish. > > -- 73, Joe, K1JT > > > -- > Site24x7 APM Insight: Get Deep Visibility into Application Performance > APM + Mobile APM + RUM: Monitor 3 App instances at just $35/Month > Monitor end-to-end web transactions and take corrective actions now > Troubleshoot faster and improve end-user experience. Signup Now! > http://pubads.g.doubleclick.net/gampad/clk?id=267308311&iu=/4140 > ___ > wsjt-devel mailing list > wsjt-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/wsjt-devel > -- Site24x7 APM Insight: Get Deep Visibility into Application Performance APM + Mobile APM + RUM: Monitor 3 App instances at just $35/Month Monitor end-to-end web transactions and take corrective actions now Troubleshoot faster and improve end-user experience. Signup Now! http://pubads.g.doubleclick.net/gampad/clk?id=267308311&iu=/4140___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
Re: [wsjt-devel] Translations of the WSJT-X User Guide
Hi all! I now feel finished with translating the existing sections of the V1.7.0 user guide into Swedish. However I may have to get some proofreading made on it just to be sure it´s ok. :) Is there any texts or documentation regarding the new functions that can be started on for the user guide? Maybe it's to soon for this? We also have the question about how to do the integration of the translated material in to the documentation source code on SVN. At the present only the text in the documentation source files have been changed/translated and the file structure is exactly like the english version. Except for the source files in the user guide folder containing the translated section files, changes has also been made to the files in the "common" folder. Especially the license and links ADOC files. How are we going to do the integration of the translated files into the documentation? Best regards, 73 //Anders, SM7VRZ 2016-01-13 16:10 GMT+01:00 Anders Rhodin : > Hi Joe, > > Ok! I'll get started with the existing material and work the updates in to > it when it's available. :-) > > 73 de SM7VRZ, Anders > Den 12 jan 2016 22:41 skrev "Joe Taylor" : > >> Hi Anders, Borja, and all, >> >> I suggest that translations should probably start with the WSJT-X User >> Guide in the development branch -- that is, the Guide for Version 1.7.0. >> As it now stands, this document is not much different from the one for >> version 1.6. New sections need to be written for the "fast modes", in >> particular, and there will be some additions to the sections on VHF/UHF >> capabilities. But these sections are reasonably well isolated from >> other parts of the guide. So it's probably safe to start work on the >> existing material any time you wish. >> >> -- 73, Joe, K1JT >> >> >> -- >> Site24x7 APM Insight: Get Deep Visibility into Application Performance >> APM + Mobile APM + RUM: Monitor 3 App instances at just $35/Month >> Monitor end-to-end web transactions and take corrective actions now >> Troubleshoot faster and improve end-user experience. Signup Now! >> http://pubads.g.doubleclick.net/gampad/clk?id=267308311&iu=/4140 >> ___ >> wsjt-devel mailing list >> wsjt-devel@lists.sourceforge.net >> https://lists.sourceforge.net/lists/listinfo/wsjt-devel >> > -- Find and fix application performance issues faster with Applications Manager Applications Manager provides deep performance insights into multiple tiers of your business applications. It resolves application problems quickly and reduces your MTTR. Get your free trial! https://ad.doubleclick.net/ddm/clk/302982198;130105516;z___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
Re: [wsjt-devel] Translations of the WSJT-X User Guide
Hi Anders, On 24/04/2016 14:32, Anders Rhodin wrote: > I now feel finished with translating the existing sections of the > V1.7.0 user guide into Swedish. > However I may have to get some proofreading made on it just to be sure > it´s ok. :) > > Is there any texts or documentation regarding the new functions that > can be started on for the user guide? Maybe it's to soon for this? Probably best to wait for updates to the english language User Guide and track them as they get committed. > > We also have the question about how to do the integration of the > translated material in to the documentation source code on SVN. This is already in place. The CMake scripts have been adjusted for building multiple language versions of the User Guide and the WSJT-X application has been enhanced to find the correct manual from the project web server based on the user's locale settings. > At the present only the text in the documentation source files have > been changed/translated and the file structure is exactly like the > english version. This is good as the CMake scripts assume that is the case. > Except for the source files in the user guide folder containing the > translated section files, changes has also been made to the files in > the "common" folder. This is more complex, what changes have been made to the common files? > Especially the license and links ADOC files. I do not think translating the licence text is advisable, to be GPL v3 compatible the wording must be exactly as per the official GPL v3 licence. I'm not sure if translations of that text are available or necessary. > > How are we going to do the integration of the translated files into > the documentation? > You can send a patch to me or simply a zip/tar archive of the relevant directories and I will commit the initial version, with you credited of course. Once hat is in place it should be simpler for others to follow up with new languages. 73 Bill G4WJS. -- Find and fix application performance issues faster with Applications Manager Applications Manager provides deep performance insights into multiple tiers of your business applications. It resolves application problems quickly and reduces your MTTR. Get your free trial! https://ad.doubleclick.net/ddm/clk/302982198;130105516;z ___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
Re: [wsjt-devel] Translations of the WSJT-X User Guide
Hi Bill, 2016-04-24 15:52 GMT+02:00 Bill Somerville : > Hi Anders, > > On 24/04/2016 14:32, Anders Rhodin wrote: > > I now feel finished with translating the existing sections of the > > V1.7.0 user guide into Swedish. > > However I may have to get some proofreading made on it just to be sure > > it´s ok. :) > > > > Is there any texts or documentation regarding the new functions that > > can be started on for the user guide? Maybe it's to soon for this? > > Probably best to wait for updates to the english language User Guide and > track them as they get committed. QSL on that. :) > > > > We also have the question about how to do the integration of the > > translated material in to the documentation source code on SVN. > > This is already in place. The CMake scripts have been adjusted for > building multiple language versions of the User Guide and the WSJT-X > application has been enhanced to find the correct manual from the > project web server based on the user's locale settings. > QSL! Just remembered that you mentioned this modification earlier. > > At the present only the text in the documentation source files have > > been changed/translated and the file structure is exactly like the > > english version. > > This is good as the CMake scripts assume that is the case. > Perfect! :) > > Except for the source files in the user guide folder containing the > > translated section files, changes has also been made to the files in > > the "common" folder. > This is more complex, what changes have been made to the common files? > I suspected that this might be a problem. As mentioned below It concerns the links.adoc and license.adoc files. The reason for doing corrections in the links-file is that the corresponding links in the text in the English user guide uses words in sentences, ex. "Click here for more information" where the word "here" contains the link. Since that the user guide is in Swedish the English word "here" does´nt really fit in.. ;) I just realized that this might be solved by adding new posts of links but tagged to fit with a Swedish version. This will leave the English links texts as they are just adding links to other languages. Is this an acceptable way to solve it? I think I´ll restore the original links-file and just add on the required links with a tag for the Swedish translation. Just to try it locally. > > Especially the license and links ADOC files. > > I do not think translating the licence text is advisable, to be GPL v3 > compatible the wording must be exactly as per the official GPL v3 > licence. I'm not sure if translations of that text are available or > necessary. > Ok, for the time being It might be better to leave the text as it is according to the GPL v3 in English. There might be a Swedish version but as you said, It might not be necessary. > > > > How are we going to do the integration of the translated files into > > the documentation? > > You can send a patch to me or simply a zip/tar archive of the relevant > directories and I will commit the initial version, with you credited of > course. Once hat is in place it should be simpler for others to follow > up with new languages. > QSL! I´ll do that after we sorted out and agreed how to handle the common files. Depending on how to solve the issue it might need some more tweaking in the files.. :) 73 de SM7VRZ, Anders -- Find and fix application performance issues faster with Applications Manager Applications Manager provides deep performance insights into multiple tiers of your business applications. It resolves application problems quickly and reduces your MTTR. Get your free trial! https://ad.doubleclick.net/ddm/clk/302982198;130105516;z___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
Re: [wsjt-devel] Translations of the WSJT-X User Guide
Hi Anders, comments in line below. On 24/04/2016 16:23, Anders Rhodin wrote: > Except for the source files in the user guide folder containing the > translated section files, changes has also been made to the files in > the "common" folder. This is more complex, what changes have been made to the common files? Isuspected that this might be a problem. As mentioned below It concerns the links.adoc and license.adoc files. The reason for doing corrections in the links-file is that the corresponding links in the text in the English user guide uses words in sentences, ex. "Click here for more information" where the word "here" contains the link. Since that the user guide is in Swedish the English word "here" does´nt really fit in.. ;) I just realized that this might be solved by adding new posts of links but tagged to fit with a Swedish version. This will leave the English links texts as they are just adding links to other languages. Is this an acceptable way to solve it? That sounds reasonable to me but some of the common stuff was made common when the documentation was central for more than just WSJT-X, it may be more appropriate to move some of the common stuff back into the document. If the links are only used once and have a non-proper noun link text then I do not think moving them back to the document itself will be a problem at all. Where a "here" link text is actually referring to a external document written in English then the link text can easily be made the document title, in English, and a trivial rewording of the reference will make it more amenable to translations. I think I´ll restore the original links-file and just add on the required links with a tag for the Swedish translation. Just to try it locally. > Especially the license and links ADOC files. I do not think translating the licence text is advisable, to be GPL v3 compatible the wording must be exactly as per the official GPL v3 licence. I'm not sure if translations of that text are available or necessary. Ok, for the time being It might be better to leave the text as it is according to the GPL v3 in English. There might be a Swedish version but as you said, It might not be necessary. The details are here: http://www.gnu.org/licenses/translations.en.html and there are no "official" translations because of the reasons stated there. There are a handful of unofficial translations that follow the strict rules stated. IMHO for an application used in a domain where English is often the common language having the licence in English only is not a big issue. 73 Bill G4WJS. -- Find and fix application performance issues faster with Applications Manager Applications Manager provides deep performance insights into multiple tiers of your business applications. It resolves application problems quickly and reduces your MTTR. Get your free trial! https://ad.doubleclick.net/ddm/clk/302982198;130105516;z___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
Re: [wsjt-devel] Translations of the WSJT-X User Guide
Hi Bill, Comments in the lines below.. :) 2016-04-24 17:45 GMT+02:00 Bill Somerville : > Hi Anders, > > comments in line below. > > On 24/04/2016 16:23, Anders Rhodin wrote: > > > Except for the source files in the user guide folder containing the >> > translated section files, changes has also been made to the files in >> > the "common" folder. > > > >> This is more complex, what changes have been made to the common files? >> > > I suspected that this might be a problem. As mentioned below It concerns > the links.adoc and license.adoc files. > The reason for doing corrections in the links-file is that the > corresponding links in the text in the English user guide uses words in > sentences, ex. "Click here for more information" where the word "here" > contains the link. Since that the user guide is in Swedish the English word > "here" does´nt really fit in.. ;) > I just realized that this might be solved by adding new posts of links but > tagged to fit with a Swedish version. This will leave the English links > texts as they are just adding links to other languages. Is this an > acceptable way to solve it? > > That sounds reasonable to me but some of the common stuff was made common > when the documentation was central for more than just WSJT-X, it may be > more appropriate to move some of the common stuff back into the document. > > If the links are only used once and have a non-proper noun link text then > I do not think moving them back to the document itself will be a problem at > all. > > Where a "here" link text is actually referring to a external document > written in English then the link text can easily be made the document > title, in English, and a trivial rewording of the reference will make it > more amenable to translations. > That sounds reasonable to me. Moving the links back to the document is not that hard and the most of the links are only used once or maybe twice for some of them. It's OK by me to make theese adjustments but It's important that we work the same way with all three manuals. :) > > > I think I´ll restore the original links-file and just add on the required > links with a tag for the Swedish translation. Just to try it locally. > > > >> > Especially the license and links ADOC files. >> > > >> I do not think translating the licence text is advisable, to be GPL v3 >> compatible the wording must be exactly as per the official GPL v3 >> licence. I'm not sure if translations of that text are available or >> necessary. >> > > Ok, for the time being It might be better to leave the text as it is > according to the GPL v3 in English. > There might be a Swedish version but as you said, It might not be > necessary. > > The details are here: > > http://www.gnu.org/licenses/translations.en.html > > and there are no "official" translations because of the reasons stated > there. There are a handful of unofficial translations that follow the > strict rules stated. IMHO for an application used in a domain where English > is often the common language having the licence in English only is not a > big issue. > I looked at the page regarding translations of the GPL and It do seems best to leave the license text as it is in English... :) 73 de SM7VRZ, Anders -- Find and fix application performance issues faster with Applications Manager Applications Manager provides deep performance insights into multiple tiers of your business applications. It resolves application problems quickly and reduces your MTTR. Get your free trial! https://ad.doubleclick.net/ddm/clk/302982198;130105516;z___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel
Re: [wsjt-devel] Translations of the WSJT-X User Guide
On 24/04/2016 16:23, Anders Rhodin wrote: The reason for doing corrections in the links-file is that the corresponding links in the text in the English user guide uses words in sentences, ex. "Click here for more information" where the word "here" contains the link. Since that the user guide is in Swedish the English word "here" does´nt really fit in.. ;) Hi Anders, In https://sourceforge.net/p/wsjt/wsjt/6647/ I have made some minor changes to the links.adoc file and the User Guide that should help translators without having to duplicate links. This is important since links need updating occasionally and only doing it in one file in one place is optimal. Here is a sample of the User Guide after those changes: https://dl.dropboxusercontent.com/u/4192709/wsjtx-main_en.pdf 73 Bill G4WJS. -- Find and fix application performance issues faster with Applications Manager Applications Manager provides deep performance insights into multiple tiers of your business applications. It resolves application problems quickly and reduces your MTTR. Get your free trial! https://ad.doubleclick.net/ddm/clk/302982198;130105516;z___ wsjt-devel mailing list wsjt-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wsjt-devel