docutils-develop — For developer discussions of the implementation.
You can subscribe to this list here.
| 2002 |
Jan
|
Feb
|
Mar
|
Apr
(5) |
May
(27) |
Jun
(22) |
Jul
(72) |
Aug
(82) |
Sep
(86) |
Oct
(138) |
Nov
(100) |
Dec
(62) |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2003 |
Jan
(122) |
Feb
(147) |
Mar
(92) |
Apr
(82) |
May
(101) |
Jun
(153) |
Jul
(37) |
Aug
(34) |
Sep
(46) |
Oct
(46) |
Nov
(6) |
Dec
(38) |
| 2004 |
Jan
(64) |
Feb
(81) |
Mar
(36) |
Apr
(194) |
May
(329) |
Jun
(272) |
Jul
(68) |
Aug
(74) |
Sep
(150) |
Oct
(57) |
Nov
(62) |
Dec
(63) |
| 2005 |
Jan
(78) |
Feb
(30) |
Mar
(137) |
Apr
(78) |
May
(54) |
Jun
(122) |
Jul
(72) |
Aug
(110) |
Sep
(80) |
Oct
(75) |
Nov
(125) |
Dec
(79) |
| 2006 |
Jan
(100) |
Feb
(15) |
Mar
(41) |
Apr
(67) |
May
(30) |
Jun
(11) |
Jul
(14) |
Aug
(22) |
Sep
(20) |
Oct
(14) |
Nov
(11) |
Dec
(15) |
| 2007 |
Jan
(17) |
Feb
(16) |
Mar
(35) |
Apr
(21) |
May
(33) |
Jun
(50) |
Jul
(12) |
Aug
(7) |
Sep
(2) |
Oct
(6) |
Nov
(5) |
Dec
(2) |
| 2008 |
Jan
(14) |
Feb
(20) |
Mar
(35) |
Apr
(9) |
May
(57) |
Jun
(21) |
Jul
(42) |
Aug
(4) |
Sep
(13) |
Oct
(76) |
Nov
(40) |
Dec
(55) |
| 2009 |
Jan
(26) |
Feb
(15) |
Mar
(3) |
Apr
(67) |
May
(32) |
Jun
(39) |
Jul
(59) |
Aug
(31) |
Sep
(59) |
Oct
(64) |
Nov
(21) |
Dec
(10) |
| 2010 |
Jan
(21) |
Feb
(3) |
Mar
(116) |
Apr
(33) |
May
(6) |
Jun
(28) |
Jul
(21) |
Aug
(23) |
Sep
(146) |
Oct
(70) |
Nov
(31) |
Dec
(57) |
| 2011 |
Jan
(33) |
Feb
(22) |
Mar
(11) |
Apr
(21) |
May
(51) |
Jun
(47) |
Jul
(35) |
Aug
(26) |
Sep
(25) |
Oct
(34) |
Nov
(61) |
Dec
(51) |
| 2012 |
Jan
(75) |
Feb
(31) |
Mar
(26) |
Apr
(16) |
May
(24) |
Jun
(24) |
Jul
(31) |
Aug
(46) |
Sep
(36) |
Oct
(28) |
Nov
(37) |
Dec
(21) |
| 2013 |
Jan
(16) |
Feb
(56) |
Mar
(31) |
Apr
(44) |
May
(45) |
Jun
(29) |
Jul
(38) |
Aug
(18) |
Sep
(12) |
Oct
(16) |
Nov
(21) |
Dec
(11) |
| 2014 |
Jan
(13) |
Feb
(14) |
Mar
(28) |
Apr
(7) |
May
(72) |
Jun
(33) |
Jul
(13) |
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
|
From: engelbert gruber <grubert@us...> - 2014-07-08 11:11:51
|
|
From: Guenter Milde <milde@us...> - 2014-07-07 19:13:40
|
On 2014-06-12, engelbert gruber wrote:
> On 11 June 2014 23:38, Guenter Milde <milde@...> wrote:
>> On 2014-06-10, Guenter Milde wrote:
>> > On 2014-06-09, engelbert gruber wrote:
>> >> [-- Type: text/plain, Encoding: 7bit --]
>> >> happens in utils.relative_path, os.path.abspath prepends the driveletter
>> > Can you please try the following patch:
>> ...
>> > If there is no common prefix, return the absolute path to `target`.
>> > """
>> > + if os.path.isabs(source):
>> > + return source
>> > source_parts = os.path.abspath(source or type(target)('dummy_file')
>> > ).split(os.sep)
>> ...
>> Sorry, running the test revealed that this does not work (changes behaviour
>> at too many places where we do not want to change it).
> never mind, i consider this bug minor, no user reports.
As this regards "stylesheet-path", which is useful for stylesheets on the
file-system and rewrites the path by definition (as opposed to "stylesheet"
expecting an URL and not changing it), we should consider this change of
behaviour as uncritical and provide for it in the test (i.e. both, rewritten
paths with and without drive letter should pass the test).
Günter
|
|
From: engelbert gruber <grubert@us...> - 2014-07-07 02:54:25
|
|
From: engelbert gruber <grubert@us...> - 2014-07-07 02:53:53
|
|
From: Sebastien Luttringer <seblu@us...> - 2014-07-07 00:44:44
|
|
From: engelbert gruber <grubert@us...> - 2014-07-04 09:39:41
|
|
From: engelbert gruber <grubert@us...> - 2014-07-04 09:18:57
|
|
From: Peter Bittner <bittner@us...> - 2014-07-04 08:03:44
|
|
From: Peter Bittner <bittner@us...> - 2014-07-04 07:34:08
|
|
From: engelbert gruber <grubert@us...> - 2014-07-03 08:56:50
|
|
From: David Goodger <goodger@py...> - 2014-07-02 18:32:38
|
On Wed, Jul 2, 2014 at 10:50 AM, Guenter Milde <milde@...> wrote: > On 2014-07-01, Mark Fink wrote: >> Hi there, > >> I want to process files that contain rst content using docutils. To be >> precise each files contains more than one document (it also contains >> its translations). > >> Here a sample file containing a document and its translation: >> """ >> Foobar is not dead >> ################## > >>:slug: foobar-is-not-dead >>:lang: en > >> That's true, foobar is still alive! > >> Foobar n'est pas mort ! >> ####################### > >>:slug: foobar-is-not-dead >>:lang: fr > >> Oui oui, foobar est toujours vivant ! >> """ > > In this case, both "slug" (whatever this is) and "lang" are are just fields > in a field list, Docutils does not process them. > > You can, however set the language of a document part (e.g. a quote, but also > a section) via the "class" directive or argument: > > .. class:: language-en > > Foobar is not dead > ################## > > That's true, foobar is still alive! > > .. class:: language-fr > > Foobar n'est pas mort ! > ####################### > > Oui oui, foobar est toujours vivant ! > > This way, you can have one document with parts in different languages. In conjunction with Günter's "class" suggestion above, you may be able to use the --strip-elements-with-class command-line option or equivalent configuration: http://docutils.sourceforge.net/docs/user/config.html#strip-elements-with-classes However, please note that this is not fully tested and there are possibilities of side-effects. -- David Goodger > It may fail with auto-generated text and directive names. > >> I see two approaches >> 1) I split the files myself and then feed the single documents to docutils >> 2) I use the goodness of docutils to do so. > > This depends on whether the output should be in one document or in two > separate ones. Docutils only does a 1-in-1-out translation! > > If you want separate output documents, it is simpler to use a wrapper that > slits the input file(s) (or to keep them separate from the beginning) and > translate using the correct language settings. > > > Günter |
|
From: Guenter Milde <milde@us...> - 2014-07-02 15:50:39
|
On 2014-07-01, Mark Fink wrote: > Hi there, > I want to process files that contain rst content using docutils. To be > precise each files contains more than one document (it also contains > its translations). > Here a sample file containing a document and its translation: > """ > Foobar is not dead > ################## >:slug: foobar-is-not-dead >:lang: en > That's true, foobar is still alive! > Foobar n'est pas mort ! > ####################### >:slug: foobar-is-not-dead >:lang: fr > Oui oui, foobar est toujours vivant ! > """ In this case, both "slug" (whatever this is) and "lang" are are just fields in a field list, Docutils does not process them. You can, however set the language of a document part (e.g. a quote, but also a section) via the "class" directive or argument: .. class:: language-en Foobar is not dead ################## That's true, foobar is still alive! .. class:: language-fr Foobar n'est pas mort ! ####################### Oui oui, foobar est toujours vivant ! This way, you can have one document with parts in different languages. It may fail with auto-generated text and directive names. > I see two approaches > 1) I split the files myself and then feed the single documents to docutils > 2) I use the goodness of docutils to do so. This depends on whether the output should be in one document or in two separate ones. Docutils only does a 1-in-1-out translation! If you want separate output documents, it is simpler to use a wrapper that slits the input file(s) (or to keep them separate from the beginning) and translate using the correct language settings. Günter |
|
From: Mark Fink <mark@ma...> - 2014-07-01 18:58:30
|
Hi there, I want to process files that contain rst content using docutils. To be precise each files contains more than one document (it also contains its translations). Here a sample file containing a document and its translation: """ Foobar is not dead ################## :slug: foobar-is-not-dead :lang: en That's true, foobar is still alive! Foobar n'est pas mort ! ####################### :slug: foobar-is-not-dead :lang: fr Oui oui, foobar est toujours vivant ! """ I see two approaches 1) I split the files myself and then feed the single documents to docutils 2) I use the goodness of docutils to do so. In few month before I tried approach 1) but it was not a huge success. Now I am about to reimplement it using the second approach. I looked into the documentation but I could not figure out how to exactly do it (a custom reader is not going to work for this, right?). Maybe the Node Interface can be used to do this but I am not sure and it looks complicated / could not find the docu? Do you think this can be done using the Node-Interface, or should I stick to approach 1) Is there some sample or anything that I can use to learn about the Node-Interface? Regards, Mark |
|
From: Günter Milde <milde@us...> - 2014-06-24 15:02:14
|
|
From: Takeshi KOMIYA <tk0miya@us...> - 2014-06-23 05:40:17
|
|
From: Eric Holscher <eric@er...> - 2014-06-14 20:40:02
|
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 |
|
From: Jacob Floyd <cognifloyd@us...> - 2014-06-12 15:23:08
|
|
From: engelbert gruber <grubert@us...> - 2014-06-12 13:02:42
|
|
From: engelbert gruber <engelbert.gruber@gm...> - 2014-06-12 06:14:17
|
On 11 June 2014 23:38, Guenter Milde <milde@...> wrote:
> On 2014-06-10, Guenter Milde wrote:
> > On 2014-06-09, engelbert gruber wrote:
>
> >> [-- Type: text/plain, Encoding: 7bit --]
>
> >> happens in utils.relative_path, os.path.abspath prepends the driveletter
>
> > Can you please try the following patch:
>
> ...
> > If there is no common prefix, return the absolute path to `target`.
> > """
> > + if os.path.isabs(source):
> > + return source
> > source_parts = os.path.abspath(source or type(target)('dummy_file')
> > ).split(os.sep)
> ...
>
>
> Sorry, running the test revealed that this does not work (changes behaviour
> at too many places where we do not want to change it).
>
>
never mind, i consider this bug minor, no user reports.
sg e
|
|
From: Guenter Milde <milde@us...> - 2014-06-11 21:38:58
|
On 2014-06-10, Guenter Milde wrote:
> On 2014-06-09, engelbert gruber wrote:
>> [-- Type: text/plain, Encoding: 7bit --]
>> happens in utils.relative_path, os.path.abspath prepends the driveletter
> Can you please try the following patch:
...
> If there is no common prefix, return the absolute path to `target`.
> """
> + if os.path.isabs(source):
> + return source
> source_parts = os.path.abspath(source or type(target)('dummy_file')
> ).split(os.sep)
...
Sorry, running the test revealed that this does not work (changes behaviour
at too many places where we do not want to change it).
Günter
|
|
From: Guenter Milde <milde@us...> - 2014-06-10 16:04:33
|
On 2014-06-09, engelbert gruber wrote:
> ** [bugs:#256] drive letter in css path on windows**
> > testing on windows 7::
>
> > stylesheet = """\
> > - <link rel="stylesheet" href="/test.css" type="text/css" />"""
> > + <link rel="stylesheet" href="C:/test.css" type="text/css" />"""
> > ? ++
> happens in utils.relative_path, os.path.abspath prepends the driveletter
* We should not change utils.relative_path, as it is used on several
occasions and really is about file *paths* (as opposed to URLs).
We need to consider two options:
a) go with Python regarding the definitin of "absolute path" and
adapt the test.
+ simple, up-to-date code, expected behaviour for people with background
in Python.
- special-casing in the test.
b) freeze the current behaviour by testing for isabs() before the call
to relative_path in the `stylesheet_call` method in
html4css1/__init__.py and latex2e/__init__.py
+ test remains as-is
- hack in the code just to keep a test case
I prefer a)
Günter
|
|
From: Guenter Milde <milde@us...> - 2014-06-10 15:29:13
|
On 2014-06-09, engelbert gruber wrote:
> [-- Type: text/plain, Encoding: 7bit --]
> happens in utils.relative_path, os.path.abspath prepends the driveletter
Can you please try the following patch:
Index: __init__.py
===================================================================
--- __init__.py (Revision 7743)
+++ __init__.py (Arbeitskopie)
@@ -458,6 +458,8 @@
If there is no common prefix, return the absolute path to `target`.
"""
+ if os.path.isabs(source):
+ return source
source_parts = os.path.abspath(source or type(target)('dummy_file')
).split(os.sep)
Günter
|
|
From: engelbert gruber <engelbert.gruber@gm...> - 2014-06-09 13:54:10
|
happens a few lines later::
def relative_path(source, target):
"""
Build and return a path to `target`, relative to `source` (both files).
If there is no common prefix, return the absolute path to `target`.
"""
source_parts = os.path.abspath(source or type(target)('dummy_file')
).split(os.sep)
target_parts = os.path.abspath(target).split(os.sep)
# Check first 2 parts because '/dir'.split('/') == ['', 'dir']:
abspath prepends the drive letter.
and now for something completely different "lunchtime"
cheers
On 9 June 2014 14:06, engelbert gruber <engelbert.gruber@...> wrote:
>
> On 9 June 2014 12:04, Guenter Milde <milde@...> wrote:
> >
> > On 2014-06-08, Guenter Milde wrote:
> > > On 2014-06-08, engelbert gruber wrote:
> >
> > >> [-- Type: text/plain, Encoding: 7bit --]
> >
> > >> absolute path "/test.css" to me is maybe useful when viewed from a
> > >> webserver, but not when viewed on local filesystem.
> >
> >
> > > However, as Docutils should be able to produce HTML files for use from
> a
> > > web server, an absolute css-path setting like
> >
> > > def suite():
> > > settings = {'stylesheet_path': '/test.css',
> > > 'embed_stylesheet': 0,}
> >
> > > should be honoured and not be changed. The spec says: *relative*
> paths are
> > > expanded ...
> >
> > It seems Python has now a different idea about absoluteness of a path
> > after incorporation of PEP 428 (
> https://docs.python.org/3/whatsnew/3.4.html):
> >
> > First a couple of conventions:
> >
> > * All paths can have a drive and a root. For POSIX paths, the drive is
> > always empty.
> > * A relative path has neither drive nor root.
> > * A POSIX path is absolute if it has a root. A Windows path is absolute
> > if it has both a drive and a root. A Windows UNC path (e.g.
> > \\host\share\myfile.txt) always has a drive and a root (here,
> > \\host\share and \, respectively).
> > * A path which has either a drive or a root is said to be anchored. Its
> > anchor is the concatenation of the drive and root. Under POSIX,
> > "anchored" is the same as "absolute".
>
> isabs seams a little problematic to me::
>
> import os.path
> import sys
>
> for p in ("abc", "/abc", "c:abc", "c:/abc"):
> sys.stdout.write(p)
> sys.stdout.write(" ")
> sys.stdout.write(str(os.path.isabs(p)))
> sys.stdout.write("\n")
>
> returns false, true, false, false on macos for py2.5 2.6 2.7 3.2 and 3.4
> on win7 "c:/abc" is true for py 2.7 and 3.4.
>
> maybe os is os-specific and we need something in string-path, because
> one might prepare webpages on any os and an absolute path always starts
> with "/"
> or maybe "http://x/"; grapping the css from somewhere else ?
>
> should we go back to path.startswith("/") ?
>
> >
> > --
> http://legacy.python.org/dev/peps/pep-0428/#making-the-path-relative
> >
> >
> > Does the following patch help restore the behaviour we want?
>
> no , isabs recognzes "/test.css" as absolute.
>
> >
> > #> docutils-svn/docutils/docutils/utils > svn diff __init__.py
> >
> > Index: __init__.py
> > ===================================================================
> > --- __init__.py (Revision 7743)
> > +++ __init__.py (Arbeitskopie)
> > @@ -524,7 +524,8 @@
> >
> > Return the first expansion that matches an existing file.
> > """
> > - if os.path.isabs(path):
> > + # keep Posix-like absolute paths also on Windows under Py >= 3.4:
> > + if path.startswith('/') or os.path.isabs(path):
> > return path
> > for d in dirs:
> > if d == '.':
> >
> > Günter
> >
> >
> >
> ------------------------------------------------------------------------------
> > 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://www.hpccsystems.com
> > _______________________________________________
> > Docutils-develop mailing list
> > Docutils-develop@...
> > https://lists.sourceforge.net/lists/listinfo/docutils-develop
> >
> > Please use "Reply All" to reply to the list.
>
>
|
|
From: engelbert gruber <grubert@us...> - 2014-06-09 12:50:03
|
|
From: engelbert gruber <grubert@us...> - 2014-06-09 12:48:13
|