Re: like ".. important::"

On Tuesday 11 March 2003 03:25, David Abrahams wrote:
> David Goodger <goodger <at> python.org> writes:
> > David Abrahams wrote:
> > Although this would add flexibility to the document model, I'm reluctant
> > to add it.  It may be too flexible.
>
> I'm worried about your worry about flexibility (I'm a meta-worrywart).
> I'm using Docutils to write a book (so far), and I am certain that if
> it doesn't sprout more of that sort of parametrization ability I'm
> going to outgrow ReST and have to drop the comfortable input syntax
> for something awful like TeX or more-likely, DocBook.

it seems to me that the mere concept of docutils has an implicit 
contradiction:  on the one hand, it tries to extract structure from input 
without using markup, and on the other hand, ... well, markup is provided for 
more advanced structures.

IMHO careful judgement about how and what features to add to it will be 
tantamount to its success--i.e. if tons of non-generic features creep into it 
i'd rather use something that is made for the specific task i'm writing for.  
in other words, if it strays away too much from simple text without markup, i 
think people will not be interested in learning another ML.

that's just my opinion, but i think at some point it will be required to set 
and just accept limitations on what it can and cannot do.  for example, 
sometimes i find myself needing some special feature which is not provided, 
well, tough luck, my document still conveys all the information i want it to, 
without a little bit of extra pizazz, and i accept it, otherwise i'll use 
something else.  i don't think reST should be made to replace every other 
format that's out there.  if it answer 90% of the basic needs of everyone, 

Re: like ".. important::"

Martin Blais wrote:
 > it seems to me that the mere concept of docutils has an implicit
 > contradiction: on the one hand, it tries to extract structure from
 > input without using markup, and on the other hand, ... well, markup
 > is provided for more advanced structures.

True: implicit markup versus explicit markup.

 > IMHO careful judgement about how and what features to add to it will
 > be tantamount to its success--

Time will tell.  All I can go by is advice, experience, careful
thought, and gut-feeling instinct.

 > that's just my opinion, but i think at some point it will be
 > required to set and just accept limitations on what it can and
 > cannot do.

Agreed.  But limitations change over time.  Gotta change with the
times; grow or die.

 > personally i'm worried more about the adding of new features rather
 > than the reluctancy...

I hear you. I think that any language-like project -- be it a
programming language, markup language, whatever -- gets to the point
where it nears completion and it becomes harder to add new features.
The reluctance I feel is a useful check on creeping featurism.  That's
healthy, but on the other hand, the project may never really be
finished.  With directives the threshold for acceptance is relatively

Re: yaml ?

At 14:11 2003-03-30 +0200, William Dode wrote:
>hi,
>
>To complet a rst based application that i'm doing now, i need a
>configuration langage.
>I search one with the same philosophy as rst 
>
>Have you other ideas than yaml ?

Did you see this on python-announce?

>From: Chris McDonough <chrism <at> zope.com>
>Newsgroups: comp.lang.python.announce
>Subject: Now online: Paper and Slides for "Application Configuration Using
>         ZConfig"
>Date: 31 Mar 2003 11:46:32 -0500
>
>Hi folks,
>
>At PyCon DC last week, I presented a paper written by Fred Drake and
>myself about ZConfig, a library which allows Python programmers to
>retrieve, constrain and convert user-supplied configuration data.
>
>The paper and the slides which presented the paper are now online for
>your viewing pleasure:
>
>http://www.zope.org/Members/mcdonc/Presentations
>
>Enjoy!

Re: EuroPython presence?

Magnus Lycka <magnus <at> thinkware.se> writes:

> Will there be any presentation or tutorial on
> Docutils / rST on EuroPython in June?
>
> See http://www.europython.org/sessions/cft

Dunno, but there should be  I can give a lightning talk if noone
more qualified steps up...

Cheers,
M.
EP2003 helper

--

-- 
  This is an off-the-top-of-the-head-and-not-quite-sober suggestion,
  so is probably technically laughable.  I'll see how embarassed I
  feel tomorrow morning.            -- Patrick Gosling, ucam.comp.misc

-------------------------------------------------------
This SF.net email is sponsored by: ValueWeb: 
Dedicated Hosting for just $79/mo with 500 GB of bandwidth! 
No other company gives more support or power for your dedicated server
http://click.atdmt.com/AFF/go/sdnxxaff00300020aff/direct/01/

Re: yaml ?

Magnus Lycka <magnus <at> thinkware.se> writes:

> At 14:11 2003-03-30 +0200, William Dode wrote:
> >hi,
> >
> >To complet a rst based application that i'm doing now, i need a
> >configuration langage.
> >I search one with the same philosophy as rst 
> >
> >Have you other ideas than yaml ?
> 
> Did you see this on python-announce?
> 
> >From: Chris McDonough <chrism <at> zope.com>
> >Newsgroups: comp.lang.python.announce
> >Subject: Now online: Paper and Slides for "Application Configuration Using
> >         ZConfig"
> >Date: 31 Mar 2003 11:46:32 -0500
> >
> >Hi folks,
> >
> >At PyCon DC last week, I presented a paper written by Fred Drake and
> >myself about ZConfig, a library which allows Python programmers to
> >retrieve, constrain and convert user-supplied configuration data.

