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/6711 <pre>When compiling docutils 9 for python 3 I get the same directories I get with python 2: {root}/{prefix}/bin/ {root}/{prefix}/{site-packages}/docutils/ However, I also extra directories that are not present in the python 2 version. These are: {root}/{prefix}/{site-packages}/test/ {root}/{prefix}/{site-packages}/tools/ Are these directories supposed to be here? If so, can they be safely removed or moved into the {root}/{prefix}/{site-packages}/docutils/ directory? These are fairly generic and uninformative names and I fear they may conflict with other python packages. ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ </pre> Todd 2012-05-14T12:58:41 http://comments.gmane.org/gmane.text.docutils.user/6710 <pre>Hi, I am posting this message on docutils-users, sphinx-dev and doc-sig mailing lists: * &lt; at &gt;docutils-users, it's a proposal about some "restrictive" reStructuredText subset; * &lt; at &gt;sphinx-dev, it's about Sphinx usage, i.e. best practices; * &lt; at &gt;doc-sig, I wonder if it could be a PEP for documentation of Python packages. I started to write down conventions for Sphinx-based documentations at https://github.com/benoitbryon/documentation-style-guide-sphinx I'd like to share this work, and I also need feedback. I guess it could be compared to PEP-8, as a "style guide", but applied to Sphinx-based documentations. Python code can be valid even if it doesn't follow PEP-8; but Python code should follow PEP-8 because it's the convention (and de facto best practice). More explanations below. Story ===== As a developer, I started using Sphinx five years ago. I contributed to documentation of public or private projects using Sphinx. I also worked in several teams with different background: * private projects with</pre> Benoît Bryon 2012-05-13T15:22:25 http://comments.gmane.org/gmane.text.docutils.user/6709 <pre>Hi all. Is there a template to produce slides with a small logo on top left? We changed the CSS, but we found it difficult to produce a clean result. In general, I think this is a very general requirement: perhaps better adding it as a default in the standard template? Thanks a lot. </pre> Paolo Cavallini 2012-05-12T05:16:01 http://comments.gmane.org/gmane.text.docutils.user/6706 <pre>Hi all. I'm just starting with rst and s5, so please forgive my ignorance. Why this slide: I comandi di GRASS -------------------- - Centinaia di comandi - Ognuno con numerose opzioni - r.*= comandi per i raster - v.*= comandi per i vettori Appears as: &lt;div class="slide" id="i-comandi-di-grass"&gt; &lt;h1&gt;I comandi di GRASS&lt;/h1&gt; &lt;ul&gt; &lt;li&gt;&lt;dl class="first docutils"&gt; &lt;dt&gt;Centinaia di comandi&lt;/dt&gt; &lt;dd&gt;&lt;ul class="first last simple"&gt; &lt;li&gt;Ognuno con numerose opzioni&lt;/li&gt; &lt;/ul&gt; &lt;/dd&gt; &lt;/dl&gt; &lt;/li&gt; &lt;li&gt;&lt;p class="first"&gt;r.*= comandi per i raster&lt;/p&gt; &lt;/li&gt; &lt;li&gt;&lt;p class="first"&gt;v.*= comandi per i vettori&lt;/p&gt; &lt;/li&gt; &lt;/ul&gt; &lt;/div&gt; i.e., with unnecessary &lt;/p&gt; ? Does this depend from the fact that there is a sublist? Is it possible to avoid this unnecessary spacing (without editing the html, obviously)? Thanks. </pre> Paolo Cavallini 2012-05-09T18:02:56 http://comments.gmane.org/gmane.text.docutils.user/6701 <pre>Hello everyone, I just read the other day the release notes of the 0.9 version and decided to test the new code directive and role [1]. My problem is that, though I have Pygments installed and the code seems to be well parsed, I can't get it colored when I export to LaTeX using rst2latex. If I export to HTML, I can then do pygmentize -f html -S trac &gt; style.css add the stylesheet to the generated .html file and there I have the colors. On the other hand, I cannot figure out how to do this with LaTeX. I stumbled upon an old document on the sandbox mentioning rst2html-pygments and rst2latex-pygments [2], which seems to be exactly what I want, but these scripts are not included in the main distribution. Any help? [1]: http://docutils.sourceforge.net/docs/ref/rst/directives.html#code [2]: http://docutils.sourceforge.net/sandbox/code-block-directive/tools/pygments-enhanced-front-ends/ ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusi</pre> Juan Luis Cano Rodríguez 2012-05-05T18:00:06 http://comments.gmane.org/gmane.text.docutils.user/6692 <pre>Hi, rst2latx gives me chapter* for all my section headings, how do i affect the level what i really need is chapter vs section vs subsection </pre> Ronny Pfannschmidt 2012-05-05T14:26:21 http://comments.gmane.org/gmane.text.docutils.user/6688 <pre>hi, for my needs of explaining various flows, i want to include something like blockdiag into rst2latex/rst2pdf/rst2html output however i dont exactly see where i would get started with that </pre> Ronny Pfannschmidt 2012-05-04T14:36:43 http://comments.gmane.org/gmane.text.docutils.user/6685 <pre>Hi, I am now reporting errors with Docutils. Python version = 3.2 OS = windows 7 professional, pack 1 The errors I am reporting are concerning: -- rst2odt.py -- buildhtlm.py Please take a look at the four PNG files (here appended) to see the command line I have used to call these two scripts. The scripts rst2html.py and rst2xml.py seem to work well. Regards Constant Deniger </pre> Constant Deniger 2012-05-03T17:41:15 http://comments.gmane.org/gmane.text.docutils.user/6676 <pre>is there any official git/hg mirror of docutils one can use for hacking? ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ </pre> Ronny Pfannschmidt 2012-05-02T15:21:12 http://comments.gmane.org/gmane.text.docutils.user/6673 <pre>Running ``rst2html --math-output=HTML`` (that parameter is important) with ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ </pre> spider-mario 2012-05-02T00:18:53 http://comments.gmane.org/gmane.text.docutils.user/6668 <pre>Hi, I have been playing with docutils and I have created a new role :chem:, to process subscripts and superscripts for chemical formula (i.e. :chem: or :ch:`Al2O3` == Al&lt;sub&gt;2&lt;/sub&gt;O&lt;sub&gt;3&lt;/sub&gt;). It worked, and now I have it running in my local copy. However, I still have a couple of questions: 1) So far I have included it in my local copy of roles.py. Is there any other way of loading custom roles / add-ons to distutils that does not involve modifying roles.py? (like a local directory where custom roles could be added/imported into distutils?). 2) Is nodes.Text the standard way of returning a text node? 3) Can roles be made to work recursively? In other words, am I missing a simple way of calling a role within a role (i.e. so that I can expand Al2O3 into "Al :subs:`2`\ O:subs:`3`\ " and that magically everything is taken care of)?. 4) Is a role the best way of doing this? Should I be using a directive instead, or is it an overkill? Many thanks, ay -----------------------------------------------------</pre> Angel Yanguas-Gil 2012-04-30T04:45:42 http://comments.gmane.org/gmane.text.docutils.user/6665 <pre> Dear developers, wouldn't it be nice if the list-table and csv-table directives have had an ":align:" attribute (much as like as the figure directive)? http://docutils.sourceforge.net/docs/ref/rst/directives.html#figure Would it take (too) much effort to accomplish this? Greetings and thanks in advance, Bernhard ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/</pre> Bernhard Grotz 2012-04-29T01:33:45 http://comments.gmane.org/gmane.text.docutils.user/6656 <pre>Not a subscriber - please cc me Curious about when 0.9 with the new "code" block and pygments syntax highlighting might be officially released? Thought that after it's out, maybe GitHub might adopt it for their rst rendering. -Marc http://marc-abramowitz.com Sent from my iPhone 4 ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ </pre> Marc Abramowitz 2012-04-26T16:29:10 http://comments.gmane.org/gmane.text.docutils.user/6653 <pre>Hi, for my thesis i want to use/create more more than one abstract section, currently i don't see a nice way to create/add abstract sections in a natural way the abstract docinfo fields doesnt really fit my needs ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ </pre> Ronny Pfannschmidt 2012-04-26T13:49:25 http://comments.gmane.org/gmane.text.docutils.user/6645 <pre>Hi all. I have found only one way of having smaller text on a slide, i.e. the :tiny:`text` directive, but this is ugly if I want all or most of the text on a slide smaller. In fact, lists and bullets are not well supported,and the directive must be repeated for each line. Is there a better way? Thanks a lot. ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ </pre> Paolo Cavallini 2012-04-25T15:16:33 http://comments.gmane.org/gmane.text.docutils.user/6644 <pre>Hi, for my thesis, i would like to write most of the text with restructuredtext, however for the added quality, i'd like to do things like the titlepage and some basic style stuff and the document structure in normal latex, and just include the generated fragments. what would be the best/canonical way to do that? Note that i already looked into generating the whole thesis from restructuredtext, but that turned out impractical and/or too low in quality </pre> Ronny Pfannschmidt 2012-04-25T17:36:25 http://comments.gmane.org/gmane.text.docutils.user/6642 <pre>I have a large rst file [1] that is accepted by 'rst2html --strict', but which fails with 'rst2pdf': rst2pdf -o /tmp/upstart_cookbook.pdf /tmp/upstart_cookbook.rst Traceback (most recent call last): File "/usr/bin/rst2pdf", line 9, in &lt;module&gt; load_entry_point('rst2pdf==0.16', 'console_scripts', 'rst2pdf')() File "/usr/lib/pymodules/python2.7/rst2pdf/createpdf.py", line 1456, in main compressed=options.compressed) File "/usr/lib/pymodules/python2.7/rst2pdf/createpdf.py", line 666, in createPdf pdfdoc.multiBuild(elements) File "/usr/lib/python2.7/dist-packages/reportlab/platypus/doctemplate.py", line 960, in multiBuild self.build(tempStory, **buildKwds) File "/usr/lib/python2.7/dist-packages/reportlab/platypus/doctemplate.py", line 880, in build self.handle_flowable(flowables) File "/usr/lib/pymodules/python2.7/rst2pdf/createpdf.py", line 774, in handle_flowable if frame.add(f, canv, trySplit=self.allowSplitting): File "/usr/lib/pymodules/python2.7/rst2pdf/flowables.py",</pre> James Hunt 2012-04-18T14:53:00 http://comments.gmane.org/gmane.text.docutils.user/6635 <pre>When I run rstdiff.py using Docutils 0.8.1, I get the following error: system_message: children=() Traceback (most recent call last): File "/usr/bin/rstdiff.py", line 1142, in &lt;module&gt; diffDoc = createDiff(pub, oldTree, newTree) File "/usr/bin/rstdiff.py", line 1127, in createDiff buildTree(dispatcher, diffDoc, opcode.getSubOpcodes(), oldTree, newTree) File "/usr/bin/rstdiff.py", line 983, in buildTree subOpcodes, oldRange[0], newRange[0]) File "/usr/bin/rstdiff.py", line 983, in buildTree subOpcodes, oldRange[0], newRange[0]) File "/usr/bin/rstdiff.py", line 983, in buildTree subOpcodes, oldRange[0], newRange[0]) File "/usr/bin/rstdiff.py", line 983, in buildTree subOpcodes, oldRange[0], newRange[0]) File "/usr/bin/rstdiff.py", line 983, in buildTree subOpcodes, oldRange[0], newRange[0]) File "/usr/bin/rstdiff.py", line 983, in buildTree subOpcodes, oldRange[0], newRange[0]) File "/usr/bin/rstdiff.py", line 986, in buildTree command, oldRange, newRange)</pre> Jeffrey C. "TimeHorse" Jacobs 2012-04-06T19:29:23 http://comments.gmane.org/gmane.text.docutils.user/6634 <pre>Hi, Stefan, Stefan, Stefan, and everyone, The latest rst.el file in svn generates some warnings when compiling. I append those warnings in the end of the email. I find my codes of inserting list are included. I write those codes many year age without any consideration. Now I find the name of those function should be changed from "insert-list" to "list-insert" to be compatible with other functions' name. I also patched codes of inserting directives, options, hyperlinks, footnotes, and citations year ago. I modified those codes and put them in separate files now. - The rst-directives.el, which I use everyday, contains functions for inserting directives and options. - The function 'rst-directive-insert' can be used to insert directive. - The function 'rst-directive-option-insert' can be used to insert option for existed directive. - Some settings for Sphinx directives also included in the rst-directives.el file. You can see how to add your own directives. - The rst-directives.el is self-</pre> Wei-Wei Guo 2012-04-04T13:46:58 http://comments.gmane.org/gmane.text.docutils.user/6633 <pre>In order to create atractive documents I was thinking that the raw directive could give the posibility of processing a code like this... .. raw:: odt &lt;text:p text:style-name="Text_20_body"&gt; &lt;draw:frame draw:style-name="fr3" draw:name="Frame3" text:anchor-type="paragraph" svg:width="2cm" draw:z-index="2"&gt; &lt;draw:text-box fo:min-height="0.499cm"&gt; &lt;text:p text:style-name="Frame_20_contents"&gt;The text inside the frame&lt;/text:p&gt; &lt;/draw:text-box&gt; &lt;/draw:frame&gt;The main paragraph! &lt;/text:p&gt; I haven't success. Is it possible? How could I markup several portion of text for avoiding parse depending on the output? Maybe with some Python code... Could you give me some idea? Thanks in advance for your help! ------------------------------------------------------------------------------ Better than sec? Nothing is better than sec when it comes to monitoring Big Data applications. Try Boundary one-second resolution app monitoring today. Free. http://p.sf.net/sfu/Boundary-</pre> Paulo 2012-04-03T06:55:16 http://comments.gmane.org/gmane.text.docutils.user/6628 <pre>I've recently grown quite attracted to the idea of migrating our technical documentation to reStructuredText, for mostly the same reasons people use rst to begin with. I'm working under the general restriction, however, that non-developers will be writing some of this documentation, and therefore I need a distribution of docutils for windows that is usable without a separate python install. I see this has request has lived for a while at: http://docutils.sourceforge.net/docs/dev/todo.html But, I don't require any sort of GUI (though one would be nice). I started to play with py2exe to see if I could package docutils myself. Py2exe is a bit awkward to wrap around docutils, but I succeeded in a version that could run rst2html.py and would at least *start* execution. I'm currently stuck because the current distribution assumes that resources like html4css1.css are accessible via normal open() calls, which is not the case for py2exe because of the bundling of resources inside the library.zip. This is </pre> Chris Scott 2012-03-30T17:58:15 Search the mailing list at Gmane query http://search.gmane.org/?group=$group=gmane.text.docutils.user