Re: odf_odt writer added feature

Nobody has replied to this yet, so I thought I would
relate my experience.

I can use %p% when I add to the footer just fine.
It prints the page numbers on every page that shows the
footer.

For the header, I get the fixed text, but %p% doesn't 
print as a literal or as the page number.

I'll grab an update in a few days to see if it's changed or
if I just didn't get the latest.

The string at the top of __init__.py that I have is:
# $Id: __init__.py 6221 2010-01-19 22:49:09Z dkuhlman $

Cheers,
Kyle

------------------------------------------------------------------------------
The Planet: dedicated and managed hosting, cloud storage, colocation
Stay online with enterprise data centers and the best network in the business
Choose flexible plans and management services without long-term contracts
Personal 24x7 support from experience hosting pros just a phone call away.
http://p.sf.net/sfu/theplanet-com

Re: Auto-enumerated nested lists

On 2010-01-30, David Goodger wrote:
> On Sat, Jan 30, 2010 at 16:36, Guenter Milde <milde <at> users.berlios.de> wrote:
>> On 2010-01-30, David Goodger wrote:
>>> On Sat, Jan 30, 2010 at 05:00, Martin <martin.clausen <at> gmail.com> wrote:

>>>> Does docutils support auto-enumerated nested
>>>> lists with outline numbering like so:
>>> ...
>>>> #.#. nested item

>>> No.

>> However, you can create a sublist like so::

>>  #. first point
>>     #. first subpoint

> A blank line is required between those lines though, right?

Yes indeed.

...

>> The HTML-strict writer (in the sandbox) can do this out of the box if
>> you give the "nested" class argument::

> How does HTML-strict do this formatting? Is it a stylesheet issue?

