[
http://jira.jboss.com/jira/browse/JBSEAM-2817?page=comments#action_12409721 ]
Jay Balunas commented on JBSEAM-2817:
-------------------------------------
I was able to build the translated docs, but found some things that I wanted to go over
before releasing.
Starting with a clean checkout of the 2.0.0.GA tag. Originally I created a "zh"
directory mirroring the "en" and pasted the new modules there. Then copied the
shared images, css, etc... to the same relative position in the zh directory as it was in
the en directory. I saw the errors below so I then tried a simple replace of the en
content with the provided files - with the same results.
- During the building of the translated files:
- [java] Error: no ID for constraint linkend: concurrency.
- [java] XRef to nonexistent id: concurrency
- This is not seen during non translated build.
- Will try to verify exact difference, but the two should be the same base content.
- Images do not show correctly and seem to be pointing to a different relative location in
the translated html files.
- Working original en version -
file:///jboss/projects/seam/2.0.0.GA/seam/doc/reference/build/en/shared/images/registration.png
- Failing translated versions -
file:///jboss/projects/seam/2.0.0.GA/seam/doc/reference/build/en/html/images/registration.png
- This seemed to be the case with all images.
- The translated PDF did have the images but that is because PDF bundles the
files.
- Received many more PDF warning like "[java] [INFO] No spaces to justify text in
line ...." when creating the PDF of the translated docs.
- Typically this is because of long lines without spaces that cannot be wrapped.
- There might not be anything to do about this.
- In the PDF all Chinese characters show as "#". In my experience with PDF and
FOP this is because the PDF file does not embed the correct fonts. I believe that if your
OS has the correct fonts then they will show. However it is possible to embed them with
the PDF so that they are visible to all. I will attempt to verify if my machine is
configured with the correct fonts. In my text editors, browsers, and other apps the fonts
show correctly.
The spot checks of the translations look fine as far as I can tell.
Question about what to publish. The translated files in
docs.jboss.com is easy and should
be in the "zh" directory under reference. For the source forge bundle do we
want all of the docs (api, reference, ui)(en,zh)? My suggestion would be yes - the bundle
should be everything from "http://docs.jboss.com/seam/2.0.0.GA/" down.
Chinese translation of 2.0.0.GA docs
------------------------------------
Key: JBSEAM-2817
URL:
http://jira.jboss.com/jira/browse/JBSEAM-2817
Project: Seam
Issue Type: Task
Components: Documentation Translation
Reporter: Pete Muir
Assigned To: Jay Balunas
Attachments: docs-zh.zip
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira