[Docutils-users] QuickLook rst plugin

[Grzegorz Adam Hankiewicz <rst@gr...>]

Hi.

I have implemented an OSX QuickLook plugin for rst files, you can get it fromhttps://github.com/gradha/quicklook-rest-with-nimrod. This implementation doesn't use python though, it's a clean reimplementation in the Nimrod programming language, so it is still quite lacking in terms of features, but is starting to be usable.

In fact the Nimrod programming language uses the rst format for the docstrings (example https://github.com/Araq/Nimrod/blob/devel/lib/pure/collections/sets.nim) and the plain text documentation and website also use rst.

I'd like to know if it is ok to spam this mailing list with new releases of this quicklook plugin or there is a more appropriate spam channel.

Re: [Docutils-users] I am not subscribed ..

[David Goodger <goodger@py...>]

On Wed, Jul 23, 2014 at 3:09 AM, engelbert gruber
<engelbert.gruber@...> wrote:
> first sorry: IMHO develop should not bounce,

No mail bounced. All Docutils mailing lists are set to moderate mail
from addresses not subscribed ("message awaits approval"). This is to
prevent spam from getting through. Without this setting, we'd see
several unwanted messages every day.

-- 
David Goodger <http://python.net/~goodger>;

Re: [Docutils-users] I am not subscribed ..

[engelbert gruber <engelbert.gruber@gm...>]

and another apologize

i do not know why but i did not get the message that your message awaits
approval
it should now work, and as soon as you are approved you can post to develop
too
without being subscribed.

but for users docutils-users is better .

all the best


On 23 July 2014 09:16, john francis lee <jfl@...> wrote:

>
> Hi,
>
> I was having trouble setting the page size used by rst2odt.py when it
> created an odt from and rst file, and so sent a message to developers
> ... because that was the email link at the top of the article I'd read
> in an attempt to get help ...
>
>
> http://docutils.sourceforge.net/docs/user/odt.html#defining-and-using-a-custom-stylesheet
>
> ... and the email bounced because I wasn't subscribed. Meanwhile ...
> scrolling down, or using another link, came in contact with another
> section of the very same posting ...
>
> http://docutils.sourceforge.net/docs/user/odt.html#page-size
>
> ... which has set me right ! So, thanks.
>
> I tried papersize and that business, but it was ...
>
> $ rst2odt_prepstyles.py styles.odt
>
> ... that finally straightened me out.
>
> I append my original email for ... the hell of it ...
>
> Thanks again. It this doesn't bounce too.
>
> ====================================================================
>
> Hi,
>
> I'm trying to generate .odt files with paper size a4 from .rst files.
>
> I'm trying to follow the directions from
>
>
>
> http://docutils.sourceforge.net/docs/user/odt.html#defining-and-using-a-custom-stylesheet
>
> I use debian 7.6 64bit linux. I used
>
>   apt-get install python-docutils
>
> to install the docutils programs.
>
> I  copied
>
>   /usr/share/docutils/writers/odf_odt/styles.odt
>
> to my home directory.
>
> I opened it there and changed
>
>   Format| Page | Paper format | Format
>
> from Letter to A4
>
> I saved
>
>   /usr/share/docutils/writers/odf_odt/styles.odt
>
> as
>
>   /usr/share/docutils/writers/odf_odt/styles.odt-dist
>
> and then saved my copy as
>
>   /usr/share/docutils/writers/odf_odt/styles.odt
>
> No one ever uses letter sized paper in Thailand, and I can change it in
> any individual letters I write on letter size paper. I think I have
> written one in the last 12 years .
>
> I changed ownership and permissions to match the distribution
>
> ls -l /usr/share/docutils/writers/odf_odt/
> total 40
> -rw-r--r-- 1 root root 16403 Jul 23 12:19 styles.odt
> -rw-r--r-- 1 root root 16500 Jun 27  2011 styles.odt-dist
>
> But when I run
>
>   rst2odt ooncd.en.rst ooncd.en.odt
>
> ooncd.en.odt is still formatted for letter-size paper.
>
> Can you see what I've done wrong?
>
> Thanks.
>
> --
> John Francis Lee
> Thanon Sanam Gila, Ban Fa Sai
> 79/151 Moo 22 T. Ropwieng
> Mueang Chiangrai 57000
> Thailand
>
>
>
>
> ------------------------------------------------------------------------------
> Want fast and easy access to all the code in your enterprise? Index and
> search up to 200,000 lines of code with a free copy of Black Duck
> Code Sight - the same software that powers the world's largest code
> search on Ohloh, the Black Duck Open Hub! Try it now.
> http://p.sf.net/sfu/bds
> _______________________________________________
> Docutils-users mailing list
> Docutils-users@...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>

Re: [Docutils-users] I am not subscribed ..

[engelbert gruber <engelbert.gruber@gm...>]

first sorry: IMHO develop should not bounce,

second: sorry again , i will try to help with odt but it is not my main work

  but how ... trying :-)

* which docutils version is it ?

* did anything the generated document change ?

cheers



On 23 July 2014 09:16, john francis lee <jfl@...> wrote:

>
> Hi,
>
> I was having trouble setting the page size used by rst2odt.py when it
> created an odt from and rst file, and so sent a message to developers
> ... because that was the email link at the top of the article I'd read
> in an attempt to get help ...
>
>
> http://docutils.sourceforge.net/docs/user/odt.html#defining-and-using-a-custom-stylesheet
>
> ... and the email bounced because I wasn't subscribed. Meanwhile ...
> scrolling down, or using another link, came in contact with another
> section of the very same posting ...
>
> http://docutils.sourceforge.net/docs/user/odt.html#page-size
>
> ... which has set me right ! So, thanks.
>
> I tried papersize and that business, but it was ...
>
> $ rst2odt_prepstyles.py styles.odt
>
> ... that finally straightened me out.
>
> I append my original email for ... the hell of it ...
>
> Thanks again. It this doesn't bounce too.
>
> ====================================================================
>
> Hi,
>
> I'm trying to generate .odt files with paper size a4 from .rst files.
>
> I'm trying to follow the directions from
>
>
>
> http://docutils.sourceforge.net/docs/user/odt.html#defining-and-using-a-custom-stylesheet
>
> I use debian 7.6 64bit linux. I used
>
>   apt-get install python-docutils
>
> to install the docutils programs.
>
> I  copied
>
>   /usr/share/docutils/writers/odf_odt/styles.odt
>
> to my home directory.
>
> I opened it there and changed
>
>   Format| Page | Paper format | Format
>
> from Letter to A4
>
> I saved
>
>   /usr/share/docutils/writers/odf_odt/styles.odt
>
> as
>
>   /usr/share/docutils/writers/odf_odt/styles.odt-dist
>
> and then saved my copy as
>
>   /usr/share/docutils/writers/odf_odt/styles.odt
>
> No one ever uses letter sized paper in Thailand, and I can change it in
> any individual letters I write on letter size paper. I think I have
> written one in the last 12 years .
>
> I changed ownership and permissions to match the distribution
>
> ls -l /usr/share/docutils/writers/odf_odt/
> total 40
> -rw-r--r-- 1 root root 16403 Jul 23 12:19 styles.odt
> -rw-r--r-- 1 root root 16500 Jun 27  2011 styles.odt-dist
>
> But when I run
>
>   rst2odt ooncd.en.rst ooncd.en.odt
>
> ooncd.en.odt is still formatted for letter-size paper.
>
> Can you see what I've done wrong?
>
> Thanks.
>
> --
> John Francis Lee
> Thanon Sanam Gila, Ban Fa Sai
> 79/151 Moo 22 T. Ropwieng
> Mueang Chiangrai 57000
> Thailand
>
>
>
>
> ------------------------------------------------------------------------------
> Want fast and easy access to all the code in your enterprise? Index and
> search up to 200,000 lines of code with a free copy of Black Duck
> Code Sight - the same software that powers the world's largest code
> search on Ohloh, the Black Duck Open Hub! Try it now.
> http://p.sf.net/sfu/bds
> _______________________________________________
> Docutils-users mailing list
> Docutils-users@...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>

[Docutils-users] I am not subscribed ..

[john francis lee <jfl@ro...>]

Hi,

I was having trouble setting the page size used by rst2odt.py when it 
created an odt from and rst file, and so sent a message to developers 
... because that was the email link at the top of the article I'd read 
in an attempt to get help ...

http://docutils.sourceforge.net/docs/user/odt.html#defining-and-using-a-custom-stylesheet

... and the email bounced because I wasn't subscribed. Meanwhile ... 
scrolling down, or using another link, came in contact with another 
section of the very same posting ...

http://docutils.sourceforge.net/docs/user/odt.html#page-size

... which has set me right ! So, thanks.

I tried papersize and that business, but it was ...

$ rst2odt_prepstyles.py styles.odt

... that finally straightened me out.

I append my original email for ... the hell of it ...

Thanks again. It this doesn't bounce too.

====================================================================

Hi,

I'm trying to generate .odt files with paper size a4 from .rst files.

I'm trying to follow the directions from


http://docutils.sourceforge.net/docs/user/odt.html#defining-and-using-a-custom-stylesheet

I use debian 7.6 64bit linux. I used

  apt-get install python-docutils

to install the docutils programs.

I  copied

  /usr/share/docutils/writers/odf_odt/styles.odt

to my home directory.

I opened it there and changed

  Format| Page | Paper format | Format

from Letter to A4

I saved

  /usr/share/docutils/writers/odf_odt/styles.odt

as

  /usr/share/docutils/writers/odf_odt/styles.odt-dist

and then saved my copy as

  /usr/share/docutils/writers/odf_odt/styles.odt

No one ever uses letter sized paper in Thailand, and I can change it in 
any individual letters I write on letter size paper. I think I have 
written one in the last 12 years .

I changed ownership and permissions to match the distribution

ls -l /usr/share/docutils/writers/odf_odt/
total 40
-rw-r--r-- 1 root root 16403 Jul 23 12:19 styles.odt
-rw-r--r-- 1 root root 16500 Jun 27  2011 styles.odt-dist

But when I run

  rst2odt ooncd.en.rst ooncd.en.odt

