Description of problem: With publican and brew combination one can't publish specific formatted documents to docs.redhat.com. How reproducible: Everytime Actual results: With publican+brew one can generate specific formatted document (html, pdf, html-single, etc) locally, but this option is not available in the case of publishing docs to docs.redhat.com Expected results: One should be allowed to publish documents in any format of document. Additional info: Since Indic localized PDF rendering is not supported at the moment, it has become the high priority to get rid of PDFs generated and published using publican+brew combination.
I'd rephrase this bug to: Indic PDFs should never be generated for web site packages due to the fonts not being compatible with FOP.
Changed Product to Fedora. I think having a switch in the publican.cfg file that allows one to specify individual languages to show pdfs in english would be a wide enough functionality to trap this case and future cases that may arise.
(In reply to comment #3) > Changed Product to Fedora. > > I think having a switch in the publican.cfg file that allows one to specify > individual languages to show pdfs in english would be a wide enough > functionality to trap this case and future cases that may arise. The untranslated content is not available by the time the PDF is being generated for the web site. It would take quite a bit of re-engineering to carry two XML payloads in the SRPM.
(In reply to comment #2) > I'd rephrase this bug to: > > Indic PDFs should never be generated for web site packages due to the fonts not > being compatible with FOP. There's a related problem for RTL languages (such as ar-SA, fa-IR, he-IL), since presently, FOP does not support these at all. (Support is expected in FOP 1.1 -- http://www.mail-archive.com/fop-users@xmlgraphics.apache.org/msg15558.html) If we're going to exclude Indic languages, we should probably exclude these as well.
Removed PDF from the list of web formats for all Indic + ar-SA, fa-IR, he-IL languages. Fixed in build: 2.3-0%{?dist}.t47
(In reply to comment #6) > Removed PDF from the list of web formats for all Indic + ar-SA, fa-IR, he-IL > languages. > > Fixed in build: 2.3-0%{?dist}.t47 Thx Jeff, Is there a way I could grab this build and test it? Couldn't find it on koji neither brew!
(In reply to comment #7) > (In reply to comment #6) > > Removed PDF from the list of web formats for all Indic + ar-SA, fa-IR, he-IL > > languages. > > > > Fixed in build: 2.3-0%{?dist}.t47 > > Thx Jeff, Is there a way I could grab this build and test it? Instructions are here: https://fedorahosted.org/publican/wiki/Installing If you're using an operating system other than Fedora 13, the dependencies might be somewhat different, but the procedure is otherwise the same. Any error messages that you get while trying to run ./Build local will tell you what dependencies you're missing.
(In reply to comment #8) > (In reply to comment #7) > > (In reply to comment #6) > > > Removed PDF from the list of web formats for all Indic + ar-SA, fa-IR, he-IL > > > languages. > > > > > > Fixed in build: 2.3-0%{?dist}.t47 > > > > Thx Jeff, Is there a way I could grab this build and test it? > > Instructions are here: https://fedorahosted.org/publican/wiki/Installing > > If you're using an operating system other than Fedora 13, the dependencies > might be somewhat different, but the procedure is otherwise the same. Any error > messages that you get while trying to run ./Build local will tell you what > dependencies you're missing. Ok, I think better wait for the update from Fedora 13 or Fedora 14, as the bug moved to MODIFIED state.
Jeff, I just build a hi-IN PDF in a website. publican build --embedtoc --formats=pdf --langs=hi-IN --publish publican install_book --site_config ./testsite.cfg --lang hi-IN [mstanley@cheezel testbook]$ pwd /home/mstanley/testbook/website/hi-IN/Documentation/0.1/pdf/testbook [mstanley@cheezel testbook]$ rpm -qa |grep publican publican-2.3-0.fc14.t51.noarch
(In reply to comment #10) > Jeff, I just build a hi-IN PDF in a website. The real test is whether Publican will package the PDF for /shipping/; you can test this by building the package with: publican package --binary --lang hi-IN Take a look in the web RPM and confirm that there's no pdf directory in there You could also install the package to verify that it installs cleanly, although unless you have a Publican-generated website at the default location (/var/www/html/docs) on your machine, you won't see much when you browse the results.
OK, testing the proper thing. When I installed the resultant RPM, no PDF was present in /var/www/html/docs/hi-IN/. Verified.
Technical note added. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. New Contents: Known issues are present in the tools that publican uses to render PDF documents. Consequently, rendering PDFs for Indic and right to left languages is broken. To work around the upstream issues, publican no builds PDFs when packaging the following languages: *
Publican 2.4 has shipped with a fix for this issue.
(I was delaying sending this, but it looks like FOP will still be with us for a while.) Please add the Indic language si-LK to the list. From what I can see in the one or two si-LK pdfs I looked at from docs.redhat.org, FOP output for this language suffers both from the font fallback problem (lots of text simply missing) and from poor shaping (resulting in vowel marks disconnected from their consonant). It looks like publican/lib/publican/Builder.pm is the only file that's affected. I attach an untested patch.
Created attachment 521580 [details] Add si-LK to the set of Indic languages (to be excluded from pdf generation). (Untested.)