Re: [Docutils-develop] Pygments options?

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

On Sat, Jan 24, 2015 at 4:08 PM, Jacob Floyd <cognifloyd@...> wrote:
> Hello all,
>
> I want to be able to specify some options for pygments in my documentation,
> such as
>
> .. code:: php(startinline=true).
>
> There is an open patch to make this possible:
> https://sourceforge.net/p/docutils/patches/112/
>
> What is this patch missing to be accepted/merged?

-1 on the patch as it stands:

* Looking at the patch uploaded by Dmitry Shachnev on 2013-10-04, it's
now using an "option_list", which is a newly-introduced function that
introduces novel syntax (one "name = value" option per line,
comma-separated lists). Docutils already has syntax for these things:
field lists and bullet lists. Directive options should use existing
reST syntax if possible, and it's certainly possible here.

* Missing tests and documentation.

> Are there coding guidelines, or required tests that need to be finished
> first? Something else?

A documentation patch and some new unit tests would be welcome. As it
is, it's a raw patch with no explanation of what it does or how it
works. Code should be self-documenting, but the users of Docutils
shouldn't have to read the code to figure out how to use a directive.
And Docutils developers shouldn't have to do detective work to figure
out what a patch does either.

I added the above (with an example) to the patch. Feel free to link to
this thread.

David Goodger


> Thanks,
> Jacob Floyd
>
> ------------------------------------------------------------------------------
> New Year. New Location. New Benefits. New Data Center in Ashburn, VA.
> GigeNET is offering a free month of service with a new server in Ashburn.
> Choose from 2 high performing configs, both with 100TB of bandwidth.
> Higher redundancy.Lower latency.Increased capacity.Completely compliant.
> http://p.sf.net/sfu/gigenet
> _______________________________________________
> Docutils-develop mailing list
> Docutils-develop@...
> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>
> Please use "Reply All" to reply to the list.
>



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

[Docutils-develop] [docutils:patches] #112 Add support for Pygments options

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

[Docutils-develop] Pygments options?

[Jacob Floyd <cognifloyd@gm...>]

Hello all,

I want to be able to specify some options for pygments in my documentation,
such as

.. code:: php(startinline=true).

There is an open patch to make this possible:
https://sourceforge.net/p/docutils/patches/112/

What is this patch missing to be accepted/merged?
Are there coding guidelines, or required tests that need to be finished
first? Something else?

Thanks,
Jacob Floyd

Re: [Docutils-develop] Dealing with IDs in creation

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

On 2015-01-07, Gamesbrainiac wrote:

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

> Hi there!

> I'm new to using docutils, so I hope I'm excused for what may be a stupid
> question.

> *Context*

> I am trying to create a directive, that will add support for asciinema, a
> terminal video hosting site. In order to do this, I essentially need to
> wrap the ID of the video around a script tag. For example:

><script type="text/javascript" src="https://asciinema.org/a/14.js";
> id="asciicast-14" async></script>

> *Problem*

> As you can see, this requires me to add the id of "asciicast-14", and
> because of this the directive is giving me an error.

> Question

> How do I add an ID and have restructured text accept it?

I propose the "raw" directive. (See the "directives" documentation of
reStructuredText.)

Günter

Re: [Docutils-develop] Documentation Migration to Sphinx

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

as far as i remember david did not want to have the documentation in sphinx
which clearly means "only in sphinx"

a 5 minute import is absolutely great and it looks great too
the toc is far from perfect, because it is random (as far as i can see)
the real toc for users would be more like
"Docutils Project Documentation Overview"


so the toctree needs polishing, but that would be it, and i think it
is doable also in the long run
(maintenancewise)

and the doc would still work both ways.
so conf.py and toctree would go into sandbox/infrastructure and every
update of the docutils/docs
would also update readthedocs maybe ...

all the best
 e