It sets up a CSS counter for enumerations. 
(It took me quite a lot of research and experimenting to get the layout

Re: Auto-enumerated nested lists

On 2010-01-31, Martin Clausen wrote:
> I am actually looking for HTML, pdf and odt output.

> I did not realise that the numbering relied on format specific features.

The numbering of auto-numbered nested lists is done at the writer level.

The "standard" format

  1. item

     1. sub item

  2. item

is supported by all writers. 

Different number formats (alpha, roman, ...) are recognized for manual
numbered enumerations and supported by most writers (except html4css1).

Other formatting like "nested counters" is an "add-on".

Günter

------------------------------------------------------------------------------
The Planet: dedicated and managed hosting, cloud storage, colocation
Stay online with enterprise data centers and the best network in the business
Choose flexible plans and management services without long-term contracts
Personal 24x7 support from experience hosting pros just a phone call away.
http://p.sf.net/sfu/theplanet-com

Re: Auto-enumerated nested lists

>>>> On Sat, Jan 30, 2010 at 05:00, Martin <martin.clausen <at> gmail.com> wrote:
>>>>> Does docutils support auto-enumerated nested
>>>>> lists with outline numbering like so:
>>>> ...
>>>>> #.#. nested item

> On 2010-01-30, David Goodger wrote:
>> How does HTML-strict do this formatting? Is it a stylesheet issue?

2010/2/1 Guenter Milde <milde <at> users.berlios.de>:
> It sets up a CSS counter for enumerations.

Correct me if I'm wrong, but there doesn't seem to be anything
specific to the HTML-strict writer here. It's all done in CSS, so the
same CSS can be applied to HTML generated by the HTML4CSS1 writer.

> (It took me quite a lot of research and experimenting to get the layout
> right. This is documented in sandbox/html4strict/README.html)

Very well done!

--

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

------------------------------------------------------------------------------
The Planet: dedicated and managed hosting, cloud storage, colocation
Stay online with enterprise data centers and the best network in the business
Choose flexible plans and management services without long-term contracts
Personal 24x7 support from experience hosting pros just a phone call away.
http://p.sf.net/sfu/theplanet-com

Re: Auto-enumerated nested lists

2010/2/1 Guenter Milde <milde <at> users.berlios.de>:
> On 2010-01-31, Martin Clausen wrote:
>> I am actually looking for HTML, pdf and odt output.
>
>> I did not realise that the numbering relied on format specific features.
>
> The numbering of auto-numbered nested lists is done at the writer level.

Misleading. The writers facilitate the numbering, but many don't do
any concrete numbering. In the case of HTML, the browser handles the
actual numbering (the concrete rendering of numbers & letters).

> The "standard" format
>
>  1. item
>
>     1. sub item
>
>  2. item
>
> is supported by all writers.
>
> Different number formats (alpha, roman, ...) are recognized for manual
> numbered enumerations and supported by most writers (except html4css1).

Not true. The html4css1 writer supports all numbering formats (arabic,
upper/lower alpha & roman). Try it.

--

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

Re: Positional Parameters

David Goodger wrote:
> On Fri, Jan 29, 2010 at 20:16, Alexis Layton <alex <at> permabit.com> wrote:
>   
>> I'm writing some documentation of a typical command-line application,
>> and I was wondering how to get the
>> option list to handle positional parameters.
>>     
> ...
>   
>> is there any way to extend the option list to do this?
>>     
>
> No, option lists are just for options. Positional parameters must be
> documented separately, using e.g. a definition list or a field list
> etc.
>
>   
I guess this is an enhancement request then, since I strongly believe 
these should be documented together rather than separately.  I realize 
you would need some sort of explicit marker which is maybe anathema to 
the ReST philosophy....

--

-- 
Alexis Layton
alex <at> permabit.com

------------------------------------------------------------------------------
The Planet: dedicated and managed hosting, cloud storage, colocation
Stay online with enterprise data centers and the best network in the business
Choose flexible plans and management services without long-term contracts

Re: Positional Parameters

On Mon, Feb 1, 2010 at 12:14, Alexis Layton <alex <at> permabit.com> wrote:
> David Goodger wrote:
>> On Fri, Jan 29, 2010 at 20:16, Alexis Layton <alex <at> permabit.com> wrote:
>>
>>> I'm writing some documentation of a typical command-line application,
>>> and I was wondering how to get the
>>> option list to handle positional parameters.
>>>
>> ...
>>
>>> is there any way to extend the option list to do this?
>>>
>>
>> No, option lists are just for options. Positional parameters must be
>> documented separately, using e.g. a definition list or a field list
>> etc.
>>
>>
> I guess this is an enhancement request then, since I strongly believe
> these should be documented together rather than separately.  I realize
> you would need some sort of explicit marker which is maybe anathema to
> the ReST philosophy....

If you're serious about this, you'll have to champion it, get people
interested enough to make it happen. Gather and present some evidence.
Find examples in the wild (I know of none). File a feature request on
SourceForge (http://sourceforge.net/tracker/?group_id=38414&atid=422033).
What should the input and output be? Are you a programmer? If so, work
up a patch. If not, you'll need to get a developer interested enough
to implement the change.

Re: odf_odt writer added feature

> From: Kyle Roberson

> Sent: Sun, January 31, 2010 11:00:36 PM

> 
> I can use %p% when I add to the footer just fine.
> It prints the page numbers on every page that shows the
> footer.
> 
> For the header, I get the fixed text, but %p% doesn't
> print as a literal or as the page number.

Kyle -

Hmmm.  When I use the following command line::

    $ rst2odt.py --custom-odt-header="Page %p%" test1.txt test1.odt

and then open test1.odt in oowriter, I see the following at the top of
the page::

    Page 1

> 
> The string at the top of __init__.py that I have is:
> # $Id: __init__.py 6221 2010-01-19 22:49:09Z dkuhlman $

And, in my copy I see this:

    # $Id: __init__.py 6221 2010-01-19 22:49:09Z dkuhlman $ 

portable docUtils installation

------------------------------------------------------------------------------
The Planet: dedicated and managed hosting, cloud storage, colocation
Stay online with enterprise data centers and the best network in the business
Choose flexible plans and management services without long-term contracts
Personal 24x7 support from experience hosting pros just a phone call away.
http://p.sf.net/sfu/theplanet-com

------------------------------------------------------------------------------
The Planet: dedicated and managed hosting, cloud storage, colocation
Stay online with enterprise data centers and the best network in the business
Choose flexible plans and management services without long-term contracts
Personal 24x7 support from experience hosting pros just a phone call away.
http://p.sf.net/sfu/theplanet-com

Re: portable docUtils installation

On 2010-02-02, ALEPOGLIAN, Harutiun wrote:

> But, is there any portable version available? I mean any version that
> doesn't need an installation. I am working on machines without having
> admin rights and I can't install docUtils on this machines.=20

As it's a Python module, it should run on any system where Python is
installed.

You just need to make sure that the package directory
(docutils/docutils/) is in the PYTHONPATH.

Günter

> The information in this e-mail is confidential. 
...

Than don't post it to a public list!

------------------------------------------------------------------------------
The Planet: dedicated and managed hosting, cloud storage, colocation
Stay online with enterprise data centers and the best network in the business
Choose flexible plans and management services without long-term contracts
Personal 24x7 support from experience hosting pros just a phone call away.
http://p.sf.net/sfu/theplanet-com
_______________________________________________
Docutils-users mailing list
Docutils-users <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/docutils-users

Please use "Reply All" to reply to the list.