> There is a problem with function reference chapters translated into other > languages than English: Originally, the function reference is ordered > alphabetically by chapter names. But if these chapters have been translated > into another language, this ordering "semantically" persists. It means it > doesn't order by translated names. Thus it's very difficult to find the > requested function set. Why it doesn't order by translated chapter names?
This is a very old problem, we at the Hungarian translation team also created a manual.xml.in file for our language with right ordering sometime. What's problematic with it, is that you need to update it anytime the english one is updated. So some automation is needed. But we postponed this project, as the new reference grouping eliminates the problem, as there will be much more groups, with less reference parts (ordered logically mainly), so ordering won't be a problem. We already have a sample file [phpdoc/rfc/manual.xml.in] showing the new structure. It's not a question if we want to group references or not, it's already discussed, we want it, as the current alphabetical order is very hard to use. However, to use that structure, we need to put a customization layer on top of DocBook XML and on top of stylesheets. The DocBook XML customization layer is already done, and available at phpdoc/dtds/phpbook.dtd. It's quite simple, but some guys may fear of using a customized DTD (though the PHP-GTK guys use one without any problems), so I left it up to discussion. There were not too much sensible replys, as far as I can remember now, only Steph replied (from PHP-GTK doc team). One thing needs to be addressed to use the grouping is to customize the stylesheets to create new chunks (HTML files) for <section> tags, which is not the case currently. It would also make the reference main pages less crowded. There is too much info on one HTML page now there. So again, the question is if anybody has problems of migrating to PHPBook 1.0? Taking in account that no file needs to be modified in any repositories, because PHPBook 1.0 is totally backward compatible with DocBook 4.1.2 (which we are currently using). Only the doctype of manual.xml.in needs to be modified of course :) Goba -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