On 11 January 2015 at 06:13, Eric Holscher <eric@...> wrote:
> Hi all,
>
> I went ahead and did a basic migration to Sphinx with the Read the Docs
> theme. I personally think it makes it way more navigable to have a global
> TOC, and styled content.
>
> http://docutils.readthedocs.org/en/sphinx-docs/index.html
>
> Curious what people think. This is a 5-minute import, where I literally
> added a conf.py and a toctree:
> https://github.com/ericholscher/docutils/compare/sphinx-docs
>
> Would love to hear folks thoughts. I'm happy to tackle more of this
> migration if there is a chance of it getting merged.
>
> Cheers,
> Eric
>
> On Sat, Jun 14, 2014 at 1:39 PM, Eric Holscher <eric@...>
> wrote:
>>
>> Any update on this? I have lots of thoughts on this subject as well, if
>> there are specific questions/objections I can help provide insight on.
>>
>> Cheers,
>> Eric
>>
>>
>> On Mon, Jun 2, 2014 at 12:46 PM, David Goodger <goodger@...> wrote:
>>>
>>> I noticed, just haven't had time to read & reply properly yet. I will.
>>>
>>> DG
>>>
>>>
>>> On Mon, Jun 2, 2014 at 2:30 PM, Steve Johnson <steve@...>
>>> wrote:
>>> > He didn't veto at all. He asked for responses to his concerns. I
>>> > responded
>>> > and he apparently didn't notice. It was a new thread as he requested.
>>> >
>>> > On Jun 2, 2014, at 12:21 PM, engelbert gruber
>>> > <engelbert.gruber@...>
>>> > wrote:
>>> >
>>> > david vetoed going to sphinx.
>>> >
>>> > but everyone is welcome to contribute improve/new
>>> > documentation/structure
>>> >
>>> > a reasonable structure cant be limitted to spinx, seams to me ( am i
>>> > naive)
>>> >
>>> > cheers e
>>> >
>>> >
>>> > On 30 May 2014 00:08, Eric Holscher <eric@...> wrote:
>>> >>
>>> >> Hi,
>>> >>
>>> >> There was an earlier post about migrating the repo to Git, and about
>>> >> migrating the docs to Sphinx. It seems the part about migrating the
>>> >> documentation to Sphinx was lost in the debate over VCS.
>>> >>
>>> >> Is there interest in overhauling the documentation and website to be
>>> >> generated from Sphinx? I am happy to help with this work, if it of
>>> >> interest
>>> >> to those involved. I don't think it would take more than a day,
>>> >> perhaps with
>>> >> an online hack day dedicated to the cause.
>>> >>
>>> >> Cheers,
>>> >> Eric
>>> >>
>>> >> --
>>> >> Eric Holscher
>>> >> Maker of the internet residing in Portland, Or
>>> >> http://ericholscher.com
>>> >>
>>> >>
>>> >>
>>> >> ------------------------------------------------------------------------------
>>> >> Learn Graph Databases - Download FREE O'Reilly Book
>>> >> "Graph Databases" is the definitive new guide to graph databases and
>>> >> their
>>> >> applications. Written by three acclaimed leaders in the field,
>>> >> this first edition is now available. Download your free book today!
>>> >> http://p.sf.net/sfu/NeoTech
>>> >> _______________________________________________
>>> >> Docutils-develop mailing list
>>> >> Docutils-develop@...
>>> >> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>>> >>
>>> >> Please use "Reply All" to reply to the list.
>>> >>
>>> >
>>> >
>>> > ------------------------------------------------------------------------------
>>> > Learn Graph Databases - Download FREE O'Reilly Book
>>> > "Graph Databases" is the definitive new guide to graph databases and
>>> > their
>>> > applications. Written by three acclaimed leaders in the field,
>>> > this first edition is now available. Download your free book today!
>>> > http://p.sf.net/sfu/NeoTech
>>> >
>>> > _______________________________________________
>>> > Docutils-develop mailing list
>>> > Docutils-develop@...
>>> > https://lists.sourceforge.net/lists/listinfo/docutils-develop
>>> >
>>> > Please use "Reply All" to reply to the list.
>>> >
>>> >
>>> >
>>> > ------------------------------------------------------------------------------
>>> > Learn Graph Databases - Download FREE O'Reilly Book
>>> > "Graph Databases" is the definitive new guide to graph databases and
>>> > their
>>> > applications. Written by three acclaimed leaders in the field,
>>> > this first edition is now available. Download your free book today!
>>> > http://p.sf.net/sfu/NeoTech
>>> > _______________________________________________
>>> > Docutils-develop mailing list
>>> > Docutils-develop@...
>>> > https://lists.sourceforge.net/lists/listinfo/docutils-develop
>>> >
>>> > Please use "Reply All" to reply to the list.
>>> >
>>>
>>>
>>> ------------------------------------------------------------------------------
>>> Learn Graph Databases - Download FREE O'Reilly Book
>>> "Graph Databases" is the definitive new guide to graph databases and
>>> their
>>> applications. Written by three acclaimed leaders in the field,
>>> this first edition is now available. Download your free book today!
>>> http://p.sf.net/sfu/NeoTech
>>> _______________________________________________
>>> Docutils-develop mailing list
>>> Docutils-develop@...
>>> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>>>
>>> Please use "Reply All" to reply to the list.
>>
>>
>>
>>
>> --
>> Eric Holscher
>> Maker of the internet residing in Portland, Or
>> http://ericholscher.com
>
>
>
>
> --
> Eric Holscher
> Maker of the internet residing in Portland, Or
> http://ericholscher.com

