headers
Stefan Ulbrich | 6 Feb 11:54
Picon
Gravatar

Signature introspection from docstring

Hello List,

I want to expose a Python module via XML-RPC to a C++ program and want my server to provide function
signatures with type information. 
The signature should be automatically generated and all methods in the module are extensively documented
with ":param:" and ":type:".
For now, I use regular expressions to extract the description but I wonder if I can also use the docutils. Can
anybody give me a hint 
at which part of docutils to look if this is possible? 

Best,
Stefan
------------------------------------------------------------------------------
Try before you buy = See our experts in action!
The most comprehensive online learning library for Microsoft developers
is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3,
Metro Style Apps, more. Free future releases when you subscribe now!
http://p.sf.net/sfu/learndevnow-dev2
Permalink | Reply | 1 comment |
headers
Peter L. Soendergaard | 1 Feb 13:50
Picon
Gravatar

Latex in $ ... $

Hi everyone,

I just subscribed to this list, so I am not sure if this has been
discussed before.

I am adapting reST to work for Matlab headers for two open source
toolboxes that I am managing, LTFAT and AMToolbox.

As many of my constributors are mathematicians, or are used to working
with Latex, it is much more natural for them to use the $...$ markup
instead of the :math:`...` markup for inline formulas.

Currently I solve this by a simple Python preprocessing script that
convert pairs of $ into the correct role, but I was wondering if there
was a more clean solution to achieve this.

Cheers,
Peter.

------------------------------------------------------------------------------
Keep Your Developer Skills Current with LearnDevNow!
The most comprehensive online learning library for Microsoft developers
is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3,
Metro Style Apps, more. Free future releases when you subscribe now!
http://p.sf.net/sfu/learndevnow-d2d
Permalink | Reply | 2 comments |
headers
Pulkit Kathuria | 29 Jan 12:18
Picon
Gravatar

input rst file inside rst

Dear Users,

I googled quite a bit but couldn't find an answer to this:

for example I have two rst files, how can i input one rst file into  
another. Similar to input a latex file into another main latex document.

May be the explanation is not good,
two files like this

second.rst

some section here in second
---------------------------------

one.rst

.. input:: second.rst here (what is the syntax?)

so if I do rst2html.py one.rst will include the text from second.rst  
as well
Thanks

------------------------------------------------------------------------------
Try before you buy = See our experts in action!
The most comprehensive online learning library for Microsoft developers
is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3,
Metro Style Apps, more. Free future releases when you subscribe now!
http://p.sf.net/sfu/learndevnow-dev2
(Continue reading)

Permalink | Reply | 1 comment |
headers
Daniel | 26 Jan 23:20
Picon
Gravatar

Bold Links

Hello,

is it possible to create a bold link?

Nothing I tried worked:

`**foo bar**`__
**`foo bar`__**
:strong:`foo bar`__

Best regards,
Daniel

------------------------------------------------------------------------------
Try before you buy = See our experts in action!
The most comprehensive online learning library for Microsoft developers
is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3,
Metro Style Apps, more. Free future releases when you subscribe now!
http://p.sf.net/sfu/learndevnow-dev2
Permalink | Reply | 1 comment |
headers
Randy Syring | 17 Jan 19:34
Picon

Generating just a TOC (in HTML)

I would like to be able to generate just a TOC as HTML for a document 
and then insert it into a different part of the webpage.

I am currently using publish_parts to insert just the body of my 
document into a web application.  But I want the TOC in the sidebar of 
my site, so having it generate as part of the main reST HTML isn't 
working very well.

--

-- 
-------------------------------------
Randy Syring
Intelicom | Level 12
Direct: 502-276-0459
Office: 502-212-9913

For the wages of sin is death, but the free gift of God
is eternal life in Christ Jesus our Lord (Rom 6:23)

------------------------------------------------------------------------------
Keep Your Developer Skills Current with LearnDevNow!
The most comprehensive online learning library for Microsoft developers
is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3,
Metro Style Apps, more. Free future releases when you subscribe now!
http://p.sf.net/sfu/learndevnow-d2d
Permalink | Reply | 2 comments |
headers
Justin Haynes | 13 Jan 01:23
Picon

html4css1 writer

There are a few posts around with similar questions, so I'm sorry if I 
didn't find an obvious answer.  But, is there a way to disable the 
colgroup html code from __init__.py?

I'd love to have auto sized column widths in the html output.  If not, 
is it on the todo list?  I didn't see it there either.

Thanks!

Justin

------------------------------------------------------------------------------
RSA(R) Conference 2012
Mar 27 - Feb 2
Save $400 by Jan. 27
Register now!
http://p.sf.net/sfu/rsa-sfdev2dev2
Permalink | Reply | 0 comments |
headers
Lewis | 12 Jan 14:29
Favicon

