Hi,

I'm still woking on improving the documentation of nipype 
<http://nipy.sourceforge.net/nipype/index.html>.

I have noticed that some doc generated from python sources have some 
formatting issues. Unfortunately, the online versions are a bit different 
than the github versions (it's for the stable release nipype 0.10) so it's 
hard to show examples.

An example of badly formatted online example is here: 
http://nipy.org/nipype/users/examples/fmri_ants_openfmri.html (I think that 
it is based on this version: 
https://github.com/nipy/nipype/blob/ab7ce7da606cf3b9dde7c218b2c98535c3700fb0/examples/fmri_ants_openfmri.py).
 
The troubles are 2 fold:
  - the first bloc of code is not syntax-higlighted 

  - code below the "Example" is not correctly indented
Another file that creates similar problem is here: 
https://github.com/nipy/nipype/blob/master/examples/rsfmri_vol_surface_preprocessing_nipy.py
 
. I have been able to slightly improve the situation by removing the `::` 
from lines 351, 355 and 362 but there are still issues. Similar 
modifications have been done on the first example so I guess it's a good 
starting point.

However, in both cases, the indentation remains problematic after the first 
bloc of code. I guess it's because some strings are used to split the 
functions (see for instance lines 417 and 430 in the second file).

Can anybody provide a hint on how to circumvent this problem?

Thanks in advance,
Mathieu

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to