I looked at it but its not so near rst... It's between xml and yaml. Not
really human readable...

--

-- 
William Dode - http://flibuste.net

Re: Docutils raises UnicodeError

> Morten W. Petersen wrote:
>
> The exception is being raised while writing the output file, using a
> Latin-1 encoding. The output must contain a character which cannot be 
> encoded in Latin-1. The only text *generated* by Docutils which 
> wouldn't fit into Latin-1 would be labels from auto-symbol footnotes; 
> if you're not using these, the problem must be with the input text.
>
> I see IssueManager specifies Latin-1 output; could you try UTF-8?

Using UTF-8 works, although not flawlessly.  Specifying iso-8859-1
as the output input encoding works though.  :)

> What encoding does your input file use?

I'd assume it's iso-8859-1 since that's the encoding of the HTML page 
(the input is gathered via a textarea).

> Hope this helps.  Please let us know the result.

It did.  :)

Regards,

Morten W. Petersen

Technologies: Zope, Linux, Python, HTML, CSS, PHP
    Homepage: http://www.nidelven-it.no
Phone number: (+47) 45 44 00 69

Docutils test suite failure

Operating System : Windows 2000 Server, Service Pack 3
Python Version : 2.2.2
DocUtils Version: 0.2.8

Kind Regards,
Andy.

...........................................................................................................................................
test_writers\test_latex2e.py: totest['enumerated_lists'][0]; test_publish (DocutilsTestSupport.LatexPublishTestCase)
input:
1. Item 1.
2. Second to the previous item this one will explain

  a) nothing.
  b) or some other.

3. Third is 

  (I) having pre and postfixes
  (II) in roman numerals.

-: expected
+: output
  \documentclass[10pt,english]{article}
  \usepackage{babel}
  \usepackage{shortvrb}
  \usepackage[latin1]{inputenc}
  \usepackage{tabularx}
  \usepackage{longtable}

Install Docutils for ZOPE - 2 Python's on a PC

Bonjour,

Does someone have the clue to a docutils install on a machine with 2
Python's ?

I have on a Win2K PC  :  one Python 2.2 for general purpose (Docutils
installed OK), and another one inside ZOPE, older version ,compatible with
my hosting's version.

I need Docutils in Zope's Python for ZRest.

As the install procedure is a packaged windows exe, I fail to gear the
install towards the Zope's Python.

A patch ? a tip ? an info ?

Thanks on forward
___________________________________________________
P-Y Delens

Resp. "Technologies de l'Information et de la Communication"
pour la FAB - Fédération des Architectes de Belgique
pour la SAF - Société des Architectes Francophones
www.saf-arch.be
mail : webmaster <at> saf-arch.be

c/o LIENTERFACES -  PY Delens, sprl

Avenue Dolez, 243  -  1180   Bruxelles
phone : 32 2 375 55 62

Re: Install Docutils for ZOPE - 2 Python's on a PC

Hi,

As you know Zope keeps its own separate copy of python in its installed
directory.

You can use the distutils in this python to install the docutils stuff
to Zope's python.

This does mean using the command line though.

For example:

1. Unzip the docutils zip to somewhere (or if you used cvs note the
directory you checked out into)

2. Start menu -> run -> cmd.exe

3. cd \directory\with\docutils

4. c:\progra~1\website\bin\python.exe setup.py install

(Note replace website with the name of the website you installed to when
installing zope. If you installed zope somewhere completely different
use that directory with a \bin\python.exe at the end).

I believe Zope 3 will have a more standard install so there should be no
problems like this in the future.

mick

roles

Hello and thanks to David,

Question: how do I use custom roles.  I noticed canonically I need to 
subclass Inliner but in a product like ZReST this could be a lot of hassle 
that I'd like to avoid.  Instead, is there a way to define custom roles 
within a document.  For instance, in my novel I use:

``She wore ribbons in her hair and it lay with streaks of grey``:rewrite:

The idea here being that I have contributed a sentence but I am not happy 
with the phraseology at the moment and have left a not to myself to 
rewrite it.  It would then be nice to have a directive like:

.. :rewrite: font-color:: red

Or something like that, which as you might guess means: for any text with 
a role of "rewrite", render it in the colour red.  A substitution would 
not work for me because I sometimes have entire paragraphs I want to mark 
for rewrite and typing substitution references out of context would make 
the ReST doc hard to read.  So what's the deal on roles?  I know :sub: and 
:sup: are proposed, but could we allow document-defined roles?  This 
seemed to be implied in the current specification.  TIA!

Jeffrey.

-------------------------------------------------------
This SF.net email is sponsored by: ValueWeb: 
Dedicated Hosting for just $79/mo with 500 GB of bandwidth! 
No other company gives more support or power for your dedicated server
http://click.atdmt.com/AFF/go/sdnxxaff00300020aff/direct/01/