Changes between Initial Version and Version 14 of Ticket #61


Ignore:
Timestamp:
Oct 15, 2012, 4:24:16 PM (12 years ago)
Author:
jimk
Comment:

Replying to EliL:

I was getting the same error (SEVERE/4) with r922.

More info about 10.04 with sphinx 0.6.4-1: now builds (html and pdf) with the following change:

-.. include:: /info/why_abstract.txt
+.. include:: ./why_abstract.txt

Can you test that on your systems?

That works the same as

include:: why_abstract.txt

for me.

BTW: Sphinx 1.1.3 from easy_install (in a virtualenv) behaves the same as the server does for me on my Ubuntu machine.

I think the "problem" is how sphinx is treating nested includes.

HTML:
welcome.txt->info/why_abstract.txt
welcome.txt->info/why.txt->info/why_text.txt->info/why_abstract.txt

LaTeX:
welcome.txt->info/why_text.txt->info/why_abstract.txt

BTW: all this silliness is because for the print version it makes sense to have the full "Why GeoMOOSE" section inline, but for the web version it just has the abstract and links off to the full document.

In old sphinx it seems to be including relative to the previous file. In 1.1.3 it seems to be including relative to the first file. I wonder which one is "correct"?

http://docutils.sourceforge.net/docs/ref/rst/directives.html#include reads to me that the relative to the including document behavior of older sphinx versions is "correct".

Legend:

Unmodified
Added
Removed
Modified
  • Ticket #61

    • Property Owner changed from EliL to jimk
    • Property Status newtesting
    • Property Version2.6
  • Ticket #61 – Description

    initial v14  
    44cd /usr/local/src/geomoose/geomoose2/branches/geomoose-2.4/sphinx-docs/
    55make latex
     6
    67cd build/latex/
    78make all-pdf