ooncd.en.odt is still formatted for letter-size paper.

Can you see what I've done wrong?

Thanks.

-- 
John Francis Lee
Thanon Sanam Gila, Ban Fa Sai
79/151 Moo 22 T. Ropwieng
Mueang Chiangrai 57000
Thailand

Re: [Docutils-users] Using DocUtils to parse RST with unknown directives

[David Goodger <goodger@py...>]

On Mon, Jul 21, 2014 at 1:07 PM, Austin Bart <acbart@...> wrote:
> I have some RST files that use a number of custom directives. I need to get
> a tree-based representation (e.g., like I'd get from publish_doctree) of
> these files before I pass them into Sphinx (via Paver) and have them parsed
> properly. I don't want any sophisticated processing of the directives - I
> just want to know where in the document any given directive occurs, along
> with its options and content.
>
> If I try and just pass the files into publish_doctree, it gets upset because
> it hasn't been told about all the custom directives that are possible. Is my
> only option to implement my own parser? Or is there some way to tell
> docutils to not Except on unknown directives? The following conversation
> makes me think that it might not be possible:
>
> http://article.gmane.org/gmane.text.docutils.user/4176/match=publish_doctree

You can adjust the halt_level so that "error" level does not halt the
processing. You'd set halt_level=4 (one level above error = 3). Then
the resulting doctree would contain error messages with details about
each directive.

Another option would be some monkey-patching. Replace
docutils.parsers.rst.directives._directive_registry (in the
__init__.py file) with a collections.defaultdict(your_function),
duplicating the original _directive_registry's data. The
implementation of your_function would return a (module name, class
name) tuple; you would have to implement these as well (possibly also
monkey-patched).

I recommend the first option, much easier. If it doesn't do what you
want, the second option may do it for you.

-- 
David Goodger <http://python.net/~goodger>;


> Please note that I'm not subscribed to this listserv, so please CC me on
> responses! Thanks for your time and help!
>
> --
> Austin Cory Bart
> Computer Science PhD student at Virginia Tech
> http://www.acbart.com
>
> ------------------------------------------------------------------------------
> Want fast and easy access to all the code in your enterprise? Index and
> search up to 200,000 lines of code with a free copy of Black Duck
> Code Sight - the same software that powers the world's largest code
> search on Ohloh, the Black Duck Open Hub! Try it now.
> http://p.sf.net/sfu/bds
> _______________________________________________
> Docutils-users mailing list
> Docutils-users@...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>

[Docutils-users] Using DocUtils to parse RST with unknown directives

[Austin Bart <acbart@vt...>]

I have some RST files that use a number of custom directives. I need to get
a tree-based representation (e.g., like I'd get from publish_doctree) of
these files before I pass them into Sphinx (via Paver) and have them parsed
properly. I don't want any sophisticated processing of the directives - I
just want to know where in the document any given directive occurs, along
with its options and content.

If I try and just pass the files into publish_doctree, it gets upset
because it hasn't been told about all the custom directives that are
possible. Is my only option to implement my own parser? Or is there some
way to tell docutils to not Except on unknown directives? The following
conversation makes me think that it might not be possible:

http://article.gmane.org/gmane.text.docutils.user/4176/match=publish_doctree

Please note that I'm not subscribed to this listserv, so please CC me on
responses! Thanks for your time and help!

-- 
Austin Cory Bart
Computer Science PhD student at Virginia Tech
http://www.acbart.com

Re: [Docutils-users] Equation numbering in LaTeX writer

[Guenter Milde <milde@us...>]

On 2014-06-26, Eduard Bopp wrote:

> My current workaround is to change line 2529 of
> writers/latex2e/__init__.py from

>     math_env = pick_math_environment(node.astext())

> to

>     math_env = pick_math_environment(node.astext(), numbered=True)

> This enables enumeration and allows me to label and reference my
> equations using raw LaTeX. While this solves my practical issue, I think
> it's not exactly an elegant solution. Is there a more straightforward
> and perhaps target-independent way to achieve this?

Not yet. Numbered equations are on the TODO list.¹ However, as there are
more objects that may/can/should be numbered (formal tables, figures) this
should become a generic solution which requires some thoughts and efforts.

Günter


¹ http://docutils.sourceforge.net/docs/dev/todo.html

Re: [Docutils-users] Test suite failure

[David Bruchmann <david.bruchmann@gm...>]

>
> - distributing a document generated on a not "C:" drive would make the
> stylesheet path
>   wrong on most other machines, for sure on any unix(mac/linux

That argument is reasonable.

Apart from that you've just to deal with the fact that the 4 errors
are thrown on Windows when using absolute paths.
Relative paths could be a solution but maybe that's sometimes not desired.
I suppose you can solve the problem only with a configuration-option
where every user can decide. You still can recommend one solution.

Btw I built the tests from a subdirectory and not directly in C:\, so
the value would be wrong, no matter if "C:/test.css" or "/test.css".
In my opinion here it would be reasonable to built the paths really
relative.

David

Re: [Docutils-users] Test suite failure

[Pete Jemian <jemian@an...>]

Isn't Windows a bit different in handling directories and disks?

/mypath/ starts at the root of the default disk

If your default disk is
    C:, doesn't it point to C:/mypath/
    F:, doesn't it point to F:/mypath/

Engelbert's rule 1 (below) does not describe this.

HTH,
   Pete

On 6/26/2014 12:17 PM, David Bruchmann wrote:
> Hello Engelbert,
>
> I know that a path like /mypath/ without "C:" works in Windows.
> Nevertheless 'C:'  can be seen as the root-folder of any directory in
> comparison to linux.
> Without drive-letter you can't access a file of another drive that's
> the same as you try to access /home/myFile.txt which is resided in
> /usr/myFile.txt.
> Therefore the drive-letter should left untouched as you wrote.
> In general the result is correct in my opinion.
>
> I think the tests should be adjusted NOT to throw an error
> I don't know how to adjust the expected value as I never had a look in
> the source-code but that's secondary. Sense of the tests is not to
> make a 100% string-comparison but to test if the values are correct
> and work, right?
>
> David
>
> On 6/26/14, engelbert gruber <engelbert.gruber@...> wrote:
>> thanks for mentioning
>>
>> somehow this is in my workpile
>> but i do not know how to solve
>>
>> ans therefore i am very interested opinions
>>
>> facts (as i remember)
>>
>> 1. a configured stylesheet "/style.css" results in an absolute path
>> "c:/style.css" on windows.
>> 2. a styleshhet inculding the drive letter only works for
>>
>>     - reading locally with the borwser
>>     - only necessary if the stylesheet is on drive c: and the documents on
>> another dirv
>>       otherwise the document would work without the drive letter
>>     - in the theoretic case of a server templating system with a
>> postprocessor
>>       removing the driveletter, before serving via http.
>>
>> therefore i would opt for removing of the drive letter.
>> but the procedure prepending it is used all over docutils
>> and if someone specifies "f:/test.css" the driveletter must be left
>> untouched.
>>
>>
>>
>>
>>
>> On 26 June 2014 12:04, David Bruchmann <david.bruchmann@...> wrote:
>>
>>> Hello,
>>>
>>> I've the same bug as http://sourceforge.net/p/docutils/bugs/243/ but
>>> can't
>>> login in the moment to sourceforge.net.
>>>
>>> Here are more details:
>>> primary it's always the same 'fault' (4 times):
>>>
>>>
>>> -: expected
>>> +: output
>>> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
>>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
>>>
>>> Here is still my alltests.out:
>>> ------------------------------
>>> Testing Docutils 0.11 [release] with Python 2.7.6 on 2014-06-26 at
>>> 16:13:05
>>> Working directory: C:\Users\d_admin\Downloads\docutils-0.11\test
>>> Docutils package: C:\Users\d_admin\Downloads\docutils-0.11\docutils
>>>
>>> test_writers\test_html4css1_template.py: totest['template'][0];
>>> test_publish
>>> (DocutilsTestSupport.WriterPublishTestCase)
>>> input:
>>> ================
>>>   Document Title
>>> ================
>>> ----------
>>>   Subtitle
>>> ----------
>>>
>>> :Author: Me
>>>
>>> .. footer:: footer text
>>>
>>> Section
>>> =======
>>>
>>> Some text.
>>>
>>> -: expected
>>> +: output
>>>    head_prefix = """\
>>>    <?xml version="1.0" encoding="utf-8" ?>
>>>    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>>>    <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>>>    <head>"""
>>>
>>>
>>>    head = """\
>>>    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>>    <meta name="generator" content="Docutils 0.11:
>>> http://docutils.sourceforge.net/"; />
>>>    <title>Document Title</title>
>>>    <meta name="author" content="Me" />"""
>>>
>>>
>>>    stylesheet = """\
>>> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
>>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
>>> ?                              ++
>>>
>>>
>>>    body_prefix = """\
>>>    </head>
>>>    <body>
>>>    <div class="document" id="document-title">"""
>>>
>>>
>>>    body_pre_docinfo = """\
>>>    <h1 class="title">Document Title</h1>
>>>    <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>>>
>>>
>>>    docinfo = """\
>>>    <table class="docinfo" frame="void" rules="none">
>>>    <col class="docinfo-name" />
>>>    <col class="docinfo-content" />
>>>    <tbody valign="top">
>>>    <tr><th class="docinfo-name">Author:</th>
>>>    <td>Me</td></tr>
>>>    </tbody>
>>>    </table>"""
>>>
>>>
>>>    body = """\
>>>    <div class="section" id="section">
>>>    <h1>Section</h1>
>>>    <p>Some text.</p>
>>>    </div>"""
>>>
>>>
>>>    body_suffix = """\
>>>    </div>
>>>    <div class="footer">
>>>    <hr class="footer" />
>>>    footer text
>>>    </div>
>>>    </body>
>>>    </html>"""
>>>
>>>
>>>    head_prefix = """\
>>>    <?xml version="1.0" encoding="utf-8" ?>
>>>    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>>>    <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>>>    <head>"""
>>>
>>>
>>>    head = """\
>>>    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>>    <meta name="generator" content="Docutils 0.11:
>>> http://docutils.sourceforge.net/"; />
>>>    <title>Document Title</title>
>>>    <meta name="author" content="Me" />"""
>>>
>>>
>>>    stylesheet = """\
>>> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
>>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
>>> ?                              ++
>>>
>>>
>>>    body_prefix = """\
>>>    </head>
>>>    <body>
>>>    <div class="document" id="document-title">"""
>>>
>>>
>>>    body_pre_docinfo = """\
>>>    <h1 class="title">Document Title</h1>
>>>    <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>>>
>>>
>>>    docinfo = """\
>>>    <table class="docinfo" frame="void" rules="none">
>>>    <col class="docinfo-name" />
>>>    <col class="docinfo-content" />
>>>    <tbody valign="top">
>>>    <tr><th class="docinfo-name">Author:</th>
>>>    <td>Me</td></tr>
>>>    </tbody>
>>>    </table>"""
>>>
>>>
>>>    body = """\
>>>    <div class="section" id="section">
>>>    <h1>Section</h1>
>>>    <p>Some text.</p>
>>>    </div>"""
>>>
>>>
>>>    body_suffix = """\
>>>    </div>
>>>    <div class="footer">
>>>    <hr class="footer" />
>>>    footer text
>>>    </div>
>>>    </body>
>>>    </html>"""
>>>
>>>
>>>    title = """\
>>>    Document Title"""
>>>
>>>
>>>    subtitle = """\
>>>    Subtitle"""
>>>
>>>
>>>    header = """\
>>>    """
>>>
>>>
>>>    footer = """\
>>>    <div class="footer">
>>>    <hr class="footer" />
>>>    footer text
>>>    </div>"""
>>>
>>>
>>>    meta = """\
>>>    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>>    <meta name="generator" content="Docutils 0.11:
>>> http://docutils.sourceforge.net/"; />
>>>    <meta name="author" content="Me" />"""
>>>
>>>
>>>    fragment = """\
>>>    <div class="section" id="section">
>>>    <h1>Section</h1>
>>>    <p>Some text.</p>
>>>    </div>"""
>>>
>>>
>>>    html_prolog = """\
>>>    <?xml version="1.0" encoding="%s" ?>
>>>    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">""";
>>>
>>>
>>>    html_head = """\
>>>    <meta http-equiv="Content-Type" content="text/html; charset=%s" />
>>>    <meta name="generator" content="Docutils 0.11:
>>> http://docutils.sourceforge.net/"; />
>>>    <title>Document Title</title>
>>>    <meta name="author" content="Me" />"""
>>>
>>>
>>>    html_title = """\
>>>    <h1 class="title">Document Title</h1>"""
>>>
>>>
>>>    html_subtitle = """\
>>>    <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>>>
>>>
>>>    html_body = """\
>>>    <div class="document" id="document-title">
>>>    <h1 class="title">Document Title</h1>
>>>    <h2 class="subtitle" id="subtitle">Subtitle</h2>
>>>    <table class="docinfo" frame="void" rules="none">
>>>    <col class="docinfo-name" />
>>>    <col class="docinfo-content" />
>>>    <tbody valign="top">
>>>    <tr><th class="docinfo-name">Author:</th>
>>>    <td>Me</td></tr>
>>>    </tbody>
>>>    </table>
>>>    <div class="section" id="section">
>>>    <h1>Section</h1>
>>>    <p>Some text.</p>
>>>    </div>
>>>    </div>
>>>    <div class="footer">
>>>    <hr class="footer" />
>>>    footer text
>>>    </div>"""
>>>
>>> test_writers\test_s5.py: totest['basics'][0]; test_publish
>>> (DocutilsTestSupport.WriterPublishTestCase)
>>> input:
>>> ============
>>>   Show Title
>>> ============
>>>
>>> Title slide
>>>
>>> First Slide
>>> ===========
>>>
>>> Slide text.
>>>
>>> -: expected
>>> +: output
>>>    <?xml version="1.0" encoding="utf-8" ?>
>>>    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>>>    <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>>>    <head>
>>>    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>>    <meta name="generator" content="Docutils 0.11:
>>> http://docutils.sourceforge.net/"; />
>>>    <meta name="version" content="S5 1.1" />
>>>    <title>Show Title</title>
>>> - <link rel="stylesheet" href="/test.css" type="text/css" />
>>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />
>>> ?                              ++
>>>    <!-- configuration parameters -->
>>>    <meta name="defaultView" content="slideshow" />
>>>    <meta name="controlVis" content="hidden" />
>>>    <!-- style sheet links -->
>>>    <script src="ui/default/slides.js" type="text/javascript"></script>
>>>    <link rel="stylesheet" href="ui/default/slides.css"
>>>          type="text/css" media="projection" id="slideProj" />
>>>    <link rel="stylesheet" href="ui/default/outline.css"
>>>          type="text/css" media="screen" id="outlineStyle" />
>>>    <link rel="stylesheet" href="ui/default/print.css"
>>>          type="text/css" media="print" id="slidePrint" />
>>>    <link rel="stylesheet" href="ui/default/opera.css"
>>>          type="text/css" media="projection" id="operaFix" />
>>>
>>>    <style type="text/css">
>>>    #currentSlide {display: none;}
>>>    </style>
>>>    </head>
>>>    <body>
>>>    <div class="layout">
>>>    <div id="controls"></div>
>>>    <div id="currentSlide"></div>
>>>    <div id="header">
>>>
>>>    </div>
>>>    <div id="footer">
>>>    <h1>Show Title</h1>
>>>
>>>    </div>
>>>    </div>
>>>    <div class="presentation">
>>>    <div class="slide" id="slide0">
>>>    <h1 class="title">Show Title</h1>
>>>
>>>    <p>Title slide</p>
>>>
>>>    </div>
>>>    <div class="slide" id="first-slide">
>>>    <h1>First Slide</h1>
>>>    <p>Slide text.</p>
>>>    </div>
>>>    </div>
>>>    </body>
>>>    </html>
>>>
>>> test_writers\test_s5.py: totest['settings'][0]; test_publish
>>> (DocutilsTestSupport.WriterPublishTestCase)
>>> input:
>>> ==================
>>>   Bogus Slide Show
>>> ==================
>>>
>>> We're just checking the settings
>>>
>>> -: expected
>>> +: output
>>>    <?xml version="1.0" encoding="utf-8" ?>
>>>    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>>>    <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>>>    <head>
>>>    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>>    <meta name="generator" content="Docutils 0.11:
>>> http://docutils.sourceforge.net/"; />
>>>    <meta name="version" content="S5 1.1" />
>>>    <title>Bogus Slide Show</title>
>>> - <link rel="stylesheet" href="/test.css" type="text/css" />
>>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />
>>> ?                              ++
>>>    <!-- configuration parameters -->
>>>    <meta name="defaultView" content="outline" />
>>>    <meta name="controlVis" content="visible" />
>>>    <!-- style sheet links -->
>>>    <script src="ui/default/slides.js" type="text/javascript"></script>
>>>    <link rel="stylesheet" href="ui/default/slides.css"
>>>          type="text/css" media="projection" id="slideProj" />
>>>    <link rel="stylesheet" href="ui/default/outline.css"
>>>          type="text/css" media="screen" id="outlineStyle" />
>>>    <link rel="stylesheet" href="ui/default/print.css"
>>>          type="text/css" media="print" id="slidePrint" />
>>>    <link rel="stylesheet" href="ui/default/opera.css"
>>>          type="text/css" media="projection" id="operaFix" />
>>>
>>>    <style type="text/css">
>>>    #currentSlide {display: none;}
>>>    </style>
>>>    </head>
>>>    <body>
>>>    <div class="layout">
>>>    <div id="controls"></div>
>>>    <div id="currentSlide"></div>
>>>    <div id="header">
>>>
>>>    </div>
>>>    <div id="footer">
>>>    <h1>Bogus Slide Show</h1>
>>>
>>>    </div>
>>>    </div>
>>>    <div class="presentation">
>>>    <div class="slide" id="slide0">
>>>    <h1 class="title">Bogus Slide Show</h1>
>>>
>>>    <p>We're just checking the settings</p>
>>>    </div>
>>>    </div>
>>>    </body>
>>>    </html>
>>> Elapsed time: 57.993 seconds
>>>
>>> ------------------------------
>>>
>>>
>>>
>>>
>>>
>>> ------------------------------------------------------------------------------
>>> Open source business process management suite built on Java and Eclipse
>>> Turn processes into business applications with Bonita BPM Community
>>> Edition
>>> Quickly connect people, data, and systems into organized workflows
>>> Winner of BOSSIE, CODIE, OW2 and Gartner awards
>>> http://p.sf.net/sfu/Bonitasoft
>>> _______________________________________________
>>> Docutils-users mailing list
>>> Docutils-users@...
>>> https://lists.sourceforge.net/lists/listinfo/docutils-users
>>>
>>> Please use "Reply All" to reply to the list.
>>>
>>
>
> ------------------------------------------------------------------------------
> Open source business process management suite built on Java and Eclipse
> Turn processes into business applications with Bonita BPM Community Edition
> Quickly connect people, data, and systems into organized workflows
> Winner of BOSSIE, CODIE, OW2 and Gartner awards
> http://p.sf.net/sfu/Bonitasoft
> _______________________________________________
> Docutils-users mailing list
> Docutils-users@...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>

-- 
----------------------------------------------------------
Pete R. Jemian, Ph.D.                <jemian@...>
Beam line Controls and Data Acquisition, Group Leader
Advanced Photon Source,   Argonne National Laboratory
Argonne, IL  60439                   630 - 252 - 3189
-----------------------------------------------------------
    Education is the one thing for which people
       are willing to pay yet not receive.
-----------------------------------------------------------

Re: [Docutils-users] Test suite failure

[David Bruchmann <david.bruchmann@gm...>]

Hello Engelbert,

I know that a path like /mypath/ without "C:" works in Windows.
Nevertheless 'C:'  can be seen as the root-folder of any directory in
comparison to linux.
Without drive-letter you can't access a file of another drive that's
the same as you try to access /home/myFile.txt which is resided in
/usr/myFile.txt.
Therefore the drive-letter should left untouched as you wrote.
In general the result is correct in my opinion.

I think the tests should be adjusted NOT to throw an error
I don't know how to adjust the expected value as I never had a look in
the source-code but that's secondary. Sense of the tests is not to
make a 100% string-comparison but to test if the values are correct
and work, right?

David

On 6/26/14, engelbert gruber <engelbert.gruber@...> wrote:
> thanks for mentioning
>
> somehow this is in my workpile
> but i do not know how to solve
>
> ans therefore i am very interested opinions
>
> facts (as i remember)
>
> 1. a configured stylesheet "/style.css" results in an absolute path
> "c:/style.css" on windows.
> 2. a styleshhet inculding the drive letter only works for
>
>    - reading locally with the borwser
>    - only necessary if the stylesheet is on drive c: and the documents on
> another dirv
>      otherwise the document would work without the drive letter
>    - in the theoretic case of a server templating system with a
> postprocessor
>      removing the driveletter, before serving via http.
>
> therefore i would opt for removing of the drive letter.
> but the procedure prepending it is used all over docutils
> and if someone specifies "f:/test.css" the driveletter must be left
> untouched.
>
>
>
>
>
> On 26 June 2014 12:04, David Bruchmann <david.bruchmann@...> wrote:
>
>> Hello,
>>
>> I've the same bug as http://sourceforge.net/p/docutils/bugs/243/ but
>> can't
>> login in the moment to sourceforge.net.
>>
>> Here are more details:
>> primary it's always the same 'fault' (4 times):
>>
>>
>> -: expected
>> +: output
>> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
>>
>> Here is still my alltests.out:
>> ------------------------------
>> Testing Docutils 0.11 [release] with Python 2.7.6 on 2014-06-26 at
>> 16:13:05
>> Working directory: C:\Users\d_admin\Downloads\docutils-0.11\test
>> Docutils package: C:\Users\d_admin\Downloads\docutils-0.11\docutils
>>
>> test_writers\test_html4css1_template.py: totest['template'][0];
>> test_publish
>> (DocutilsTestSupport.WriterPublishTestCase)
>> input:
>> ================
>>  Document Title
>> ================
>> ----------
>>  Subtitle
>> ----------
>>
>> :Author: Me
>>
>> .. footer:: footer text
>>
>> Section
>> =======
>>
>> Some text.
>>
>> -: expected
>> +: output
>>   head_prefix = """\
>>   <?xml version="1.0" encoding="utf-8" ?>
>>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>>   <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>>   <head>"""
>>
>>
>>   head = """\
>>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>   <meta name="generator" content="Docutils 0.11:
>> http://docutils.sourceforge.net/"; />
>>   <title>Document Title</title>
>>   <meta name="author" content="Me" />"""
>>
>>
>>   stylesheet = """\
>> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
>> ?                              ++
>>
>>
>>   body_prefix = """\
>>   </head>
>>   <body>
>>   <div class="document" id="document-title">"""
>>
>>
>>   body_pre_docinfo = """\
>>   <h1 class="title">Document Title</h1>
>>   <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>>
>>
>>   docinfo = """\
>>   <table class="docinfo" frame="void" rules="none">
>>   <col class="docinfo-name" />
>>   <col class="docinfo-content" />
>>   <tbody valign="top">
>>   <tr><th class="docinfo-name">Author:</th>
>>   <td>Me</td></tr>
>>   </tbody>
>>   </table>"""
>>
>>
>>   body = """\
>>   <div class="section" id="section">
>>   <h1>Section</h1>
>>   <p>Some text.</p>
>>   </div>"""
>>
>>
>>   body_suffix = """\
>>   </div>
>>   <div class="footer">
>>   <hr class="footer" />
>>   footer text
>>   </div>
>>   </body>
>>   </html>"""
>>
>>
>>   head_prefix = """\
>>   <?xml version="1.0" encoding="utf-8" ?>
>>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>>   <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>>   <head>"""
>>
>>
>>   head = """\
>>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>   <meta name="generator" content="Docutils 0.11:
>> http://docutils.sourceforge.net/"; />
>>   <title>Document Title</title>
>>   <meta name="author" content="Me" />"""
>>
>>
>>   stylesheet = """\
>> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
>> ?                              ++
>>
>>
>>   body_prefix = """\
>>   </head>
>>   <body>
>>   <div class="document" id="document-title">"""
>>
>>
>>   body_pre_docinfo = """\
>>   <h1 class="title">Document Title</h1>
>>   <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>>
>>
>>   docinfo = """\
>>   <table class="docinfo" frame="void" rules="none">
>>   <col class="docinfo-name" />
>>   <col class="docinfo-content" />
>>   <tbody valign="top">
>>   <tr><th class="docinfo-name">Author:</th>
>>   <td>Me</td></tr>
>>   </tbody>
>>   </table>"""
>>
>>
>>   body = """\
>>   <div class="section" id="section">
>>   <h1>Section</h1>
>>   <p>Some text.</p>
>>   </div>"""
>>
>>
>>   body_suffix = """\
>>   </div>
>>   <div class="footer">
>>   <hr class="footer" />
>>   footer text
>>   </div>
>>   </body>
>>   </html>"""
>>
>>
>>   title = """\
>>   Document Title"""
>>
>>
>>   subtitle = """\
>>   Subtitle"""
>>
>>
>>   header = """\
>>   """
>>
>>
>>   footer = """\
>>   <div class="footer">
>>   <hr class="footer" />
>>   footer text
>>   </div>"""
>>
>>
>>   meta = """\
>>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>   <meta name="generator" content="Docutils 0.11:
>> http://docutils.sourceforge.net/"; />
>>   <meta name="author" content="Me" />"""
>>
>>
>>   fragment = """\
>>   <div class="section" id="section">
>>   <h1>Section</h1>
>>   <p>Some text.</p>
>>   </div>"""
>>
>>
>>   html_prolog = """\
>>   <?xml version="1.0" encoding="%s" ?>
>>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">""";
>>
>>
>>   html_head = """\
>>   <meta http-equiv="Content-Type" content="text/html; charset=%s" />
>>   <meta name="generator" content="Docutils 0.11:
>> http://docutils.sourceforge.net/"; />
>>   <title>Document Title</title>
>>   <meta name="author" content="Me" />"""
>>
>>
>>   html_title = """\
>>   <h1 class="title">Document Title</h1>"""
>>
>>
>>   html_subtitle = """\
>>   <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>>
>>
>>   html_body = """\
>>   <div class="document" id="document-title">
>>   <h1 class="title">Document Title</h1>
>>   <h2 class="subtitle" id="subtitle">Subtitle</h2>
>>   <table class="docinfo" frame="void" rules="none">
>>   <col class="docinfo-name" />
>>   <col class="docinfo-content" />
>>   <tbody valign="top">
>>   <tr><th class="docinfo-name">Author:</th>
>>   <td>Me</td></tr>
>>   </tbody>
>>   </table>
>>   <div class="section" id="section">
>>   <h1>Section</h1>
>>   <p>Some text.</p>
>>   </div>
>>   </div>
>>   <div class="footer">
>>   <hr class="footer" />
>>   footer text
>>   </div>"""
>>
>> test_writers\test_s5.py: totest['basics'][0]; test_publish
>> (DocutilsTestSupport.WriterPublishTestCase)
>> input:
>> ============
>>  Show Title
>> ============
>>
>> Title slide
>>
>> First Slide
>> ===========
>>
>> Slide text.
>>
>> -: expected
>> +: output
>>   <?xml version="1.0" encoding="utf-8" ?>
>>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>>   <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>>   <head>
>>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>   <meta name="generator" content="Docutils 0.11:
>> http://docutils.sourceforge.net/"; />
>>   <meta name="version" content="S5 1.1" />
>>   <title>Show Title</title>
>> - <link rel="stylesheet" href="/test.css" type="text/css" />
>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />
>> ?                              ++
>>   <!-- configuration parameters -->
>>   <meta name="defaultView" content="slideshow" />
>>   <meta name="controlVis" content="hidden" />
>>   <!-- style sheet links -->
>>   <script src="ui/default/slides.js" type="text/javascript"></script>
>>   <link rel="stylesheet" href="ui/default/slides.css"
>>         type="text/css" media="projection" id="slideProj" />
>>   <link rel="stylesheet" href="ui/default/outline.css"
>>         type="text/css" media="screen" id="outlineStyle" />
>>   <link rel="stylesheet" href="ui/default/print.css"
>>         type="text/css" media="print" id="slidePrint" />
>>   <link rel="stylesheet" href="ui/default/opera.css"
>>         type="text/css" media="projection" id="operaFix" />
>>
>>   <style type="text/css">
>>   #currentSlide {display: none;}
>>   </style>
>>   </head>
>>   <body>
>>   <div class="layout">
>>   <div id="controls"></div>
>>   <div id="currentSlide"></div>
>>   <div id="header">
>>
>>   </div>
>>   <div id="footer">
>>   <h1>Show Title</h1>
>>
>>   </div>
>>   </div>
>>   <div class="presentation">
>>   <div class="slide" id="slide0">
>>   <h1 class="title">Show Title</h1>
>>
>>   <p>Title slide</p>
>>
>>   </div>
>>   <div class="slide" id="first-slide">
>>   <h1>First Slide</h1>
>>   <p>Slide text.</p>
>>   </div>
>>   </div>
>>   </body>
>>   </html>
>>
>> test_writers\test_s5.py: totest['settings'][0]; test_publish
>> (DocutilsTestSupport.WriterPublishTestCase)
>> input:
>> ==================
>>  Bogus Slide Show
>> ==================
>>
>> We're just checking the settings
>>
>> -: expected
>> +: output
>>   <?xml version="1.0" encoding="utf-8" ?>
>>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
>> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>>   <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>>   <head>
>>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>>   <meta name="generator" content="Docutils 0.11:
>> http://docutils.sourceforge.net/"; />
>>   <meta name="version" content="S5 1.1" />
>>   <title>Bogus Slide Show</title>
>> - <link rel="stylesheet" href="/test.css" type="text/css" />
>> + <link rel="stylesheet" href="C:/test.css" type="text/css" />
>> ?                              ++
>>   <!-- configuration parameters -->
>>   <meta name="defaultView" content="outline" />
>>   <meta name="controlVis" content="visible" />
>>   <!-- style sheet links -->
>>   <script src="ui/default/slides.js" type="text/javascript"></script>
>>   <link rel="stylesheet" href="ui/default/slides.css"
>>         type="text/css" media="projection" id="slideProj" />
>>   <link rel="stylesheet" href="ui/default/outline.css"
>>         type="text/css" media="screen" id="outlineStyle" />
>>   <link rel="stylesheet" href="ui/default/print.css"
>>         type="text/css" media="print" id="slidePrint" />
>>   <link rel="stylesheet" href="ui/default/opera.css"
>>         type="text/css" media="projection" id="operaFix" />
>>
>>   <style type="text/css">
>>   #currentSlide {display: none;}
>>   </style>
>>   </head>
>>   <body>
>>   <div class="layout">
>>   <div id="controls"></div>
>>   <div id="currentSlide"></div>
>>   <div id="header">
>>
>>   </div>
>>   <div id="footer">
>>   <h1>Bogus Slide Show</h1>
>>
>>   </div>
>>   </div>
>>   <div class="presentation">
>>   <div class="slide" id="slide0">
>>   <h1 class="title">Bogus Slide Show</h1>
>>
>>   <p>We're just checking the settings</p>
>>   </div>
>>   </div>
>>   </body>
>>   </html>
>> Elapsed time: 57.993 seconds
>>
>> ------------------------------
>>
>>
>>
>>
>>
>> ------------------------------------------------------------------------------
>> Open source business process management suite built on Java and Eclipse
>> Turn processes into business applications with Bonita BPM Community
>> Edition
>> Quickly connect people, data, and systems into organized workflows
>> Winner of BOSSIE, CODIE, OW2 and Gartner awards
>> http://p.sf.net/sfu/Bonitasoft
>> _______________________________________________
>> Docutils-users mailing list
>> Docutils-users@...
>> https://lists.sourceforge.net/lists/listinfo/docutils-users
>>
>> Please use "Reply All" to reply to the list.
>>
>

Re: [Docutils-users] Test suite failure

[engelbert gruber <engelbert.gruber@gm...>]

thanks for mentioning

somehow this is in my workpile
but i do not know how to solve

ans therefore i am very interested opinions

facts (as i remember)

1. a configured stylesheet "/style.css" results in an absolute path
"c:/style.css" on windows.
2. a styleshhet inculding the drive letter only works for

   - reading locally with the borwser
   - only necessary if the stylesheet is on drive c: and the documents on
another dirv
     otherwise the document would work without the drive letter
   - in the theoretic case of a server templating system with a
postprocessor
     removing the driveletter, before serving via http.

therefore i would opt for removing of the drive letter.
but the procedure prepending it is used all over docutils
and if someone specifies "f:/test.css" the driveletter must be left
untouched.





On 26 June 2014 12:04, David Bruchmann <david.bruchmann@...> wrote:

> Hello,
>
> I've the same bug as http://sourceforge.net/p/docutils/bugs/243/ but can't
> login in the moment to sourceforge.net.
>
> Here are more details:
> primary it's always the same 'fault' (4 times):
>
>
> -: expected
> +: output
> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
>
> Here is still my alltests.out:
> ------------------------------
> Testing Docutils 0.11 [release] with Python 2.7.6 on 2014-06-26 at 16:13:05
> Working directory: C:\Users\d_admin\Downloads\docutils-0.11\test
> Docutils package: C:\Users\d_admin\Downloads\docutils-0.11\docutils
>
> test_writers\test_html4css1_template.py: totest['template'][0];
> test_publish
> (DocutilsTestSupport.WriterPublishTestCase)
> input:
> ================
>  Document Title
> ================
> ----------
>  Subtitle
> ----------
>
> :Author: Me
>
> .. footer:: footer text
>
> Section
> =======
>
> Some text.
>
> -: expected
> +: output
>   head_prefix = """\
>   <?xml version="1.0" encoding="utf-8" ?>
>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>   <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>   <head>"""
>
>
>   head = """\
>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>   <meta name="generator" content="Docutils 0.11:
> http://docutils.sourceforge.net/"; />
>   <title>Document Title</title>
>   <meta name="author" content="Me" />"""
>
>
>   stylesheet = """\
> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
> ?                              ++
>
>
>   body_prefix = """\
>   </head>
>   <body>
>   <div class="document" id="document-title">"""
>
>
>   body_pre_docinfo = """\
>   <h1 class="title">Document Title</h1>
>   <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>
>
>   docinfo = """\
>   <table class="docinfo" frame="void" rules="none">
>   <col class="docinfo-name" />
>   <col class="docinfo-content" />
>   <tbody valign="top">
>   <tr><th class="docinfo-name">Author:</th>
>   <td>Me</td></tr>
>   </tbody>
>   </table>"""
>
>
>   body = """\
>   <div class="section" id="section">
>   <h1>Section</h1>
>   <p>Some text.</p>
>   </div>"""
>
>
>   body_suffix = """\
>   </div>
>   <div class="footer">
>   <hr class="footer" />
>   footer text
>   </div>
>   </body>
>   </html>"""
>
>
>   head_prefix = """\
>   <?xml version="1.0" encoding="utf-8" ?>
>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>   <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>   <head>"""
>
>
>   head = """\
>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>   <meta name="generator" content="Docutils 0.11:
> http://docutils.sourceforge.net/"; />
>   <title>Document Title</title>
>   <meta name="author" content="Me" />"""
>
>
>   stylesheet = """\
> - <link rel="stylesheet" href="/test.css" type="text/css" />"""
> + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
> ?                              ++
>
>
>   body_prefix = """\
>   </head>
>   <body>
>   <div class="document" id="document-title">"""
>
>
>   body_pre_docinfo = """\
>   <h1 class="title">Document Title</h1>
>   <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>
>
>   docinfo = """\
>   <table class="docinfo" frame="void" rules="none">
>   <col class="docinfo-name" />
>   <col class="docinfo-content" />
>   <tbody valign="top">
>   <tr><th class="docinfo-name">Author:</th>
>   <td>Me</td></tr>
>   </tbody>
>   </table>"""
>
>
>   body = """\
>   <div class="section" id="section">
>   <h1>Section</h1>
>   <p>Some text.</p>
>   </div>"""
>
>
>   body_suffix = """\
>   </div>
>   <div class="footer">
>   <hr class="footer" />
>   footer text
>   </div>
>   </body>
>   </html>"""
>
>
>   title = """\
>   Document Title"""
>
>
>   subtitle = """\
>   Subtitle"""
>
>
>   header = """\
>   """
>
>
>   footer = """\
>   <div class="footer">
>   <hr class="footer" />
>   footer text
>   </div>"""
>
>
>   meta = """\
>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>   <meta name="generator" content="Docutils 0.11:
> http://docutils.sourceforge.net/"; />
>   <meta name="author" content="Me" />"""
>
>
>   fragment = """\
>   <div class="section" id="section">
>   <h1>Section</h1>
>   <p>Some text.</p>
>   </div>"""
>
>
>   html_prolog = """\
>   <?xml version="1.0" encoding="%s" ?>
>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">""";
>
>
>   html_head = """\
>   <meta http-equiv="Content-Type" content="text/html; charset=%s" />
>   <meta name="generator" content="Docutils 0.11:
> http://docutils.sourceforge.net/"; />
>   <title>Document Title</title>
>   <meta name="author" content="Me" />"""
>
>
>   html_title = """\
>   <h1 class="title">Document Title</h1>"""
>
>
>   html_subtitle = """\
>   <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
>
>
>   html_body = """\
>   <div class="document" id="document-title">
>   <h1 class="title">Document Title</h1>
>   <h2 class="subtitle" id="subtitle">Subtitle</h2>
>   <table class="docinfo" frame="void" rules="none">
>   <col class="docinfo-name" />
>   <col class="docinfo-content" />
>   <tbody valign="top">
>   <tr><th class="docinfo-name">Author:</th>
>   <td>Me</td></tr>
>   </tbody>
>   </table>
>   <div class="section" id="section">
>   <h1>Section</h1>
>   <p>Some text.</p>
>   </div>
>   </div>
>   <div class="footer">
>   <hr class="footer" />
>   footer text
>   </div>"""
>
> test_writers\test_s5.py: totest['basics'][0]; test_publish
> (DocutilsTestSupport.WriterPublishTestCase)
> input:
> ============
>  Show Title
> ============
>
> Title slide
>
> First Slide
> ===========
>
> Slide text.
>
> -: expected
> +: output
>   <?xml version="1.0" encoding="utf-8" ?>
>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>   <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>   <head>
>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>   <meta name="generator" content="Docutils 0.11:
> http://docutils.sourceforge.net/"; />
>   <meta name="version" content="S5 1.1" />
>   <title>Show Title</title>
> - <link rel="stylesheet" href="/test.css" type="text/css" />
> + <link rel="stylesheet" href="C:/test.css" type="text/css" />
> ?                              ++
>   <!-- configuration parameters -->
>   <meta name="defaultView" content="slideshow" />
>   <meta name="controlVis" content="hidden" />
>   <!-- style sheet links -->
>   <script src="ui/default/slides.js" type="text/javascript"></script>
>   <link rel="stylesheet" href="ui/default/slides.css"
>         type="text/css" media="projection" id="slideProj" />
>   <link rel="stylesheet" href="ui/default/outline.css"
>         type="text/css" media="screen" id="outlineStyle" />
>   <link rel="stylesheet" href="ui/default/print.css"
>         type="text/css" media="print" id="slidePrint" />
>   <link rel="stylesheet" href="ui/default/opera.css"
>         type="text/css" media="projection" id="operaFix" />
>
>   <style type="text/css">
>   #currentSlide {display: none;}
>   </style>
>   </head>
>   <body>
>   <div class="layout">
>   <div id="controls"></div>
>   <div id="currentSlide"></div>
>   <div id="header">
>
>   </div>
>   <div id="footer">
>   <h1>Show Title</h1>
>
>   </div>
>   </div>
>   <div class="presentation">
>   <div class="slide" id="slide0">
>   <h1 class="title">Show Title</h1>
>
>   <p>Title slide</p>
>
>   </div>
>   <div class="slide" id="first-slide">
>   <h1>First Slide</h1>
>   <p>Slide text.</p>
>   </div>
>   </div>
>   </body>
>   </html>
>
> test_writers\test_s5.py: totest['settings'][0]; test_publish
> (DocutilsTestSupport.WriterPublishTestCase)
> input:
> ==================
>  Bogus Slide Show
> ==================
>
> We're just checking the settings
>
> -: expected
> +: output
>   <?xml version="1.0" encoding="utf-8" ?>
>   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
>   <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
>   <head>
>   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>   <meta name="generator" content="Docutils 0.11:
> http://docutils.sourceforge.net/"; />
>   <meta name="version" content="S5 1.1" />
>   <title>Bogus Slide Show</title>
> - <link rel="stylesheet" href="/test.css" type="text/css" />
> + <link rel="stylesheet" href="C:/test.css" type="text/css" />
> ?                              ++
>   <!-- configuration parameters -->
>   <meta name="defaultView" content="outline" />
>   <meta name="controlVis" content="visible" />
>   <!-- style sheet links -->
>   <script src="ui/default/slides.js" type="text/javascript"></script>
>   <link rel="stylesheet" href="ui/default/slides.css"
>         type="text/css" media="projection" id="slideProj" />
>   <link rel="stylesheet" href="ui/default/outline.css"
>         type="text/css" media="screen" id="outlineStyle" />
>   <link rel="stylesheet" href="ui/default/print.css"
>         type="text/css" media="print" id="slidePrint" />
>   <link rel="stylesheet" href="ui/default/opera.css"
>         type="text/css" media="projection" id="operaFix" />
>
>   <style type="text/css">
>   #currentSlide {display: none;}
>   </style>
>   </head>
>   <body>
>   <div class="layout">
>   <div id="controls"></div>
>   <div id="currentSlide"></div>
>   <div id="header">
>
>   </div>
>   <div id="footer">
>   <h1>Bogus Slide Show</h1>
>
>   </div>
>   </div>
>   <div class="presentation">
>   <div class="slide" id="slide0">
>   <h1 class="title">Bogus Slide Show</h1>
>
>   <p>We're just checking the settings</p>
>   </div>
>   </div>
>   </body>
>   </html>
> Elapsed time: 57.993 seconds
>
> ------------------------------
>
>
>
>
>
> ------------------------------------------------------------------------------
> Open source business process management suite built on Java and Eclipse
> Turn processes into business applications with Bonita BPM Community Edition
> Quickly connect people, data, and systems into organized workflows
> Winner of BOSSIE, CODIE, OW2 and Gartner awards
> http://p.sf.net/sfu/Bonitasoft
> _______________________________________________
> Docutils-users mailing list
> Docutils-users@...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>

[Docutils-users] Equation numbering in LaTeX writer

[Eduard Bopp <eduard.bopp@ae...>]

Hello,

I've been using docutils and reStructuredText to write a scientific
document. While I'm fairly happy with the results so far, I have some
trouble enumerating and referencing equations. It appears that docutils
supports this in principle, as the signature of
utils.math.pick_math_environment suggests. However, the LaTeX does not
make use of this feature, as far as I can see.

My current workaround is to change line 2529 of
writers/latex2e/__init__.py from

    math_env = pick_math_environment(node.astext())

to

    math_env = pick_math_environment(node.astext(), numbered=True)

This enables enumeration and allows me to label and reference my
equations using raw LaTeX. While this solves my practical issue, I think
it's not exactly an elegant solution. Is there a more straightforward
and perhaps target-independent way to achieve this?

Cheers,
Eduard.

[Docutils-users] Test suite failure

[David Bruchmann <david.bruchmann@gm...>]

Hello,

I've the same bug as http://sourceforge.net/p/docutils/bugs/243/ but can't 
login in the moment to sourceforge.net.

Here are more details:
primary it's always the same 'fault' (4 times):


-: expected
+: output
- <link rel="stylesheet" href="/test.css" type="text/css" />"""
+ <link rel="stylesheet" href="C:/test.css" type="text/css" />"""

Here is still my alltests.out:
------------------------------
Testing Docutils 0.11 [release] with Python 2.7.6 on 2014-06-26 at 16:13:05
Working directory: C:\Users\d_admin\Downloads\docutils-0.11\test
Docutils package: C:\Users\d_admin\Downloads\docutils-0.11\docutils

test_writers\test_html4css1_template.py: totest['template'][0]; test_publish 
(DocutilsTestSupport.WriterPublishTestCase)
input:
================
 Document Title
================
----------
 Subtitle
----------

:Author: Me

.. footer:: footer text

Section
=======

Some text.

-: expected
+: output
  head_prefix = """\
  <?xml version="1.0" encoding="utf-8" ?>
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
  <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
  <head>"""
  
  
  head = """\
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.11: 
http://docutils.sourceforge.net/"; />
  <title>Document Title</title>
  <meta name="author" content="Me" />"""
  
  
  stylesheet = """\
- <link rel="stylesheet" href="/test.css" type="text/css" />"""
+ <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
?                              ++
  
  
  body_prefix = """\
  </head>
  <body>
  <div class="document" id="document-title">"""
  
  
  body_pre_docinfo = """\
  <h1 class="title">Document Title</h1>
  <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
  
  
  docinfo = """\
  <table class="docinfo" frame="void" rules="none">
  <col class="docinfo-name" />
  <col class="docinfo-content" />
  <tbody valign="top">
  <tr><th class="docinfo-name">Author:</th>
  <td>Me</td></tr>
  </tbody>
  </table>"""
  
  
  body = """\
  <div class="section" id="section">
  <h1>Section</h1>
  <p>Some text.</p>
  </div>"""
  
  
  body_suffix = """\
  </div>
  <div class="footer">
  <hr class="footer" />
  footer text
  </div>
  </body>
  </html>"""
  
  
  head_prefix = """\
  <?xml version="1.0" encoding="utf-8" ?>
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
  <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
  <head>"""
  
  
  head = """\
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.11: 
http://docutils.sourceforge.net/"; />
  <title>Document Title</title>
  <meta name="author" content="Me" />"""
  
  
  stylesheet = """\
- <link rel="stylesheet" href="/test.css" type="text/css" />"""
+ <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
?                              ++
  
  
  body_prefix = """\
  </head>
  <body>
  <div class="document" id="document-title">"""
  
  
  body_pre_docinfo = """\
  <h1 class="title">Document Title</h1>
  <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
  
  
  docinfo = """\
  <table class="docinfo" frame="void" rules="none">
  <col class="docinfo-name" />
  <col class="docinfo-content" />
  <tbody valign="top">
  <tr><th class="docinfo-name">Author:</th>
  <td>Me</td></tr>
  </tbody>
  </table>"""
  
  
  body = """\
  <div class="section" id="section">
  <h1>Section</h1>
  <p>Some text.</p>
  </div>"""
  
  
  body_suffix = """\
  </div>
  <div class="footer">
  <hr class="footer" />
  footer text
  </div>
  </body>
  </html>"""
  
  
  title = """\
  Document Title"""
  
  
  subtitle = """\
  Subtitle"""
  
  
  header = """\
  """
  
  
  footer = """\
  <div class="footer">
  <hr class="footer" />
  footer text
  </div>"""
  
  
  meta = """\
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.11: 
http://docutils.sourceforge.net/"; />
  <meta name="author" content="Me" />"""
  
  
  fragment = """\
  <div class="section" id="section">
  <h1>Section</h1>
  <p>Some text.</p>
  </div>"""
  
  
  html_prolog = """\
  <?xml version="1.0" encoding="%s" ?>
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">""";
  
  
  html_head = """\
  <meta http-equiv="Content-Type" content="text/html; charset=%s" />
  <meta name="generator" content="Docutils 0.11: 
http://docutils.sourceforge.net/"; />
  <title>Document Title</title>
  <meta name="author" content="Me" />"""
  
  
  html_title = """\
  <h1 class="title">Document Title</h1>"""
  
  
  html_subtitle = """\
  <h2 class="subtitle" id="subtitle">Subtitle</h2>"""
  
  
  html_body = """\
  <div class="document" id="document-title">
  <h1 class="title">Document Title</h1>
  <h2 class="subtitle" id="subtitle">Subtitle</h2>
  <table class="docinfo" frame="void" rules="none">
  <col class="docinfo-name" />
  <col class="docinfo-content" />
  <tbody valign="top">
  <tr><th class="docinfo-name">Author:</th>
  <td>Me</td></tr>
  </tbody>
  </table>
  <div class="section" id="section">
  <h1>Section</h1>
  <p>Some text.</p>
  </div>
  </div>
  <div class="footer">
  <hr class="footer" />
  footer text
  </div>"""

test_writers\test_s5.py: totest['basics'][0]; test_publish 
(DocutilsTestSupport.WriterPublishTestCase)
input:
============
 Show Title
============

Title slide

First Slide
===========

Slide text.

-: expected
+: output
  <?xml version="1.0" encoding="utf-8" ?>
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
  <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
  <head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.11: 
http://docutils.sourceforge.net/"; />
  <meta name="version" content="S5 1.1" />
  <title>Show Title</title>
- <link rel="stylesheet" href="/test.css" type="text/css" />
+ <link rel="stylesheet" href="C:/test.css" type="text/css" />
?                              ++
  <!-- configuration parameters -->
  <meta name="defaultView" content="slideshow" />
  <meta name="controlVis" content="hidden" />
  <!-- style sheet links -->
  <script src="ui/default/slides.js" type="text/javascript"></script>
  <link rel="stylesheet" href="ui/default/slides.css"
        type="text/css" media="projection" id="slideProj" />
  <link rel="stylesheet" href="ui/default/outline.css"
        type="text/css" media="screen" id="outlineStyle" />
  <link rel="stylesheet" href="ui/default/print.css"
        type="text/css" media="print" id="slidePrint" />
  <link rel="stylesheet" href="ui/default/opera.css"
        type="text/css" media="projection" id="operaFix" />
  
  <style type="text/css">
  #currentSlide {display: none;}
  </style>
  </head>
  <body>
  <div class="layout">
  <div id="controls"></div>
  <div id="currentSlide"></div>
  <div id="header">
  
  </div>
  <div id="footer">
  <h1>Show Title</h1>
  
  </div>
  </div>
  <div class="presentation">
  <div class="slide" id="slide0">
  <h1 class="title">Show Title</h1>
  
  <p>Title slide</p>
  
  </div>
  <div class="slide" id="first-slide">
  <h1>First Slide</h1>
  <p>Slide text.</p>
  </div>
  </div>
  </body>
  </html>

test_writers\test_s5.py: totest['settings'][0]; test_publish 
(DocutilsTestSupport.WriterPublishTestCase)
input:
==================
 Bogus Slide Show
==================

We're just checking the settings

-: expected
+: output
  <?xml version="1.0" encoding="utf-8" ?>
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">;
  <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
  <head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.11: 
http://docutils.sourceforge.net/"; />
  <meta name="version" content="S5 1.1" />
  <title>Bogus Slide Show</title>
- <link rel="stylesheet" href="/test.css" type="text/css" />
+ <link rel="stylesheet" href="C:/test.css" type="text/css" />
?                              ++
  <!-- configuration parameters -->
  <meta name="defaultView" content="outline" />
  <meta name="controlVis" content="visible" />
  <!-- style sheet links -->
  <script src="ui/default/slides.js" type="text/javascript"></script>
  <link rel="stylesheet" href="ui/default/slides.css"
        type="text/css" media="projection" id="slideProj" />
  <link rel="stylesheet" href="ui/default/outline.css"
        type="text/css" media="screen" id="outlineStyle" />
  <link rel="stylesheet" href="ui/default/print.css"
        type="text/css" media="print" id="slidePrint" />
  <link rel="stylesheet" href="ui/default/opera.css"
        type="text/css" media="projection" id="operaFix" />
  
  <style type="text/css">
  #currentSlide {display: none;}
  </style>
  </head>
  <body>
  <div class="layout">
  <div id="controls"></div>
  <div id="currentSlide"></div>
  <div id="header">
  
  </div>
  <div id="footer">
  <h1>Bogus Slide Show</h1>
  
  </div>
  </div>
  <div class="presentation">
  <div class="slide" id="slide0">
  <h1 class="title">Bogus Slide Show</h1>
  
  <p>We're just checking the settings</p>
  </div>
  </div>
  </body>
  </html>
Elapsed time: 57.993 seconds

------------------------------

Re: [Docutils-users] rst2wiki.py problem

[David Goodger <goodger@py...>]

> NotImplementedError: docutils.writers.wiki.TWikiTranslator visiting unknown
> node type: transition

I'm not Joshua, and I don't know the code in question, but the message
above tells me that the wiki.py module simply doesn't handle
"transition" nodes. You could either remove the transitions from your
source, or add code to the wiki.py module to handle them. After you do
that, if you get other similar "NotImplementedError" messages, you'll
have to repeat the process.

-- David Goodger


On Tue, Jun 10, 2014 at 11:28 AM, McHugh, Michael
<Michael_McHugh@...> wrote:
> Hi Joshua,
>
>
>
> I am having some trouble converting some documents from RST to twiki format.
> I wonder if there’s something obvious that I’m doing wrong...
>
>
>
> I am using Windows Python 2.7 within a Cygwin shell (although I get similar
> output from a “cmd” shell window).
>
>
>
> I have copied the following files as indicated
>
> rst2wiki.py è C:\Python27\Scripts\
>
> wiki.py è C:\Python27\Lib\site-packages\docutils\writers\
>
>
>
> I get the following output:
>
>
>
> mm@... ~
>
> $ /cygdrive/c/Python27/python.exe C:/Python27/Scripts/rst2wiki.py --wiki
> twiki test.rst test.twiki
>
> Exiting due to error.  Use "--traceback" to diagnose.
>
> Please report errors to <docutils-users@...>.
>
> Include "--traceback" output, Docutils version (0.11 [repository]),
>
> Python version (2.7.2), your OS type & version, and the
>
> command line used.
>
>
>
> mm@... ~
>
> $ /cygdrive/c/Python27/python.exe C:/Python27/Scripts/rst2wiki.py
> --traceback --wiki twiki test.rst test.twiki
>
> Traceback (most recent call last):
>
>   File "C:/Python27/Scripts/rst2wiki.py", line 37, in <module>
>
>     publish_cmdline(writer=wiki.Writer(), description=description)
>
>   File "C:\Python27\lib\site-packages\docutils\core.py", line 352, in
> publish_cmdline
>
>     config_section=config_section, enable_exit_status=enable_exit_status)
>
>   File "C:\Python27\lib\site-packages\docutils\core.py", line 219, in
> publish
>
>     output = self.writer.write(self.document, self.destination)
>
>   File "C:\Python27\lib\site-packages\docutils\writers\__init__.py", line
> 80, in write
>
>     self.translate()
>
>   File "C:\Python27\lib\site-packages\docutils\writers\wiki.py", line 55, in
> translate
>
>     self.document.walkabout(visitor)
>
>   File "C:\Python27\lib\site-packages\docutils\nodes.py", line 174, in
> walkabout
>
>     if child.walkabout(visitor):
>
>   File "C:\Python27\lib\site-packages\docutils\nodes.py", line 166, in
> walkabout
>
>     visitor.dispatch_visit(self)
>
>   File "C:\Python27\lib\site-packages\docutils\nodes.py", line 1882, in
> dispatch_visit
>
>     return method(node)
>
>   File "C:\Python27\lib\site-packages\docutils\nodes.py", line 1907, in
> unknown_visit
>
>     % (self.__class__, node.__class__.__name__))
>
> NotImplementedError: docutils.writers.wiki.TWikiTranslator visiting unknown
> node type: transition
>
>
>
>
>
> If I can’t use this tool, my team and I might have to convert the RST to
> wiki by hand (ugh...) or we might roll-our-own script to do most of the
> heavy lifting. We would love to use the tool you’ve created though!
>
>
>
> Many thanks for your help!
>
>
>
> Mike McHugh
>
> DSP Engineer
>
> Automotive Systems Division
>
> Bose Corporation
>
> Michael_McHugh@...
>
> office: (508)-305-4531
>
> cell: (970)-367-6443
>
>
>
>
> ------------------------------------------------------------------------------
> HPCC Systems Open Source Big Data Platform from LexisNexis Risk Solutions
> Find What Matters Most in Your Big Data with HPCC Systems
> Open Source. Fast. Scalable. Simple. Ideal for Dirty Data.
> Leverages Graph Analysis for Fast Processing & Easy Data Exploration
> http://p.sf.net/sfu/hpccsystems
> _______________________________________________
> Docutils-users mailing list
> Docutils-users@...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>

[Docutils-users] rst2wiki.py problem

[McHugh, Michael <Michael_McH<ugh@bo...>]

Hi Joshua,

I am having some trouble converting some documents from RST to twiki format. I wonder if there's something obvious that I'm doing wrong...

I am using Windows Python 2.7 within a Cygwin shell (although I get similar output from a "cmd" shell window).

I have copied the following files as indicated
rst2wiki.py ==> C:\Python27\Scripts\
wiki.py ==> C:\Python27\Lib\site-packages\docutils\writers\

I get the following output:

mm@... ~
$ /cygdrive/c/Python27/python.exe C:/Python27/Scripts/rst2wiki.py --wiki twiki test.rst test.twiki
NotImplementedError: docutils.writers.wiki.TWikiTranslator visiting unknown node type: transition
Exiting due to error.  Use "--traceback" to diagnose.
Please report errors to <docutils-users@...>.
Include "--traceback" output, Docutils version (0.11 [repository]),
Python version (2.7.2), your OS type & version, and the
command line used.

mm@... ~
$ /cygdrive/c/Python27/python.exe C:/Python27/Scripts/rst2wiki.py --traceback --wiki twiki test.rst test.twiki
Traceback (most recent call last):
  File "C:/Python27/Scripts/rst2wiki.py", line 37, in <module>
    publish_cmdline(writer=wiki.Writer(), description=description)
  File "C:\Python27\lib\site-packages\docutils\core.py", line 352, in publish_cmdline
    config_section=config_section, enable_exit_status=enable_exit_status)
  File "C:\Python27\lib\site-packages\docutils\core.py", line 219, in publish
    output = self.writer.write(self.document, self.destination)
  File "C:\Python27\lib\site-packages\docutils\writers\__init__.py", line 80, in write
    self.translate()
  File "C:\Python27\lib\site-packages\docutils\writers\wiki.py", line 55, in translate
    self.document.walkabout(visitor)
  File "C:\Python27\lib\site-packages\docutils\nodes.py", line 174, in walkabout
    if child.walkabout(visitor):
  File "C:\Python27\lib\site-packages\docutils\nodes.py", line 166, in walkabout
    visitor.dispatch_visit(self)
  File "C:\Python27\lib\site-packages\docutils\nodes.py", line 1882, in dispatch_visit
    return method(node)
  File "C:\Python27\lib\site-packages\docutils\nodes.py", line 1907, in unknown_visit
    % (self.__class__, node.__class__.__name__))
