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/7026 <pre>Hi, I have been experimenting with the --use-bibtex=mybibsty,mybib option. The good news is I am able to this to properly process citations in reST. But the latex translation creates tex code on processing which has two references sections. Is this the way it is supposed to work? What am I doing wrong? Here is my example: - This reST snippet (extracted and edited): Here is a citation [HLD+00]_. Here is more text with citations [PM60]_. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus accursus commodo, tortormauris condimentum nibh, ut fermentum massa justo sit ametrisus. Etiam porta sem malesuada magna mollis euismod [Dwy04]_. .. [HLD+00] .. [PM60] .. [Dwy04] - Produces this tex (extracted and edited): Here is a citation \cite{HLD+00}. Here is more text with citations \cite{PM60}. Donec id elit non mi porta gravida at eget metus. Fusce dapibus, tellus ac cursus commodo,tortor mauris condimentum nibh, ut fermentum massa justo sit ametrisus. Etiam porta sem malesuada magna moll</pre> Michael Prisant 2013-05-13T16:50:41 http://comments.gmane.org/gmane.text.docutils.user/7023 <pre>Dear Group, Let's say I have a custom restructured text directive of the following form in the string "content": .. bibentries:: BCC+87;; For the purpose of this question when I call print publish_string( source=content, writer_name='html',settings_overrides=overrides) I would like to emit something similar to the following in my html stream: &lt;pre&gt; This is the html bibdirective &lt;/pre&gt; and when I call: print publish_string( source=content,writer_name='latex2e',settings_overrides=overrides) to emit something similar to the following in my latex stream: /begin{verbatim} This is the latex bibdirective /end{endverbatim} Of course in my real code I do some munching on the content of bibdirective but for the purposes of this example/question I'll work with this simplification. In any case I have written code for a custom directive as follows:: class BibDirective(Directive): has_content = True def run(self): self.assert_has_content() text = '&lt;pre&gt; This is the html bibdirect</pre> Michael Prisant 2013-05-08T11:48:29 http://comments.gmane.org/gmane.text.docutils.user/7015 <pre> Please download the file form:http://s.yunio.com/faEmEkUnzip it and cd into ./buildOpen the file index.html in chrome or firefox.There is a file Chapter 1: Introduction to Django in it.Why the seach function can't be used? ------------------------------------------------------------------------------ Introducing AppDynamics Lite, a free troubleshooting tool for Java/.NET Get 100% visibility into your production application - at no cost. Code-level diagnostics for performance bottlenecks with &lt;2% overhead Download for free and get started troubleshooting in minutes. http://p.sf.net/sfu/appdyn_d2d_ap1</pre> 13718354131 2013-05-06T04:53:12 http://comments.gmane.org/gmane.text.docutils.user/7009 <pre>Hi, I'm likely to have many dozens of lists, many nested. I would like to defer a decision on how to format the enumeration sequences, so I can change my mind later on without having to do lots of manual editing. I thought the "replace" directive would be what I wanted, but it doesn't seem to work: Instead of: #. abc #. def have: |seq1|. abc #. def .. |seq1| replace:: a or: |seq1| abc #. def .. |seq1| replace:: a. Neither of these options (nor a few variations) work. The first gives "a. abc #. def" on one line, and the second results in an error in the replace directive (something to do with the period - maybe a bug?). Using ".. |seq1| replace:: a\." solves the error, but gives the result of the first option. What is the best way to be able to specify the starting enumeration of multiple separate lists without having to edit each list? I want to specify the starting enumeration for each nesting level (e.g. |seq1|, |seq2|, |seq3|) Cheers, Carl. --------------------------------------------------------</pre> Carl Cerecke 2013-05-02T09:40:55 http://comments.gmane.org/gmane.text.docutils.user/7004 <pre>I want to create a directive that will insert some dynamically generated reST into a document. The actual use case is to insert a passage from the bible by reference. (Most of the time, a bible-reference becomes a hyperlink, and that is achieved with a custom role, but sometimes, I'd like to insert the entire passage into the document). I want to be able to write: .. bible-passage:: John 1:1-4 and have the actual text of John 1:1-4 appear in the document. This needs to be dynamic, as the documents are bible-version independent-- the bible version is specified as one of the build parameters. There will possibly be some formatting involved as well - some verses are poetry and are laid out as such. Some verses have translational footnotes which need to appear. Some use of italics, and small-caps. As far as I can see, there are two options: 1. Have the new directive generate nodes directly in the node tree. 2. Have the new directive generate reST that it recursively parses and then inserts the resulting node</pre> Carl Cerecke 2013-04-24T21:34:51 http://comments.gmane.org/gmane.text.docutils.user/6997 <pre>What would be the best way to put draft comments in a rST document? Ideally I'd like them rendered something like a LaTeX margin note or the equivalent construct as HTML (whatever that might be). Also, they need to be able to turned on/off depended on whether I'm building in 'draft' mode or not. I'm currently using sidebar, but want to know if there is a better way Cheers, Carl. ------------------------------------------------------------------------------ Precog is a next-generation analytics platform capable of advanced analytics on semi-structured data. The platform includes APIs for building apps and a phenomenal toolset for data science. Developers can use our toolset for easy data analysis &amp; visualization. Get a free account! http://www2.precog.com/precogplatform/slashdotnewsletter</pre> Carl Cerecke 2013-04-19T09:02:47 http://comments.gmane.org/gmane.text.docutils.user/6994 <pre>Hi, How to make a right aligned grid or simple table(whole table) with coloured background. Thanks in Advance </pre> Sathiyan.S 2013-04-18T09:35:37 http://comments.gmane.org/gmane.text.docutils.user/6983 <pre>Hi, I am currently working with the rst2beamer project: https://github.com/rst2beamer It uses the publish_cmdline: https://github.com/rst2beamer/rst2beamer/blob/master/rst2beamer.py#L1472 I wish to implement a feature whereby only the Latex body part is published through a command line interface, so that I can pull in the resulting LaTeX via \input. I had a look at the documentation at: http://docutils.sourceforge.net/docs/api/publisher.html But it is so sparse that I can not wok out where to begin. My first guess was to do: publish_cmdline(writer_name='html', description=description, parts='body') But this keyword argument isn't accepted. Any and all help and pointers appreciated. Please help. V- ------------------------------------------------------------------------------ Precog is a next-generation analytics platform capable of advanced analytics on semi-structured data. The platform includes APIs for building apps and a phenomenal toolset for data science. Developers can use our toolset </pre> Valentin Haenel 2013-04-11T09:22:10 http://comments.gmane.org/gmane.text.docutils.user/6981 <pre>Hi, I just started playing with ReST, and now I want to include a code snippet from a source xml file. If I copy/paste the content of the file into a code block using .. code-block:: xml, the syntax highlighting works fine, but if I use the inlude directive with the code option set to xml (as shown below), the code is NOT syntaxt highlighted. Am I using the option the wrong way or is something else amiss? I'm using Sphinx as the build tool. I've declared the include block like this: .. include:: ../TestFiles/test.mdml.xml :code: xml Regards Rikke Hamilton ________________________________ Please consider the environment before printing. &lt;/pre&gt; &lt;div style="FONT-FAMILY: arial;color:#525759;font-size:9pt; margin-top:15px"&gt;This e-mail and any attachments are intended only for the named recipient(s) and may contain information that is legally privileged, confidential, or exempt from disclosure under applicable law. This message may be logged for archival purposes, may be reviewed by parties at Deltek o</pre> Rikke Hamilton Persson 2013-04-10T08:36:23 http://comments.gmane.org/gmane.text.docutils.user/6976 <pre>With reStructured Text, is there any way to produce either bold fixed-space text or bold italic text? If not, I'd like to suggest that adding support for these text styles be added. ------------------------------------------------------------------------------ Minimize network downtime and maximize team effectiveness. Reduce network management and security costs.Learn how to hire the most talented Cisco Certified professionals. Visit the Employer Resources Portal http://www.cisco.com/web/learning/employer_resources/index.html </pre> Phillip M. Feldman 2013-04-08T06:10:39 http://comments.gmane.org/gmane.text.docutils.user/6971 <pre>I'm investigating reST as a primary source for a biblical-commentary modernisation project. reST ticks most of the boxes - multiple output formats (targeting html and pdf initially), relative simplicity, an "include" capability, extensibility. But one thing that is a potential roadblock is a convenient way to represent verse references: I want output formats to be able to link to an online bible-reference provider for verse references. So, for example, text can include a bible reference like John 3:16, which in the output that text is a hyperlink to an online verse provider. The catch is that I want the hyperlink to be specified during output generation time (different websites/bible version, perhaps). Other complications include specifying verse ranges (so a simple pre-generated enumeration of all verses won't work), and the text of the reference can be different from the reference itself (e.g. "we see in verse 16 that ...", where "verse 16" should be a reference to "John 3:16" (or verse 16 of whatever ch</pre> Carl Cerecke 2013-04-06T01:40:03 http://comments.gmane.org/gmane.text.docutils.user/6965 <pre>I converted all my usage text to ReST and generate man pages from it using a make action like this: $(MANDIR)/%.1 : $(SRCDIR)/%.sh rm -f $&lt; at &gt; bash $&lt; -h 2&gt;&amp;1 | rst2man \ | sed -e '/^\.de1 rstReportMargin/,/^\.\./d' \ -e '/^\.de1 INDENT/,/^\.\./d' \ -e '/^\.de UNINDENT/,/^\.\./d' \ | egrep -v '^\.(UN)?INDENT' &gt; $&lt; at &gt; chmod 0444 $&lt; at &gt; $(MANDIR)/%.1 : $(SRCDIR)/%.py rm -f $&lt; at &gt; python $&lt; -h 2&gt;&amp;1 | rst2man \ | sed -e '/^\.de1 rstReportMargin/,/^\.\./d' \ -e '/^\.de1 INDENT/,/^\.\./d' \ -e '/^\.de UNINDENT/,/^\.\./d' \ | egrep -v '^\.(UN)?INDENT' &gt; $&lt; at &gt; chmod 0444 $&lt; at &gt; This works okay, but little workarounds I need for clean rst2man output will now turn up when I run the program with the -h flag. I would prefer it if my usage() functions ran rst2man or equivalent (is there an rst2text program?). I took a look at the API documentation, but didn't see anything simple. Most stuff seemed to be geared toward people publishing to new formats. Is there a simple API that takes a string in ReST format as i</pre> Skip Montanaro 2013-04-04T18:43:19 http://comments.gmane.org/gmane.text.docutils.user/6964 <pre>Hi all, Just joined this list. Thought I should point out there's a trailing '.' sabotaging the NNTP link on the Docutils Mailing Lists page (http://docutils.sourceforge.net/docs/user/mailing-lists.txt). It's at/near line 64. Cheers, Patrick ------------------------------------------------------------------------------ Minimize network downtime and maximize team effectiveness. Reduce network management and security costs.Learn how to hire the most talented Cisco Certified professionals. Visit the Employer Resources Portal http://www.cisco.com/web/learning/employer_resources/index.html </pre> Patrick O'Keeffe 2013-04-03T19:41:41 http://comments.gmane.org/gmane.text.docutils.user/6954 <pre> The current version of docutils/parsers/rst/state.py has this code: try: import roman except ImportError: import docutils.utils.roman as roman Since there is no "roman.py" in "docutils/parsers/rst", I'm not sure when that bare "import roman" is a good idea. It actually seems to me like a bad idea, because if you have a "roman.py" in the current directory, it'll find that instead. (And, if that happens to be a Python 2 file, while you're running Python 3, you get a SyntaxError.) Alternatively, if 'roman' in sys.modules, "import roman" will grab that... whatever it is. Surely it would be best to drop the first three lines of this snippet, and always explicitly import docutils.utils.roman as roman. After all, explicit is better than implicit. //arry/ p.s. I'm not subscribed to this list. ------------------------------------------------------------------------------ Everyone hates slow websites. So do we. Make your web apps faster with AppDynamics Download AppDynamics</pre> Larry Hastings 2013-03-18T08:38:57 http://comments.gmane.org/gmane.text.docutils.user/6938 <pre>I have a standard makefile I use to create a variety of output media from a given rst file. This recently stopped working on the Cygwin system I use for this task. Upon further review, I found that that when the rst2* programs run, they produce proper output, but when they complete, Python aborts. This is causing the makefile to terminate prematurely. I am also see this error when I attempt to produce html: &lt;stdin&gt;:: (ERROR/3) Cannot embed stylesheet '/home/luser/Docs/myproject/html4css1.css': No such file or directory Any ideas what's going on here? Cygwin is up-to-date and seems to otherwise be OK. The same rst file works fine on native Linux and FreeBSD systems. TIA, </pre> Tim Daneliuk 2013-03-17T03:11:34 http://comments.gmane.org/gmane.text.docutils.user/6928 <pre>Hi, A few days ago I installed a new snapshot of docutils and since then I've noticed that if I don't explicitly specify the complete path to the stock 'html4css1.css' file located under the "Lib/site-packages/docutils/writers/html4css1" directory in either the Docutils configuration or on the command line, then Docutils tries to look for the 'html4css1.css' stylesheet in the same directory as the RestructuredText file I want to convert to HTML. While this does seem in tune with the output of ''--help'', where the "--stylesheet-dirs" option states that the default value is "['.', 'c:/Python27/lib/site-packages/docutils/writers/html4css1']", I would have expected Docutils to *first* look in the current directory, and if it couldn't find the html4css1.css file, *then* look inside "c:/Python27/lib/site-packages/docutils/writers/html4css1". However it returns the error that it cannot embed the stylesheet "&lt;rst_file_directory&gt;\html4css1.css" and doesn't seem to go any further in searching the second dir as the</pre> Martin Gignac 2013-03-12T15:38:24 http://comments.gmane.org/gmane.text.docutils.user/6925 <pre>Hi, I want to take the following restructured text snippet that contains a substitution definition: text = """ |python| .. |python| image:: python.jpg """ And resolve the definitions so the substitution text is displayed: resolved_text = """ .. image:: python.jpg """ Is there a function or utility in docutils or another module that can do this? I've posted this also to http://stackoverflow.com/questions/15312420/resolve- substitutions-in-restructedtext Thanks for any help. ------------------------------------------------------------------------------ Symantec Endpoint Protection 12 positioned as A LEADER in The Forrester Wave(TM): Endpoint Security, Q1 2013 and "remains a good choice" in the endpoint security space. For insight on selecting the right partner to tackle endpoint security challenges, access the full report. http://p.sf.net/sfu/symantec-dev2dev </pre> Seth G 2013-03-11T22:37:11 http://comments.gmane.org/gmane.text.docutils.user/6920 <pre>Hello, As expected I can create docutils option_list output with the following restructured text: -c clear logs -d debug mode -D for Mac OS X launchd, don't fork -q min run for specified minutes then shutdown -r min run for specified minutes then restart -n number set maximum number of packets to read My problem is that I have some lists of options that are in non-standard format and thus are not recognized by docutils as an option_list. For example: -select expr select matching source names -start {pktid|time} set starting point for reading For lists such as these, I need to produce the output option_list by hand. I have attempted to clone the format of the option_list with experiments such as follows: .. list-table:: * - -select *expr* - select matching source names * - -start *{pktid|time}* - set starting point for reading This almost w</pre> Kent Lindquist 2013-02-25T18:49:09 http://comments.gmane.org/gmane.text.docutils.user/6916 <pre>Hi, Emailing this list as suggested in the rst docs[1]: I created an SVG image for an architecture diagram to include in my sphinx-generated python docs. The graphic has clickable elements that direct to the relevant class documentation pages. Naively, I assumed I could just embed the image with image:: directive but I found that in my browser (upt-to-date Firefox) using SVG images via HTML &lt;img&gt; tag does not work for hyperlinks within the SVG. Instead I discovered that if I use the HTML5 &lt;embed&gt; tag, the SVG becomes clickable again. So my question is whether there exists some method other than using raw HTML output to include the image in a reStructuredText page? It's also annoying that sphinx now doesn't know about my image file to copy it into the generated output, but I guess that bit is OT for this list. Would appreciate any advice on how best to handle SVGs. A single href target for the entire SVG is sadly of no use in my case. Thanks, -Will [1] http://docutils.sourceforge.net/docs/ref/rst/d</pre> Will Daniels 2013-02-19T18:40:39 http://comments.gmane.org/gmane.text.docutils.user/6905 <pre>Hi, I just grabbed the online version of the rst cheatsheet available at http://docutils.sourceforge.net/docs/user/rst/cheatsheet.txt, and miserably failed at creating a pdf out of it. I generated the latex output with rst2latex (docutils 0.9 under Python 2.7, rev Id 5905 of rst2latex.py), but both latex and pdflatex raised errors, beginning with: {Literal block, preceded by ``::'': ! Paragraph ended before \&lt; at &gt;xmultirow was complete. &lt;to be read again&gt; \par l.161 Ignoring the errors eventually lead to a fatal error and no PDF output. A gmane search led me to a 2008 thread that raised a similar problem. My question is: is it a particular problem of my TEX or is it a known issue? It is not a matter of life or death for me, but I am just curious. ------------------------------------------------------------------------------ The Go Parallel Website, sponsored by Intel - in partnership with Geeknet, is your hub for all things parallel software development, from weekly thought leadership</pre> Angel Yanguas-Gil 2013-02-18T04:57:18 http://comments.gmane.org/gmane.text.docutils.user/6901 <pre> -m MESSAGE, --message=MESSAGE The message to display Using rst2man with the above produces a man page with the comma underlined. docutils/writers/manpage.py --- /usr/lib/python2.7/dist-packages/docutils/writers/manpage.py.old 2013-02-10 03:41:13.470444232 -0500 +++ /usr/lib/python2.7/dist-packages/docutils/writers/manpage.py 2013-02-10 03:36:49.098435181 -0500 &lt; at &gt;&lt; at &gt; -873,7 +873,7 &lt; at &gt;&lt; at &gt; def visit_option(self, node): # each form of the option will be presented separately if self.context[-1] &gt; 0: - self.body.append(', ') + self.body.append('\\fP,\\fB ') if self.context[-3] == '.BI': self.body.append('\\') self.body.append(' ') ------------------------------------------------------------------------------ Free Next-Gen Firewall Hardware Offer Buy your Sophos next-gen firewall before the end March 2013 and get the hardware for free! Learn more. http://p.sf.net/sfu/sophos-d2d-feb </pre> Bil Morris 2013-02-10T08:46:30 Search the mailing list at Gmane query http://search.gmane.org/?group=$group=gmane.text.docutils.user