From mboxrd@z Thu Jan  1 00:00:00 1970
From: Sebastian Rose <sebastian_rose@gmx.de>
Subject: Re: export and containers
Date: Mon, 02 Mar 2009 12:58:15 +0100
Message-ID: <87iqmsyw4o.fsf@kassiopeya.MSHEIMNETZ>
References: <49a91200.1438560a.6867.ffffb3e4@mx.google.com>
	<87eixikd1u.fsf@kassiopeya.MSHEIMNETZ>
	<49ab92ef.0407560a.4681.543e@mx.google.com>
	<87vdqsz31c.fsf@kassiopeya.MSHEIMNETZ>
	<95B3F1B7-98EE-4831-9FB3-1B7D34598061@uva.nl>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1Le6jq-0002WU-B4
	for emacs-orgmode@gnu.org; Mon, 02 Mar 2009 06:55:14 -0500
Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1Le6jp-0002UX-OV
	for emacs-orgmode@gnu.org; Mon, 02 Mar 2009 06:55:13 -0500
Received: from [199.232.76.173] (port=33368 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1Le6jp-0002UA-5m
	for emacs-orgmode@gnu.org; Mon, 02 Mar 2009 06:55:13 -0500
Received: from mail.gmx.net ([213.165.64.20]:53394)
	by monty-python.gnu.org with smtp (Exim 4.60)
	(envelope-from <sebastian_rose@gmx.de>) id 1Le6jo-0002HS-Hz
	for emacs-orgmode@gnu.org; Mon, 02 Mar 2009 06:55:12 -0500
In-Reply-To: <95B3F1B7-98EE-4831-9FB3-1B7D34598061@uva.nl> (Carsten Dominik's
	message of "Mon, 2 Mar 2009 12:11:09 +0100")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Carsten Dominik <dominik@science.uva.nl>
Cc: org-mode <emacs-orgmode@gnu.org>, Richard Riley <rileyrgdev@googlemail.com>

Carsten Dominik <dominik@science.uva.nl> writes:
> Hi Sebastian,
>
>
> On Mar 2, 2009, at 10:29 AM, Sebastian Rose wrote:
>>
>> * Suggestions for names
>>
>>  `wrap' is, what they use in typolight and some other CMSs. But
>>  `content' sounds good to me too.
>>
>>  <div id="center">
>>    <div id="wrap"><!-- or `content' -->
>>
>>      <div id="box-1">
>>        <div id="table-of-contents">
>>         ...
>>        </div>
>>      </div><!-- end of box-1 -->
>>
>>      <div id="box-2">
>>        <div id="outline-container-2" class="outline-2">
>>          <h2 id="sec-1"><span class="section-number-2">2</span> Konfiguration
>> </h2>
>>          <div class="outline-text-2" id="text-2">
>>           ...
>>          </div>
>>        </div>
>>        ... more sections, footnotes ...
>>      </div><!-- end of box-2 -->
>>
>>      <div id="postamble">
>>        postamble
>>      </div>
>>
>>
>>    </div><!-- end of wrap -->
>>  </div><!-- end of center -->
>
>
> How about these names for additional divs
>
> content-wrap
> content         ;; I think we should just have one around the entire content.
>                 ;; should this also contain the <h1> with the page title?
>                 ;; I think yes

OK, one might be enough. There's a cross-browser CSS to center the contents
vertically with only one container:

#content-wrap
{
  ...
  margin-top:auto;
  margin-bottom:auto;
  vertical-align:middle;
  ...
}

And yes,  the title should be inside `content-wrap'

> table-of-contents-wrap
>
> footnote-wrap
> bibliography-wrap
> postamble-wrap
>
> So we put all the stuff into specific "wrap" containers.
> I don't so much like "column-1", because that looks fine
> if you use it for columns, but it looks confusing if you
> use it for something else...


Agreed.

How about `org(-container ?) for the outer most container? Think of
exporting the content only for inclusion into some framework. In that
case `org' seems a natural name.

Anyway, for sake of the TOC on the left, we should also wrap all the rest
of the contents in one <div> with postamble being the only exception.

The tree would simply be:

 org
    title
    table-of-contents-wrap
       table-of-contents
    content-wrap
       sec-1...    - unchanged
       footnotes   - unchanged
       bibliography
    postamble    // already there

The reason for the container around everything excluding title, TOC and
postamble is, that I don't want the TOC to live in the left margin of
the <body>, the way it does now.

`float:left' for the TOC will cause the page to look funny in the most
cases: 

  +-----+--------------+
  | TOC |  TITLE       |
  +-----+  SEC-1       |
  |  SEC2              |
  |  SEC2              |
  |  FOOTNOTES         |
  +--------------------+
  |     POSTAMBLE      |
  +--------------------+

Better:

  +-----+--------------+
  | TOC |  TITLE       |
  |     |  SEC-1       |
  |     |  SEC2        |
  |     |  SEC3        |
  |     |  FOOTNOTES   |
  +--------------------+
  |     POSTAMBLE      |
  +--------------------+


And this one here would be nice (all navigational elements visible on
load): 

  +-----+--------------+-----+
  | TOC |  TITLE       | LOT |
  |     |  SEC-1       +-----+
  |     |  SEC2        | LOF |
  |     |  SEC3        +-----+
  |     |  FOOTNOTES   | BIB |
  +-----+--------------+-----+
  |        POSTAMBLE         |
  +--------------------------+

Some people (see drupal) put the postamble into the right/center column
for two and three column layout respectively. I don't like that very
much.




What we should do before we change anything, is to experiment with one
simple document and different stylesheets, to ensure everything works
the way we want it to.

I'll set up some with the different aproaches and try to add different
CSS stylesheets. Our aim must be to make many different layouts possible
(we will never make _all_ possible layouts feasable though).



Important layouts are:

  | Name                    | example          |
  |-------------------------+------------------|
  | Fixed TOC               | orgmode.org      |
  | Floating TOC            | orgmode.org/worg |
  | Please add more here...                    |

  The usual page-flow will always stay what it is as long as no special
  styles are added.


Best,

   Sebastian


> - Carsten
>
>>
>>
>>
>>
>>>>
>>>>      <div id="column-1">       -- Help with fixed TOC
>>>>        <div id="table-of-contents">
>>>>          the toc
>>>>        </div>
>>>>      </div>
>>>>
>>>>      <div id="column-2">       -- Help with fixed TOC
>>>>        All the rest of the content goes here
>>>>      </div>
>>>>
>>>>      <div id="postamble">
>>>>        postamble
>>>>      </div>
>>>>
>>>>    </div>
>>>>  </div>
>>>> </body>
>>>>
>>>>
>>>>
>>>> Having two boxes for the TOC would make the fixed TOC work in IE. In
>>>> general, I prefere to use two kinds of Boxes:
>>>>
>>>>  - one for positioning, floating and so on. This one should have _no_
>>>>    padding or margin at all!
>>>
>>> Can one not simply use .body for that?
>>>
>>>>  - one for margin, padding, styling.
>>>>
>>>> I found, this is the only way to reliably enforce a layout across
>>>> browsers.
>>>>
>>>>
>>>> column-1 and column-2 are for that very reason. All we can do to put the
>>>> TOC to the left or right is, to add margins to the body or the level 1
>>>> contents, and place it there. This is, what causes the problems with the
>>>> fixed TOC in IE. `column-1' and `column-2' (and `postamble') make it
>>>> possible, to adjust the layout in various common ways.
>>>>
>>>> The `percent-50' (oh what a name) and `wrap' are just there, to be able
>>>> to center the whole page horizontally _and_ veritcally.
>>>
>>>>
>>>>
>>>> Best,

-- 
Sebastian Rose, EMMA STIL - mediendesign, Niemeyerstr.6, 30449 Hannover
Tel.:  +49 (0)511 - 36 58 472
Fax:   +49 (0)1805 - 233633 - 11044
mobil: +49 (0)173 - 83 93 417
Email: s.rose@emma-stil.de, sebastian_rose@gmx.de
Http:  www.emma-stil.de