Re: [Docutils-develop] Documentation Migration to Sphinx

[Eric Holscher <eric@er...>]

Hi all,

I went ahead and did a basic migration to Sphinx with the Read the Docs
theme. I personally think it makes it way more navigable to have a global
TOC, and styled content.

http://docutils.readthedocs.org/en/sphinx-docs/index.html

Curious what people think. This is a 5-minute import, where I literally
added a conf.py and a toctree:
https://github.com/ericholscher/docutils/compare/sphinx-docs

Would love to hear folks thoughts. I'm happy to tackle more of this
migration if there is a chance of it getting merged.

Cheers,
Eric

On Sat, Jun 14, 2014 at 1:39 PM, Eric Holscher <eric@...>
wrote:

> Any update on this? I have lots of thoughts on this subject as well, if
> there are specific questions/objections I can help provide insight on.
>
> Cheers,
> Eric
>
>
> On Mon, Jun 2, 2014 at 12:46 PM, David Goodger <goodger@...> wrote:
>
>> I noticed, just haven't had time to read & reply properly yet. I will.
>>
>> DG
>>
>>
>> On Mon, Jun 2, 2014 at 2:30 PM, Steve Johnson <steve@...>
>> wrote:
>> > He didn't veto at all. He asked for responses to his concerns. I
>> responded
>> > and he apparently didn't notice. It was a new thread as he requested.
>> >
>> > On Jun 2, 2014, at 12:21 PM, engelbert gruber <
>> engelbert.gruber@...>
>> > wrote:
>> >
>> > david vetoed going to sphinx.
>> >
>> > but everyone is welcome to contribute improve/new
>> documentation/structure
>> >
>> > a reasonable structure cant be limitted to spinx, seams to me ( am i
>> naive)
>> >
>> > cheers e
>> >
>> >
>> > On 30 May 2014 00:08, Eric Holscher <eric@...> wrote:
>> >>
>> >> Hi,
>> >>
>> >> There was an earlier post about migrating the repo to Git, and about
>> >> migrating the docs to Sphinx. It seems the part about migrating the
>> >> documentation to Sphinx was lost in the debate over VCS.
>> >>
>> >> Is there interest in overhauling the documentation and website to be
>> >> generated from Sphinx? I am happy to help with this work, if it of
>> interest
>> >> to those involved. I don't think it would take more than a day,
>> perhaps with
>> >> an online hack day dedicated to the cause.
>> >>
>> >> Cheers,
>> >> Eric
>> >>
>> >> --
>> >> Eric Holscher
>> >> Maker of the internet residing in Portland, Or
>> >> http://ericholscher.com
>> >>
>> >>
>> >>
>> ------------------------------------------------------------------------------
>> >> Learn Graph Databases - Download FREE O'Reilly Book
>> >> "Graph Databases" is the definitive new guide to graph databases and
>> their
>> >> applications. Written by three acclaimed leaders in the field,
>> >> this first edition is now available. Download your free book today!
>> >> http://p.sf.net/sfu/NeoTech
>> >> _______________________________________________
>> >> Docutils-develop mailing list
>> >> Docutils-develop@...
>> >> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>> >>
>> >> Please use "Reply All" to reply to the list.
>> >>
>> >
>> >
>> ------------------------------------------------------------------------------
>> > Learn Graph Databases - Download FREE O'Reilly Book
>> > "Graph Databases" is the definitive new guide to graph databases and
>> their
>> > applications. Written by three acclaimed leaders in the field,
>> > this first edition is now available. Download your free book today!
>> > http://p.sf.net/sfu/NeoTech
>> >
>> > _______________________________________________
>> > Docutils-develop mailing list
>> > Docutils-develop@...
>> > https://lists.sourceforge.net/lists/listinfo/docutils-develop
>> >
>> > Please use "Reply All" to reply to the list.
>> >
>> >
>> >
>> ------------------------------------------------------------------------------
>> > Learn Graph Databases - Download FREE O'Reilly Book
>> > "Graph Databases" is the definitive new guide to graph databases and
>> their
>> > applications. Written by three acclaimed leaders in the field,
>> > this first edition is now available. Download your free book today!
>> > http://p.sf.net/sfu/NeoTech
>> > _______________________________________________
>> > Docutils-develop mailing list
>> > Docutils-develop@...
>> > https://lists.sourceforge.net/lists/listinfo/docutils-develop
>> >
>> > Please use "Reply All" to reply to the list.
>> >
>>
>>
>> ------------------------------------------------------------------------------
>> Learn Graph Databases - Download FREE O'Reilly Book
>> "Graph Databases" is the definitive new guide to graph databases and their
>> applications. Written by three acclaimed leaders in the field,
>> this first edition is now available. Download your free book today!
>> http://p.sf.net/sfu/NeoTech
>> _______________________________________________
>> Docutils-develop mailing list
>> Docutils-develop@...
>> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>>
>> Please use "Reply All" to reply to the list.
>>
>
>
>
> --
> Eric Holscher
> Maker of the internet residing in Portland, Or
> http://ericholscher.com
>



