[
https://issues.apache.org/jira/browse/SOLR-4886?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Hoss Man updated SOLR-4886:
---------------------------
Attachment: solr-110713-0027-9170__using_freefonts_withencoding.pdf
Woot!
Progress!!!!
doing a little supposing and speculating and reading between the lines, i think
i've pretty much got this solved...
i started with the knowledge that that PDFs generated by confluence say they
are produced by "iText" and did some googling and reading about iText and then
noticed a project named "Flying Saucer" uses the iText java library to convert
XHTML+CSS -> PDF, and then remembered that the Confluence PDF conversion pages
are named things "flyingpdf/doflyingpdf.action". reading up on flying saucer i
found [this page|http://minaret.biz/tips/fs/index.html] which had a note that
jumped out at me...
{quote}
In the style section of your xhtml document (or in a separate style sheet),
register any special fonts you will be using and indicate where the font files
are located. For example, to register Arial Unicode MS:
{code}
@font-face {
src: url(file:///Absolute/path/to/font/directory/ARIALUNI.TTF);
-fs-pdf-font-embed: embed;
-fs-pdf-font-encoding: Identity-H;
}
{code}
{quote}
The attached solr-110713-0027-9170__using_freefonts_withencoding.pdf shows the
results of generating the PDF with this new "-fs-pdf-font-encoding: Identity-H"
specified in the stylesheet.
Happy! Happy! Joy! Joy! ... Arabic, Greek, Hindi all look great -- the only
problem is the asian langauges, which i realize now should be expected based on
the documented coverage from the freefonts...
* https://www.gnu.org/software/freefont/coverage.html
* https://www.gnu.org/software/freefont/FAQ.html
So on the plus side: I've figured out how to use any font we want to display
these examples properly i nthe PDF
Negative side: still need to find a good font.
I'm currently thinking that the Ubuntu font would be good, since it seems to
handly just about everything i can throw at it...
http://font.ubuntu.com/
...i'm just not 100% certain that i understand what we need to do to comply
with the licensing rules ... my reading of hte ubuntu font license seems to
suggest that embedding the font in documents doens't require anything special,
but ASF Legal has put it in "[category
b|https://www.apache.org/legal/resolved.html#category-b]"; (see LEGAL-163). i
*think* that means that as long as we only distribute the PDF with the font
embedded, but do not publicly distribute the fonts themselves we're fine ...
but i think that probably means we need to have infra copy the fonts onto the
confluence box instead of pulling them from an http://lucene.apache.org/... URL
like i was planning on.
> configure, test, and document PDF export process of SOLR CWIKI
> --------------------------------------------------------------
>
> Key: SOLR-4886
> URL: https://issues.apache.org/jira/browse/SOLR-4886
> Project: Solr
> Issue Type: Sub-task
> Components: documentation
> Reporter: Hoss Man
> Assignee: Hoss Man
> Attachments: solr-090713-2308-8288.pdf,
> solr-100713-2311-9042__using_freefonts.pdf,
> solr-110713-0027-9170__using_freefonts_withencoding.pdf, tmp.html
>
>
> * add the ASL as a page in the wiki such that it appears early in the
> exported PDF
> * test that exporting the PDF works ok with the large space
> * review the exported PDF for problems
> * confirm/tweak-configs so that PDF exporting can done really easily, ideally
> automatically
> * document/script steps to create PDF on each solr release.
> Lots of tips here:
> https://confluence.atlassian.com/display/DOC/Providing+PDF+Versions+of+your+Technical+Documentation
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
