Re: screenplay markup (was Re: Nested, titled sections)

Guenter Milde <[email protected]>
Newsgroups gmane.text.docutils.user
Message-ID <[email protected]>
On 2015-04-19, David Goodger wrote:
> On Apr 19, 2015 3:22 PM, "Guenter Milde" <[email protected]> wrote:
>> On 2015-04-14, David Goodger wrote:
>> > On Tue, Apr 14, 2015 at 3:13 PM, Jeffrey C. Jacobs
>> ><[email protected]> wrote:
>> >> David Goodger <goodger <at> python.org> writes:

...

>> The idea was to use a block element instead of a role. This could be a
>> generic admonition, an (ab)used pre-defined admonition (note, hint, ...)
> or
>> a custom directive (whether the parentheses are added by the directive or
>> required in the source is up to the implementation)::

>>   Character
>>     .. parenthetical:: action

>>     Dialog

> That does work. But I'd recommend a less verbose option.

>> Or you could simply put the `action` in a separate paragraph:

>>     Character
>>           `action`

>>           Dialog

> Yes, but I believe there should not be any blank lines between sections of
> dialog and parentheticals (in the output). Of course, a transform could do
> that too.

A custom paragraph style for "parenthetical" paragraphs should suffice.
(Most printed documents use indendation instead of vertical space as
paragraph separator anyway.)


>> Another, [...] option would be to (ab)use the
>> "classifier" of a definition list term ...
...

> Unfortunately that won't work, because such parentheticals can occur in
> arbitrary positions (not just at the beginning of dialog, but in the middle
> or at the end), and there can be multiple instances. The pattern doesn't
> match definition list classifiers at all.

OK. Then it is up to role (inline element) vs. directive (block element).

It should even be possible to transform all "parenthetical" role nodes to
block elements (paragraphs with class value "parenthetical", say) in a
transform. 

+1 less verbose markup (no need for blank lines)
-1 the role can be used at places where no block level markup is allowed --
   requires test and error mechanism that comes "for free" if you use a
   directive.
   
Günter   




------------------------------------------------------------------------------
BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
Develop your own process in accordance with the BPMN 2 standard
Learn Process modeling best practices with Bonita BPM through live exercises
http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_
source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
_______________________________________________
Docutils-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/docutils-users

Please use "Reply All" to reply to the list.
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.