-- 
Eric Holscher
Maker of the internet residing in Portland, Or
http://ericholscher.com

[Docutils-develop] Dealing with IDs in creation

[Gamesbrainiac <gamesbrainiac@gm...>]

Hi there!

I'm new to using docutils, so I hope I'm excused for what may be a stupid
question.

*Context*

I am trying to create a directive, that will add support for asciinema, a
terminal video hosting site. In order to do this, I essentially need to
wrap the ID of the video around a script tag. For example:

<script type="text/javascript" src="https://asciinema.org/a/14.js";
id="asciicast-14" async></script>

*Problem*

As you can see, this requires me to add the id of "asciicast-14", and
because of this the directive is giving me an error.

Question

How do I add an ID and have restructured text accept it?


-- 
Kind Regards,

Quazi Nafiul Islam

Re: [Docutils-develop] [docutils:patches] #120 Extend and unify the table directives' :widths: option

[Brecht Machiels <brecht__gmane@mo...>]

On 2015-01-04 22:49:56 +0000, engelbert gruber said:

> And I have a question does the width need some unit ?
> Is it always "%" ?
> If so should we make it explicit "widths: 15%, 25%" ?
> Or at least optional ?
I have not changed anything to the way the column widths are specified. 
This was already possible for the csv-table and list-table directives. 
I only made this possible also for the table directive.

The column widths are not specified in percent. They are relative 
column widths (relative to each other, not the text width). If you 
specify

.. table::
	:widths: 1, 3, 2

column 2 will be three times as wide as column 1, and column 3 will be 
twice as wide as column 1.

Best regards,
Brecht

[Docutils-develop] [docutils:patches] #120 Extend and unify the table directives' :widths: option

[engelbert gruber <grubert@us...>]

[Docutils-develop] new item for Docutils Link List

[Eric Knibbe <eric3knibbe@gm...>]

I wrote a BBEdit/TextWrangler language module for editing reST documents. Would you be interested in including it on <http://docutils.sourceforge.net/docs/user/links.html>? It's hosted on Bitbucket; find it at <http://ericfromcanada.bitbucket.org>;.
---
Eric3

I � Unicode
 

[Docutils-develop] [docutils:bugs] #271 Make setup.py build universal wheels.

