Re: HTML -> XHTML in Mozilla's help files
I've been looking for a way to help with the Mozilla documentation. I have been a tech writer (though I haven't done too much software doc) and I know Perl pretty well. Please let me know here or at margaret -at- oddpost . com if I can help. cheers, Margaret R.J. Keller wrote: Ricardo Palomares Martinez wrote: Yes, it would be the best solution. Even more, if people at mozilla.org is using any specific tool to manage the HTML -> XHTML conversion, it would be fine if they told us which and how, in order for us to follow the same process in the translated help files. Regards. I am responsible for the HTML->XHTML conversion, and I used TidyGUI (http://perso.wanadoo.fr/ablavier/TidyGUI) and I manually went through and updated the anchors. I apologize for all the work I'm probably putting you guys through. It is beneficial though. The mail help docs (when I converted them) were about a third smaller than before. The new system is also easier for working with anchors in previous docs, too. I'm hoping to get a Perl script working that will fix all of the anchors correctly, but I don't know much Perl so it'll be slow :(. --R.J. ___ mozilla-documentation mailing list [EMAIL PROTECTED] http://mail.mozilla.org/listinfo/mozilla-documentation
Re: HTML -> XHTML in Mozilla's help files
R.J. Keller escribió: I am responsible for the HTML->XHTML conversion, and I used TidyGUI (http://perso.wanadoo.fr/ablavier/TidyGUI) and I manually went through and updated the anchors. Thanks a lot! I'll download it and play with mail_help.html, which is, you know, a bit long. :-) I apologize for all the work I'm probably putting you guys through. It is beneficial though. The mail help docs (when I converted them) were about a third smaller than before. The new system is also easier for working with anchors in previous docs, too. Yep, and it allows better styles applying. It's just that we weren't prepared in advance for that, but I realize it's neccessary. :-) Thanks for the info, and happy new year. -- "Software is like sex. It's better when it's free" (Linus Torvalds) ___ mozilla-documentation mailing list [EMAIL PROTECTED] http://mail.mozilla.org/listinfo/mozilla-documentation
Re: HTML -> XHTML in Mozilla's help files
Ricardo Palomares Martinez wrote: Yes, it would be the best solution. Even more, if people at mozilla.org is using any specific tool to manage the HTML -> XHTML conversion, it would be fine if they told us which and how, in order for us to follow the same process in the translated help files. Regards. I am responsible for the HTML->XHTML conversion, and I used TidyGUI (http://perso.wanadoo.fr/ablavier/TidyGUI) and I manually went through and updated the anchors. I apologize for all the work I'm probably putting you guys through. It is beneficial though. The mail help docs (when I converted them) were about a third smaller than before. The new system is also easier for working with anchors in previous docs, too. I'm hoping to get a Perl script working that will fix all of the anchors correctly, but I don't know much Perl so it'll be slow :(. --R.J. ___ mozilla-documentation mailing list [EMAIL PROTECTED] http://mail.mozilla.org/listinfo/mozilla-documentation
Re: HTML -> XHTML in Mozilla's help files
Martijn Ras escribió: Heya Folks, Translationwise this html -> xhtml conversion is a pain in the neck ... :-) Yes, I agree. Despite this, it's fair to admit that more changes had come in past releases due just to updates in the content itself. This leads me to the following questions: Who's in charge of the conversion to xhtml? Would it be possible to split work on the file into a couple of updates instead of one gigantic like currently happens? Suggested update scheme: 1) html -> xhtml conversion (leaves text intact only brushes tags) 2) Apply anchor/link naming convention 3) Rearrange text if needs be Yes, it would be the best solution. Even more, if people at mozilla.org is using any specific tool to manage the HTML -> XHTML conversion, it would be fine if they told us which and how, in order for us to follow the same process in the translated help files. Regards. -- "Software is like sex. It's better when it's free" (Linus Torvalds) ___ mozilla-documentation mailing list [EMAIL PROTECTED] http://mail.mozilla.org/listinfo/mozilla-documentation
Re: HTML -> XHTML in Mozilla's help files
Heya Folks, Translationwise this html -> xhtml conversion is a pain in the neck ... In itself the conversion (which is a good thing) shouldn't really need cause huge differences in the files. Rearranging the text, updating all anchors and links within the file at the same time is causing a shitload of work for translators. Here's my practice at the moment: 1) Take a diff of the original html and upgraded xhtml file. 2) Rid the diff of all tags, both html and xhtml. 3) Compare the text that's left in the diff. 4a) If 3) didn't show too many differences, copy the upgraded xhtml into the translation and merge translated contents of the html file. 4b) If 3) shows no comparison, discard the translated html file, copy the xhtml file and translate it (again). This leads me to the following questions: Who's in charge of the conversion to xhtml? Would it be possible to split work on the file into a couple of updates instead of one gigantic like currently happens? Suggested update scheme: 1) html -> xhtml conversion (leaves text intact only brushes tags) 2) Apply anchor/link naming convention 3) Rearrange text if needs be Mazzel, Martijn. ___ mozilla-documentation mailing list [EMAIL PROTECTED] http://mail.mozilla.org/listinfo/mozilla-documentation