Re: [Docutils-users] broken ..epigraph in XeTeX?

[Guenter M. <mi...@us...>]

On 2017-02-04, Alan G. Isaac wrote:
> On 2/4/2017 4:41 PM, Guenter Milde wrote:
>> Both "quote" and "quotation" provide for multiple paragraphs.

> I did not mean to call that into question
> Indeed, this is addressed at the link I provided:
> https://en.wikibooks.org/wiki/LaTeX/Paragraph_Formatting#Quoting_text

> My point was rather that these are **quotation** environments,
> not general indentation environments.  To use a quotation
> environment whenever indentation is needed is to disregard
> its intended use (semantics).  That is my point.

However, according to the wiktionary, an epigraph is

  1. an inscription, especially one on a building.
  2. a literary quotation placed at the beginning of a book or other
     text.
  3. (mathematics, of a function) the set of all points lying on or above
     the function's graph.

For Docutils, 2. is relevant and hence it defines the "epigraph" directive:

   Epigraph
   
   Directive Type
       “epigraph” 

   Doctree Element
       block_quote 

   Directive Arguments
       None. 

   Directive Options
       None. 

   Directive Content
       Interpreted as the body of the block quote. 
   
   An epigraph is an apposite (suitable, apt, or pertinent) short
   inscription, often a quotation or poem, at the beginning of a document
   or section.
   
   The “epigraph” directive produces an “epigraph”-class block quote. For
   example, this input:
   
   .. epigraph::
   
      No matter where you go, there you are.
   
      -- Buckaroo Banzai
   
   becomes this document tree fragment:
   
   <block_quote classes="epigraph">
       <paragraph>
           No matter where you go, there you are.
       <attribution>
           Buckaroo Banzai



>> Alan wrote:
>>> this again compromises the ability to separately style quotes
>>> and other content (in this case, epigraphs).

> On 2/4/2017 4:41 PM, Guenter Milde wrote:
>> Not if the class arguments are handled correctly.

> I thought that this makes it impossible to change the
> formatting of actual quotes without having that spilling
> over to other environments (such as epigraph).

Formatting block quotes will "spill over" to epigraphs by default. 
*This is intended*, as an epigraph is a special quote.

It can be offset by styling the quote environments with class value epigraph
(in HTML you use CSS rules, in LaTeX by defining a function \DUclassepigraph).

> Your response seems to suggest otherwise.  How for example
> would I style quotes to have an extra one inch margin on the left
> and right but epigraphs to have an extra two inches on the left only?
> (I am assuming that epigraphs continue to be wrapped in a ``quote``
> environment.)  Am I overlooking something obvious?

I LaTeX, the above epigraph becomes

\begin{quote}
\DUclass{epigraph}%

No matter where you go, there you are.
\nopagebreak

\raggedleft —Buckaroo Banzai

\end{quote}


I don't know the details of margin changing off by heart, but the idea is
to use the "class macro" to style the environments with the given class, e.g.
to set the epigraph in italics, you can write

 \newcommand{\DUclassepigraph}{\em}
 
in the preamble.

Günter