[ionel <ionel_mc@us...>]

Re: [Docutils-develop] [Docutils-users] Git or Mercurial?

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

Für the umpteens time , a happy New year to you all,
and may the truth be Seen "a proper installed dvcs writes Software  on it's
own. Torwalds on permanent vacation since 2005"

Am 01.01.2015 18:34 schrieb "Brecht Machiels" <brecht__gmane@...>:
>
> Hi,
>
> For what it's worth, I vote for git. I agree that Git is harder too
> use, but it is very widely used. More people are familiar with Git (and
> GitHub!). Mercurial seems to be loosing more and more ground. Also, I
> don't think the fact that Mercurial is written in Python should
> influence this decision.
>
> There's already an up-to-date git mirror of the docutils SVN repository
> here: http://repo.or.cz/w/docutils.git
>
> Best regards,
> Brecht
>
> On 2014-12-19 01:08:43 +0000, Marc Abramowitz said:
>
> > OK. I did a couple of experiments where I imported the docutils svn
> > repo to GitHub and Bitbucket (Mercurial) -- both were pretty easy,
> > though I didn't inspect the results carefully to see if it got all the
> > history and branches and tags and author info. The GitHub was easy
> > because they have a GUI to do the import, but I won't say any more
> > about it because David said he prefers Mercurial. For the Bitbucket
> > (Mercurial) import, I used hgsubversion and referred to these pages:
> >
> > -
> >
https://confluence.atlassian.com/display/BITBUCKET/Convert+from+Subversion+to+Mercurial
> >
> > - http://blogs.atlassian.com/2011/03/goodbye_subversion_hello_mercurial/
> >
> > Here's the resulting Bitbucket repo:
https://bitbucket.org/msabramo/docutils
> >
> > Hope that's helpful.
> >
> > Marc
> >
> > On Wed, Dec 17, 2014 at 7:46 AM, David Goodger <goodger@...>
wrote:
> > On Wed, Dec 17, 2014 at 12:52 AM, Marc Abramowitz <msabramo@...>
wrote:
> > > Has anyone suggested moving from Subversion to Git or Mercurial?
> > >
> > > Most Python projects use one of those two and usually either GitHub or
> > > Bitbucket, because it makes collaboration a lot easier.
> > >
> > > Has it come up before?
> >
> > Many times; see the mailing list archives for this list and
> > Docutils-develop. I'm not averse to switching, it just has to be done
> > properly and completely with minimal perturbation. Mercurial is my
> > preference, because it's written and extensible in Python, and because
> > I find Git slightly harder to use (although much better than it used
> > to be).
> >
> > Docutils pre-dates widespread DVCS use. Once you're set up and used to
> > SVN, the cost of switching outweighs the benefits, at least in the
> > short term. And I don't drink the "switch to Github and prepare for a
> > deluge of pull requests" koolaid.
> >
> > --
> > David Goodger <http://python.net/~goodger>;
> >
------------------------------------------------------------------------------
> > Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
> > from Actuate! Instantly Supercharge Your Business Reports and Dashboards
> > with Interactivity, Sharing, Native Excel Exports, App Integration &
more
> > Get technology previously reserved for billion-dollar corporations, FREE
> >
http://pubads.g.doubleclick.net/gampad/clk?id=164703151&iu=/4140/ostg.clktrk
>
>
>
>
>
------------------------------------------------------------------------------
> Dive into the World of Parallel Programming! The Go Parallel Website,
> sponsored by Intel and developed in partnership with Slashdot Media, is
your
> hub for all things parallel software development, from weekly thought
> leadership blogs to news, videos, case studies, tutorials and more. Take a
> look and join the conversation now. http://goparallel.sourceforge.net
> _______________________________________________
> Docutils-develop mailing list
> Docutils-develop@...
> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>
> Please use "Reply All" to reply to the list.

Re: [Docutils-develop] [Docutils-users] Git or Mercurial?

[Brecht Machiels <brecht__gmane@mo...>]

Hi,

For what it's worth, I vote for git. I agree that Git is harder too 
use, but it is very widely used. More people are familiar with Git (and 
GitHub!). Mercurial seems to be loosing more and more ground. Also, I 
don't think the fact that Mercurial is written in Python should 
influence this decision.

