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 }}}