NotImplementedError: docutils.writers.wiki.TWikiTranslator visiting unknown node type: transition


If I can't use this tool, my team and I might have to convert the RST to wiki by hand (ugh...) or we might roll-our-own script to do most of the heavy lifting. We would love to use the tool you've created though!

Many thanks for your help!

Mike McHugh
DSP Engineer
Automotive Systems Division
Bose Corporation
Michael_McHugh@...<mailto:Michael_McHugh@...>
office: (508)-305-4531
cell: (970)-367-6443

Re: [Docutils-users] csv-table directive: excluding columns

[Guenter Milde <milde@us...>]

On 2014-06-05, Chancy Kennedy wrote:

> [-- Type: text/plain, Encoding:  --]

> Hello. I've made a modification to the csv-table directive to use zeroes in
> the :widths: option to trigger the exclusion of those columns, e.g. ...

> .. csv-table::
>     :file: file.csv
>     :widths: 30, 35, 0, 0, 0, 0, 35

> ... would exclude columns 3 - 6 from being rendered. I'm not very familiar
> with docutils. Is this something a patch would be desired for and are there
> other modifications I should make for consistency across the table family
> of directives?

It is an interesting addition that does not stand in the way, so IMV this is
worth a patch. It should be done on the parser side, so that it works for all
writers.