There's already an up-to-date git mirror of the docutils SVN repository 
here: http://repo.or.cz/w/docutils.git

Best regards,
Brecht

On 2014-12-19 01:08:43 +0000, Marc Abramowitz said:

> OK. I did a couple of experiments where I imported the docutils svn 
> repo to GitHub and Bitbucket (Mercurial) -- both were pretty easy, 
> though I didn't inspect the results carefully to see if it got all the 
> history and branches and tags and author info. The GitHub was easy 
> because they have a GUI to do the import, but I won't say any more 
> about it because David said he prefers Mercurial. For the Bitbucket 
> (Mercurial) import, I used hgsubversion and referred to these pages:
> 
> - 
> https://confluence.atlassian.com/display/BITBUCKET/Convert+from+Subversion+to+Mercurial 
> 
> - http://blogs.atlassian.com/2011/03/goodbye_subversion_hello_mercurial/
> 
> Here's the resulting Bitbucket repo: https://bitbucket.org/msabramo/docutils
> 
> Hope that's helpful.
> 
> Marc
> 
> On Wed, Dec 17, 2014 at 7:46 AM, David Goodger <goodger@...> wrote:
> On Wed, Dec 17, 2014 at 12:52 AM, Marc Abramowitz <msabramo@...> wrote:
> > Has anyone suggested moving from Subversion to Git or Mercurial?
> >
> > Most Python projects use one of those two and usually either GitHub or
> > Bitbucket, because it makes collaboration a lot easier.
> >
> > Has it come up before?
> 
> Many times; see the mailing list archives for this list and
> Docutils-develop. I'm not averse to switching, it just has to be done
> properly and completely with minimal perturbation. Mercurial is my
> preference, because it's written and extensible in Python, and because
> I find Git slightly harder to use (although much better than it used
> to be).
> 
> Docutils pre-dates widespread DVCS use. Once you're set up and used to
> SVN, the cost of switching outweighs the benefits, at least in the
> short term. And I don't drink the "switch to Github and prepare for a
> deluge of pull requests" koolaid.
> 
> --
> David Goodger <http://python.net/~goodger>;
> ------------------------------------------------------------------------------
> Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
> from Actuate! Instantly Supercharge Your Business Reports and Dashboards
> with Interactivity, Sharing, Native Excel Exports, App Integration & more
> Get technology previously reserved for billion-dollar corporations, FREE
> http://pubads.g.doubleclick.net/gampad/clk?id=164703151&iu=/4140/ostg.clktrk

[Docutils-develop] [docutils:patches] #121 Add a :width: option for the table directives

[Brecht Machiels <darklite09@us...>]

[Docutils-develop] [docutils:patches] #120 Extend and unify the table directives' :widths: option

[Brecht Machiels <darklite09@us...>]

Re: [Docutils-develop] Fwd: tox for testing multiple Python versions

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

On 2014-12-17, Marc Abramowitz wrote:

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

> Any interest in using tox to test docutils on multiple Python versions?

I use a private shell script to test for the versions I have installed.
This also converts to py3k with 2to3.
Are there obvious advantages in using tox?

Günter

Re: [Docutils-develop] [Docutils-users] Git or Mercurial?

[Marc Abramowitz <msabramo@gm...>]

OK. I did a couple of experiments where I imported the docutils svn repo to
GitHub and Bitbucket (Mercurial) -- both were pretty easy, though I didn't
inspect the results carefully to see if it got all the history and branches
and tags and author info. The GitHub was easy because they have a GUI to do
the import, but I won't say any more about it because David said he prefers
Mercurial. For the Bitbucket (Mercurial) import, I used hgsubversion and
referred to these pages:

-
https://confluence.atlassian.com/display/BITBUCKET/Convert+from+Subversion+to+Mercurial
- http://blogs.atlassian.com/2011/03/goodbye_subversion_hello_mercurial/

Here's the resulting Bitbucket repo: https://bitbucket.org/msabramo/docutils

Hope that's helpful.

Marc