No such file or directory: html4css1.css - system exit

David,

You are most likely aware that the Leo-editor project makes use of Docutils.
I downloaded and installed Docutils snapshot on 10/01/2011 and the installation
was successful.
However when I ran leo-editor it gave a traceback which I reported as a bug
https://bugs.launchpad.net/leo-editor/+bug/914221

To summarise - docutils performs a system exit when it fails to find the
html4css1.css1 file. I hope the leo bug link is sufficient for you but please
ask if you need any more information or want me to try and reproduce the
traceback.

I am not subscribed to the mailing list.

Regards
Lewis

------------------------------------------------------------------------------
RSA(R) Conference 2012
Mar 27 - Feb 2
Save $400 by Jan. 27
Register now!
http://p.sf.net/sfu/rsa-sfdev2dev2
Permalink | Reply | 3 comments |
headers
Randy Syring | 5 Jan 17:36
Picon

Assign class directly to heading elements

I am currently trying to get a class on an HTML heading element.  I have 
tried two variations:

> .. role:: ph
>     :class: primary-heading
>
> :ph:`About Us`
> ~~~~~~~~~~~~~~

but this results something like "<h1><span 
class="myclass">foo</span></h1>, which doesn't work for the CSS I am using.

I have also tried:

> .. class:: primary-heading
>
> About Us
> ~~~~~~~~~~~~~~

Which results in the class on the section that contains the 
heading...this latter one will work, but requires tweaking some CSS
and I would prefer that the current styles apply as-is.  Is there a way
to target the heading element directly with a class?

Thanks.

--

-- 
-------------------------------------
Randy Syring
Intelicom | Level 12
(Continue reading)

Permalink | Reply | 1 comment |
headers
Maxime Henrion | 4 Jan 14:09
Picon

reStructuredText parser doesn't scale linearly with the input file size

Hello all,

I have been trying to use rst2pdf to produce potentially very large
documents containing patches, such as those produced by a ``cvs diff''
command.

Unfortunately, I have observed that the rst2pdf code doesn't seem to
scale linearly with the size of the input file size, and when files
get large, it starts taking so much time to run that it becomes
completely unusable for me (I had one such run taking ~9 hours). This
behaviour gets easy to observe using ~2MB .rst files, at least with
the hardware I'm using. Here are some more data points :

$ ls -l foo*.rst
-rw-r--r-- 1 mhe dev 3900918 Jan  3 15:34 foo2.rst
-rw-r--r-- 1 mhe dev 1950459 Jan  3 15:33 foo.rst

The foo2.rst file is the foo.rst file concatenated with itself, and is
thus exactly two times the size of foo.rst.

$ time rst2pdf -c -o foo.pdf -s doc/sdlc.stylesheet
--custom-cover=doc/cover.tmpl foo.rst

real 9m1.998s
user 8m27.206s
sys 0m33.631s

$ time rst2pdf -c -o foo.pdf -s doc/sdlc.stylesheet
--custom-cover=doc/cover.tmpl foo2.rst
(Continue reading)

Permalink | Reply | 5 comments |
headers
Justin Haynes | 14 Dec 19:54
Picon

.. include inline

So first off, I am way new to docutils!  I'm using sphinx to generate a document but I want to include data from csvs inline.  


For example:  

i want to read data from a file called surveyed.csv into a sentence that reads:

The number of people surveyed was ___ .  

where the blank is the number contained in the first column of the second row of the csv.  if necessary, the csv can be output as a single number with no header or extra columns.


I'm sure this is easy, but I'm at a loss!!


Thanks,

Justin
------------------------------------------------------------------------------
Cloud Computing - Latest Buzzword or a Glimpse of the Future?
This paper surveys cloud computing today: What are the benefits? 
Why are businesses embracing it? What are its payoffs and pitfalls?
http://www.accelacomm.com/jaw/sdnl/114/51425149/
Permalink | Reply | 2 comments |
headers
Fays Dominique | 13 Dec 16:06
Favicon

figure or table numbering in reST

   Hi,

 

I do not find a way to number automatically figures or tables. This exists in TeX, does it exists in rest?

 

Thanks in advance.

 

Best regards,

 

   Dominique

 

------------------------------------------------------------------------------
Systems Optimization Self Assessment
Improve efficiency and utilization of IT resources. Drive out cost and 
improve service delivery. Take 5 minutes to use this Systems Optimization 
Self Assessment. http://www.accelacomm.com/jaw/sdnl/114/51450054/
Permalink | Reply | 1 comment |

Gmane