Günter

Re: [Docutils-users] Substitution in Admonitions

[Caplan, Michael <Michael.C<aplan@he...>]

Thanks for the clarification David.  I had the FAQ pointed out to me on this subject since my original email.  Certainly a RTFM moment.  :)  Sorry about that.  

Appreciate your explanation.  

Your solution is interesting, but we only want to place selective emphasis on noted areas.  

Thanks!

Mike

________________________________________
From: dgoodger@... [dgoodger@...] on behalf of David Goodger [goodger@...]
Sent: Monday, June 09, 2014 1:18 PM
To: Caplan, Michael
Cc: docutils-users@...
Subject: Re: [Docutils-users] Substitution in Admonitions

On Mon, Jun 9, 2014 at 9:20 AM, Caplan, Michael
<Michael.Caplan@...> wrote:
> Hi,
>
> I hope I'm in the right place to be asking this question.  I originally posted this question in the Sphinx doc user list, but I think this is a reStructuredText question specifically.
>
> Total newbie question.  How can I do a substitution in an admonition?
>
> For example:
>
> |p| account
>
> .. note::
>
>     **Been using |p| separately and now integrating?**

You're trying to do nested inline markup here, which Docutils doesn't
support. This has nothing to do with admonitions. The same thing
(substitution inside emphasis) won't work in any context, but the
substitution *will* work if you remove the strong emphasis ("**")
markup above.

