http://blog.gmane.org/gmane.text.docutils.user hourly 1 1901-01-01T00:00+00:00 http://gmane.org/img/gmane-25t.png http://gmane.org http://comments.gmane.org/gmane.text.docutils.user/4714 ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Leo 2008-11-30T21:22:32 http://comments.gmane.org/gmane.text.docutils.user/4696 Hi, In a ReST file I have a custom interpreted text role called "graded" derived from the "strong" role. When writing HTML, I can use CSS to make that role styled the way I want--not only boldfaced, but a different color. I'd like to do something similar in LaTeX. I'm using rst2latex.py; I don't know if this matters. I kind of imagined that in the preamble for the written LaTeX file would be a command that initially defined "graded" as an alias for "strong", and called this graded role on the text that I used it for. Then I could customize the styling through a latex style file. Instead, I saw in the written file that text in the graded role is just marked up with standard \textbf{} and there's no way to distinguish that on the LaTeX level from text that I marked up in the regular strong role. I guess what I'm asking is if the class of the custom role gets passed to the LaTeX file anywhere. It seems not, since grepping the LaTeX file for the name of the custom role only tur Matthew Leingang 2008-11-18T13:33:46 http://comments.gmane.org/gmane.text.docutils.user/4691 Hi, Triying to install docutils, I have following error messages; ~/docutils-0.5/docutils/parsers/rst/states.py:2046 Deprecating Warning: Base Exception . Message has been deprecated as of Python 2.6 FAIL . test_node_class_names(test_nodes_MiscTests) FAILED (failures=1) I have to install the soft in order to use Salome, so I am really ....... What can I do ? Thanks a lot. jm ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ perpignan-66 2008-11-12T12:09:00 http://comments.gmane.org/gmane.text.docutils.user/4682 I've encountered a limitation of option lists: options may only have one option argument for the syntax requirements to be met. Something like this doesn't work: -r FROM TO, --replace=FROM TO replace "FROM" with "TO" I've seen a question on this list posted in September, which was about a similar issue: an option name that contains colons. The answer to that question was to use a simple name for that option and explain its syntax, which in the case of a path arguments sounds resonable. However, in my case, I find it misleading to use one option name for what is actually two option arguments, even if explained. Would it be possible to extend the syntax to allow for multiple option arguments, each of which might stay as simple as it is now? I'm not sure about getopt, whose supported syntax ReST's option lists are documented to implement, but multiple-argument options are well possible with Python's optparse standard module, so it's at least nothing wildly uncommon. Thomas Lotze 2008-11-11T17:05:28 http://comments.gmane.org/gmane.text.docutils.user/4680 Dear Docutils users, I have `plans for the latex2e writer development`__, but before changing too much I'd like to ask users about current use, preferences and wishes. __ http://docutils.sourceforge.net/sandbox/latex-variants/README.html (Sourceforge does no longer list directories without index file, see the content with SVN view under: http://svn.berlios.de/viewcvs/docutils/trunk/sandbox/latex-variants/) Questionaire ============ 1. Do you use custom stylesheets with Docutils-generated LaTeX files? 2. Would you prefer the stylesheet to be a LaTeX package: "*.sty" Input with \usepackage{}. +2 Existing LaTeX packages can be used as --stylesheet argument. +1 Command names can contain the char < at > (no \makeatletter needed). -1 Warnings, if home-made stylesheets do not use the proper LaTeX package commands. Expects the file extension ".sty": +1 Clear distinction between self-contained, complete LaTeX documents and styl Guenter Milde 2008-11-11T08:43:50 http://comments.gmane.org/gmane.text.docutils.user/4678 Hi folks, I'm trying to catch the docutils error within Leo (a python outlining editor), and I can't seem to understand how to capture the error. Here's what I'm trying: try: res = pub.publish(argv=['--stylesheet=%s' % path]) except Exception, inst: print type(inst) # the exception instance print inst.args # arguments stored in .args print inst # __str__ allows args to printed directly raise inst Anybody know of a way to do this? If I run docutils from the command line, I get: docutils.utils.SystemMessage: <string>:376: (SEVERE/4) Title level inconsistent: I'd love a way to capture the contents of that error message and display it somehow. TIA Mike ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin S Mike Crowe 2008-11-07T16:18:02 http://comments.gmane.org/gmane.text.docutils.user/4675 Here is the message I received when trying to run the tests. Thanks C:\docutils\test>python alltests.py Testing Docutils 0.6 [snapshot 2008-10-30, r5709] with Python 2.5.2 on 2008-10-3 1 at 07:59:57 Working directory: C:\docutils\test Docutils package: C:\docutils\docutils ..F............................................................................. ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................................................................................ ................. Shaun Mahood 2008-10-31T14:10:12 http://comments.gmane.org/gmane.text.docutils.user/4673 Dear list, I am trying to parse docstrings of my Python modules using the following code: output = core.publish_parts(source=open('a.py'), source_path='', source_class=io.FileInput, reader_name="Python", writer = myWriter(), settings_overrides=overrides) where myWriter is a customized LaTeX2e writer. I got an error for even a very simple module # a=1 'b' def a(): ' adfd' pass The error message is: Traceback (most recent call last): File "test_rst.py", line 86, in ? settings_overrides=overrides) File "/usr/lib/python2.4/site-packages/docutils/core.py", line 433, in publish_parts enable_exit_status=enable_exit_status) File "/usr/lib/python2.4/site-packages/docutils/core.py", line 614, in publish_programmatically output = pub.publish(enable_exit_status=enable_exit_status) File "/usr/lib/python2.4/site-packages/docutils/core.py", line 204, in publish self.settings) File "/usr/lib/python2.4/site-packages/docutils/readers/__init__.py", line 69, in read Bo Peng 2008-10-28T16:45:58 http://comments.gmane.org/gmane.text.docutils.user/4664 ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Michael Koitz 2008-10-21T14:06:27 http://comments.gmane.org/gmane.text.docutils.user/4656 Hi members of the docutils mailing lists! I've recently discovered reStructuredText and I'm really fascinated. I like it very much. However, what I'm missing are line breaks. Normally, each paragraph becomes a <p> when converting to HTML (or a similar construct when converting to other formats). But sometimes, you want to separate two blocks of text *without* putting an empty line in between. I thought thoroughly about how line breaks could be realized in a comfortable way. I came up with the following idea: An option to connect paragraphs: Instead of defining a "line break" symbol, making it possible to connect two or more paragraphs using two "connection symbols" ( eg. { and } ). I'm going to explain what I mean by using an example: { reStructuredText is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. RST is designed for extensibility for specific application domains. Its parser is a component of Docutils. } This document defines Red Wraith 2008-10-19T16:06:27 http://comments.gmane.org/gmane.text.docutils.user/4651 ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Ryan Krauss 2008-10-17T11:50:20 http://comments.gmane.org/gmane.text.docutils.user/4646 Hi all. I did a cool hack recently, very similar in spirit to the rst-literals script I had written a while ago that can extract literal-blocks from ReST files. This time, instead of literal-blocks, I'm extracting field-lists that are embedded within a definition term that is a single word within brackets (see example below). It's entirely generic, you can define any kind of "object" and columns. The script is in my sandbox, feel free to try it out, I tried to make it as "automatic" as possible. If you have a postgres server and psycopg2, it should just be able to create database tables from rst documents, provided they contain entries as below. Anyway, here are the docs, any comments appreciated. Extract and store data entries from a set of reStructuredText documents. Entries look like this (all names are generic):: [book] :title: Probability Theory :subtitle: The Logic of Science :authors: E.T. Jaynes, G. Larry Bretthorst :isbn: 978-0521592710 You can have the data stored in an e Martin Blais 2008-10-09T20:19:32 http://comments.gmane.org/gmane.text.docutils.user/4643 Consider http://mentat.za.net/numpy/numpy_advanced_slides/ Do you know why the display get muddled if you switch to full screen on FireFox 3? It seems to be a problem with the fixed-width font display? This is the first time I've ever experienced better performance on IE than FireFox. Is it just the display I am using at work, or a known bug, or ...? Thanks, Alan Isaac ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Alan G Isaac 2008-10-09T17:43:38 http://comments.gmane.org/gmane.text.docutils.user/4639 ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Ryan Krauss 2008-10-09T02:25:59 http://comments.gmane.org/gmane.text.docutils.user/4637 I'm using rest2web_ to maintain my website, so all my individual pages are in restructured text. If you're not familiar with it, rest2web basically calls something like docutils.core.publish_parts(...writer_name='html'...) for each page in a directory. I've run into the situation where I have a paragraph in one page that I'd like to link to from another page. Specifically, I want to link to a single publication in a list of publications, something like:: ... some publications ... Steven Bethard, James H. Martin and Sara Klingenstein. `Finding Temporal Structure in Text: Machine Learning of Syntactic Temporal Relations`_. *International Journal of Semantic Computing (IJSC)*, 1(4), December 2007. ... more publications ... Now, since it's just a plain paragraph, the html writer just doesn't output an element that I can link to. It outputs just a simple paragraph like:: <p>Steven Bethard, James H. Martin and Sara Klingenstein... What can I do to get an id for the paragraph elemen Steven Bethard 2008-10-03T16:35:36 http://comments.gmane.org/gmane.text.docutils.user/4629 Howdy all, I'm glad to see that Engelbert Gruber <grubert< at >users.sf.net> has made available a ManPage writer for Docutils <URL:http://docutils.sourceforge.net/sandbox/grubert/man/>. What I don't know is how to make use of this. I don't want to hack on the installed docutils software; that's managed by my operating system package manager and it would be a mistake to mess about manually with those files. Ideally what I'd like is to have an ‘rst2man’ command that uses Engelbert's work as a writer with the existing docutils. Failing that, I'd like to see what is needed to get us there. I've read some of the documentation at the Docutils site, but e.g. <URL:http://docutils.sourceforge.net/docs/dev/hacking.html> says little more on this topic than “Figure out whether you want a Parser, a Transform, or a Writer”. Well, that decision is already made — I need a Writer, and fortunately I have one — but now what? I realise it's not as simple as:: $ cp -a man/ $HOME/.docutils/writers/. $ docutil Ben Finney 2008-09-30T09:36:12 http://comments.gmane.org/gmane.text.docutils.user/4628 Moin, I use REST with Plone and have questions about field list. I'm not sure if this are REST or Plone Problems. 1. If the fieldname is longer then 14 characters the column is rendered with colspan=2 and the value is rendered in the next row. Is it possible to set the width of the fieldname? 2. There is a colon set after the fieldname. Is it possible to supress this colon? 3. If I put a fieldlist after a fieldlist separated by a linefeed the are rendered as one table. I put commets between to get two tables. How do I separate fieldlist? Many thanks Matthias ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ Matthias Teege 2008-09-30T07:12:46 http://comments.gmane.org/gmane.text.docutils.user/4625 The site updating script can no longer be run. SF no longer offers shell access, although that may be temporary. Details here: http://sourceforge.net/community/forum/topic.php?id=3518&page http://sourceforge.net/community/forum/topic.php?id=3505&page The updating script is here: http://svn.berlios.de/viewcvs/*checkout*/docutils/trunk/sandbox/infrastructure/docutils-update The script needs to be reworked to use SCP instead of SSH. It should probably be reworked to checkout the repo & build the site locally, instead of executing on the berlios.de server. I don't have time to work on this right now. Can anybody help with this? David Goodger 2008-09-25T14:52:12 http://comments.gmane.org/gmane.text.docutils.user/4621 I am trying to implement a math directive using matplotlib and am running into a problem. Here's my directive: class Math(rst.Directive): has_content = True def run(self): # Raise an error if the directive does not have contents. #self.assert_has_content() return [ math_node(''.join(self.content),''.join(self.content)) ] def __repr__(self): return u''.join(self.content) class math_node(Element): children = () def __init__(self,data,rawsource): Element.__init__(self,rawsource) self.rawsource=rawsource self.math_data=data directives.register_directive('math', Math) It works great when I use it like this: .. math:: $\alpha$ Or like this: .. math:: $\alpha$ But this gives me a warning: .. |AA| math:: $\alpha$ <string>:15: (WARNING/2) Substitution definition "AA" empty or invalid. .. |AA| math:: $\alpha$ So I am getting a "problematic" node in the output. and I get the alpha at the place where the subst is defined ins Roberto Alsina 2008-09-25T02:26:47 http://comments.gmane.org/gmane.text.docutils.user/4614 Hi all, We have recently started using docutils to document some of our COM interfaces using docs embedded in the code, the results have been very pleasing, but I want to ask if we are approaching one aspect of the documentation design in the right way. We wanted to have some markup to document the parameters and return values to each of the functions, so I came up with the following directive syntax. .. param :: ParamName Documentation for ParamName here. .. return :: Something Useful. I register the directives using register_directive, and this all works wonderfully for our html generated documentation. (ultimately in a .chm shudder!) However, we also generate a python wrapper and use the same documentation for the docstrings, so that each function looks like this def Function(ParamName) : """Blah. ..param :: ParamName Documentation for ParamName here. .. return :: Something Useful. """ So the problem with this is that although it is perfectly re Sam Partington 2008-09-23T10:11:03 http://comments.gmane.org/gmane.text.docutils.user/4612 Hi all -- At work, my colleagues and I need to write some good old-fashioned Unix man pages. So we brainstormed for 15 seconds or so and came up with a list of candidate markup systems: asciidoc, POD, and docutils/rST. We have an intern doing the gruntwork, so all I have to do is stand back while he evaluates the contenders and make sure he picks the right one. ;-) To my surprise, it appears that the right choice is still, after all these years, POD. If I understand things correctly, docutils has no support for generating man pages out of the box. You have to checkout http://svn.berlios.de/svnroot/repos/docutils/trunk/sandbox/manpage-writer separately and use its rst2man script. Furthermore, the sandbox manpage-writer appears to be in a state of flux: for example, it crashes on its own man page (rst2man.txt) because of some NotImplemented exceptions in the code. So what's the deal with this code? Is it being actively developed as we speak? Or is it in need of a little attention? Thanks -- Greg Ward 2008-09-22T14:39:44 Search the mailing list at Gmane query http://search.gmane.org/?group=$group=gmane.text.docutils.user