On Wed, Dec 17, 2014 at 7:46 AM, David Goodger <goodger@...> wrote:
>
> On Wed, Dec 17, 2014 at 12:52 AM, Marc Abramowitz <msabramo@...>
> wrote:
> > Has anyone suggested moving from Subversion to Git or Mercurial?
> >
> > Most Python projects use one of those two and usually either GitHub or
> > Bitbucket, because it makes collaboration a lot easier.
> >
> > Has it come up before?
>
> Many times; see the mailing list archives for this list and
> Docutils-develop. I'm not averse to switching, it just has to be done
> properly and completely with minimal perturbation. Mercurial is my
> preference, because it's written and extensible in Python, and because
> I find Git slightly harder to use (although much better than it used
> to be).
>
> Docutils pre-dates widespread DVCS use. Once you're set up and used to
> SVN, the cost of switching outweighs the benefits, at least in the
> short term. And I don't drink the "switch to Github and prepare for a
> deluge of pull requests" koolaid.
>
> --
> David Goodger <http://python.net/~goodger>;
>

[Docutils-develop] [docutils:bugs] #267 Name conflict for CSS class container

[Günter Milde <milde@us...>]

[Docutils-develop] [docutils:bugs] #268 wrong synonym for sectnum directive in docs

[Günter Milde <milde@us...>]

[Docutils-develop] [docutils:bugs] #269 Broken link in docs/wiki

[Günter Milde <milde@us...>]

[Docutils-develop] Fwd: [Docutils-users] Git or Mercurial?

[Marc Abramowitz <msabramo@gm...>]

On Wed, Dec 17, 2014 at 12:52 AM, Marc Abramowitz <msabramo@...>
wrote:
> Has anyone suggested moving from Subversion to Git or Mercurial?
>
> Most Python projects use one of those two and usually either GitHub or
> Bitbucket, because it makes collaboration a lot easier.
>
> Has it come up before?

Many times; see the mailing list archives for this list and
Docutils-develop. I'm not averse to switching, it just has to be done
properly and completely with minimal perturbation. Mercurial is my
preference, because it's written and extensible in Python, and because
I find Git slightly harder to use (although much better than it used
to be).

Docutils pre-dates widespread DVCS use. Once you're set up and used to
SVN, the cost of switching outweighs the benefits, at least in the
short term. And I don't drink the "switch to Github and prepare for a
deluge of pull requests" koolaid.

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

[Docutils-develop] Fwd: tox for testing multiple Python versions

[Marc Abramowitz <msabramo@gm...>]

Any interest in using tox to test docutils on multiple Python versions?

https://github.com/msabramo/docutils/pull/2

Looks like this:

[marca@... docutils]$ tox
...
  py26: commands succeeded
  py27: commands succeeded
  py33: commands succeeded
  py34: commands succeeded
  congratulations :)


Marc

Re: [Docutils-develop] semantic serialization to json

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

On Wed, Dec 17, 2014 at 9:58 AM, dvilchez <dvilchez@...> wrote:
> Hello,
>
> I have been working around sphinx/docutils for a few days. I want to
> write reStructuredText files to json not write the presentation
> treenode but a semantic version based on domain directives.
>
> I don't want
>
>  document, section, title, reference, literal, #text
>
> I want
>
> name, type, description, domain...
>
> for serialize:
>
> [{'name':'__main__', 'type':'module', 'description' : '--- Top-level
> script environment', 'domain' : 'py' }]
>
> I tried with a builder but is too late. Maybe you can give me some
> piece of advice.
>
> Thanks a lot.

I have no idea what you mean. Please show us an example: a short input
text and your desired output.

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

[Docutils-develop] semantic serialization to json

[dvilchez <dvilchez@xu...>]

Hello,

I have been working around sphinx/docutils for a few days. I want to 
write reStructuredText files to json not write the presentation 
treenode but a semantic version based on domain directives.

I don't want

 document, section, title, reference, literal, #text

I want

name, type, description, domain...

for serialize:

[{'name':'__main__', 'type':'module', 'description' : '--- Top-level 
script environment', 'domain' : 'py' }]

I tried with a builder but is too late. Maybe you can give me some 
piece of advice.

Thanks a lot.

[Docutils-develop] [docutils:bugs] #267 Name conflict for CSS class container

[viz <wizardeye@us...>]