Instead, why not style your Note admonitions? Add boldface to your
stylesheet, and drop the markup.

--
David Goodger <http://python.net/~goodger>;



Please consider the environment before printing this email.


E-mail messages may contain viruses, worms, or other malicious code. By reading the message and opening any attachments, the recipient accepts full responsibility for taking protective action against such code. Henry Schein is not liable for any loss or damage arising from this message.

The information in this email is confidential and may be legally privileged. It is intended solely for the addressee(s). Access to this e-mail by anyone else is unauthorized.

Re: [Docutils-users] Substitution in Admonitions

[David Goodger <goodger@py...>]

On Mon, Jun 9, 2014 at 9:20 AM, Caplan, Michael
<Michael.Caplan@...> wrote:
> Hi,
>
> I hope I'm in the right place to be asking this question.  I originally posted this question in the Sphinx doc user list, but I think this is a reStructuredText question specifically.
>
> Total newbie question.  How can I do a substitution in an admonition?
>
> For example:
>
> |p| account
>
> .. note::
>
>     **Been using |p| separately and now integrating?**

You're trying to do nested inline markup here, which Docutils doesn't
support. This has nothing to do with admonitions. The same thing
(substitution inside emphasis) won't work in any context, but the
substitution *will* work if you remove the strong emphasis ("**")
markup above.

