Changes between Version 23 and Version 24 of Building/MacOSX


Ignore:
Timestamp:
Jul 14, 2011 12:35:27 PM (4 years ago)
Author:
igloo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Building/MacOSX

    v23 v24  
    9090== Building the documentation ==
    9191
    92 If you have installed {{{docbook-xsl}}} using macports then the configure script might still tell you that you are unable to build the HTML documentation due to missing stylesheets. This is because it is using the {{{xsltproc}}} supplied with OS X rather than the one MacPorts installs, but you can work around it by adding the following to your {{{.bash_profile}}}:
     92For some reason, convincing dblatex ti build the docs can be tricky. This worked for me:
    9393
     94From http://www.tug.org/mactex/ downloaded and installed
     95    http://mirror.ctan.org/systems/mac/mactex/MacTeX.mpkg.zip
     96
     97From http://dblatex.sourceforge.net/ downloaded and built
     98    http://prdownloads.sourceforge.net/dblatex/dblatex-0.3.tar.bz2?download
     99
     100Now building users_guide.pdf will fail, as we generate things like:
    94101{{{
    95 export XML_CATALOG_FILES="/opt/local/etc/xml/catalog"
     102    ?t\nolinkurl{?uC:\Documents?u}\texttt{\ }\nolin[...]
    96103}}}
     104rather than:
     105{{{
     106    ?t\nolinkurl{?uC:\\Documents?u}\texttt{\ }\nolin[...]
     107}}}
     108(note number of backslashes). To fix this, patch param.xsl:
     109{{{
     110--- param.xsl   2011-03-18 18:10:23.000000000 +0000
     111+++ /usr/share/dblatex/xsl/param.xsl    2010-10-27 08:56:16.000000000 +0100
     112@@ -16,7 +16,7 @@
     113 <xsl:param name="latex.class.article">article</xsl:param>
     114 <xsl:param name="latex.class.book">report</xsl:param>
     115 <xsl:param name="latex.unicode.use">0</xsl:param>
     116-<xsl:param name="texlive.version">2010</xsl:param>
     117+<xsl:param name="texlive.version">2009</xsl:param>
     118}}}
     119This is a little odd. The Debian package has this patch applied, and on
     120Debian:
     121{{{
     122$ latex --version
     123pdfTeX 3.1415926-1.40.10-2.2 (TeX Live 2009/Debian)
     124[...]
     125}}}
     126but on OS X:
     127{{{
     128$ latex --version
     129pdfTeX 3.1415926-1.40.11-2.2 (TeX Live 2010)
     130[...]
     131}}}
     132so it doesn't seem like it should be needed. But anyway...
    97133
    98 Further info on building the docs from #3768:
     134Now the PDF will fail to build with:
     135{{{
     136makeindex: Not writing to /private/tmp/tmpw4xTzV/users_guide.ind (openout_any = p).
     137Can't create output index file /private/tmp/tmpw4xTzV/users_guide.ind.
     138}}}
     139So we put
     140{{{
     141openout_any = r
     142}}}
     143in `/usr/local/texlive/2010/texmf.cnf`
    99144
    100 Some packages needed XCode 3.1, which for OS X 10.5 you can currently only get bundled with the iphone SDK as far as I can tell.
     145And the docs will finally build!
    101146
    102 Then, to fix:
    103 
    104 {{{
    105 $ "/opt/local/bin/dblatex"  docs/users_guide/users_guide.xml --ps -o docs/users_guide/users_guide.ps
    106 Traceback (most recent call last):
    107   File "/opt/local/bin/dblatex", line 16, in <module>
    108     from dbtexmf.dblatex import dblatex
    109 ImportError: No module named dbtexmf.dblatex
    110 }}}
    111 
    112 do:
    113 
    114 {{{
    115 sudo port install python_select
    116 sudo python_select python26
    117 }}}