Instead, why not style your Note admonitions? Add boldface to your
stylesheet, and drop the markup.

-- 
David Goodger <http://python.net/~goodger>;

[Docutils-users] Substitution in Admonitions

[Caplan, Michael <Michael.C<aplan@he...>]

Hi,

I hope I'm in the right place to be asking this question.  I originally posted this question in the Sphinx doc user list, but I think this is a reStructuredText question specifically.

Total newbie question.  How can I do a substitution in an admonition?

For example:

|p| account

.. note::

    **Been using |p| separately and now integrating?**



In my sphinx conf.py I define a replacement rule which gets appended to the rst file prior to interpretation (at least that is how I understand it):

rst_epilog = '.. |p| replace:: Labnext'



My first substitution in the paragraph works without fail.  However the substitution in the note directive isn't applied.  Any work arounds?  Is this a quirk of Sphinx?

Thanks,

Mike



Please consider the environment before printing this email.


E-mail messages may contain viruses, worms, or other malicious code. By reading the message and opening any attachments, the recipient accepts full responsibility for taking protective action against such code. Henry Schein is not liable for any loss or damage arising from this message.

The information in this email is confidential and may be legally privileged. It is intended solely for the addressee(s). Access to this e-mail by anyone else is unauthorized.

Re: [Docutils-users] rst2html link to given page in pdf document

[David Goodger <goodger@py...>]

On Jun 6, 2014 5:18 PM, "Alan Bromborsky" <abrombo@...> wrote:
>
> On 06/06/2014 05:52 PM, David Goodger wrote:
>>
>> On Fri, Jun 6, 2014 at 9:40 AM, Alan Bromborsky <abrombo@...>
wrote:
>>>
>>> I wish to link to a given page in a pdf document from the html document
>>> generated by rst2html:
>>>
>>> The following works (in the rst file) - :download:`GA
>>> <../LaTeX_docs/GA.pdf>`
>>> to open GA.pdf at the beginning.
>>> The following does not work - :download:`GA
<../LaTeX_docs/GA.pdf#page=12>`
>>> to open GA.pdf at page 12. However if I use - :download:`GA
>>> <../LaTeX_docs/GA.pdf>`
>>> in the rst file and then change - _downloads/GA.pdf
>>> in the html file to - _downloads/GA.pdf#page=12
>>> then the link does open on page 12. Do you know of anyway to code this
>>> directly in the rst file?
>>
>> What does ":download:`URL`" do? I've never seen that before.
>>
>> Putting "#page=12" into the RST source ought to work fine, and it
>> would if it were a simple link (without the :download: part, e.g. just
>> "`GA <../LaTeX_docs/GA.pdf#page=12>`_". This produces the following
>> HTML:
>>
>> <a class="reference external" href="../LaTeX_docs/GA.pdf#page=12">GA</a>
>>
>> Please show us the HTML output you get, when you include that parameter.
>>
>
> Note that my rst file is processed with python-sphinx.

I can't help you with Sphinx-specific markup ("download"), sorry. Perhaps
ask on the Sphinx list.

>  The rst text and the resulting html output is shown below
>
> rst html
>
> `GA <../LaTeX_docs/GA.pdf>`

Note that you need a trailing underscore for this to work. See my example
above.

DG

> <cite>GA &lt;../LaTeX_docs/GA.pdf&gt;</cite>
> :download:`GA <../LaTeX_docs/GA.pdf>`                               <a
class="reference download internal" href="_downloads/GA.pdf"><tt
class="xref download docutils literal"><span
class="pre">GA</span></div>:download:`GA <../LaTeX_docs/GA.pdf#page=12>`
<tt class="xref download docutils literal"><span class="pre">GA</span>

Re: [Docutils-users] rst2html link to given page in pdf document

[Юрий Кудряшов <urkud@ur...>]

Alan Bromborsky wrote:

> I wish to link to a given page in a pdf document from the html document
> generated by rst2html:
> 
> The following does not work - :download:`GA
> <../LaTeX_docs/GA.pdf#page=12>` to open GA.pdf at page 12.
What exactly do you get in HTML in both cases (working and not working)?
-- 
Yury G. Kudryashov
mailto: urkud@...

()  ascii ribbon campaign - against html e-mail
/\  http://www.asciiribbon.org   - against proprietary attachments

Re: [Docutils-users] rst2html link to given page in pdf document

[David Goodger <goodger@py...>]

On Fri, Jun 6, 2014 at 9:40 AM, Alan Bromborsky <abrombo@...> wrote:
> I wish to link to a given page in a pdf document from the html document
> generated by rst2html:
>
> The following works (in the rst file) - :download:`GA
> <../LaTeX_docs/GA.pdf>`
> to open GA.pdf at the beginning.
> The following does not work - :download:`GA <../LaTeX_docs/GA.pdf#page=12>`
> to open GA.pdf at page 12. However if I use - :download:`GA
> <../LaTeX_docs/GA.pdf>`
> in the rst file and then change - _downloads/GA.pdf
> in the html file to - _downloads/GA.pdf#page=12
> then the link does open on page 12. Do you know of anyway to code this
> directly in the rst file?

What does ":download:`URL`" do? I've never seen that before.

Putting "#page=12" into the RST source ought to work fine, and it
would if it were a simple link (without the :download: part, e.g. just
"`GA <../LaTeX_docs/GA.pdf#page=12>`_". This produces the following
HTML:

<a class="reference external" href="../LaTeX_docs/GA.pdf#page=12">GA</a>

Please show us the HTML output you get, when you include that parameter.

-- 
David Goodger <http://python.net/~goodger>;

[Docutils-users] rst2html link to given page in pdf document

[Alan Bromborsky <abrombo@ve...>]

I wish to link to a given page in a pdf document from the html document 
generated by rst2html:

The following works (in the rst file) - :download:`GA 
<../LaTeX_docs/GA.pdf>`
to open GA.pdf at the beginning.
The following does not work - :download:`GA <../LaTeX_docs/GA.pdf#page=12>`
to open GA.pdf at page 12. However if I use - :download:`GA 
<../LaTeX_docs/GA.pdf>`
in the rst file and then change - _downloads/GA.pdf
in the html file to - _downloads/GA.pdf#page=12
then the link does open on page 12. Do you know of anyway to code this 
directly in the rst file?

[Docutils-users] csv-table directive: excluding columns

[Chancy Kennedy <chancykennedy@gm...>]

Hello. I've made a modification to the csv-table directive to use zeroes in
the :widths: option to trigger the exclusion of those columns, e.g. ...

.. csv-table::
    :file: file.csv
    :widths: 30, 35, 0, 0, 0, 0, 35

... would exclude columns 3 - 6 from being rendered. I'm not very familiar
with docutils. Is this something a patch would be desired for and are there
other modifications I should make for consistency across the table family
of directives?

Also, I'm not subscribed to the mailing list.

Thanks,
Chancy