Update to HTML Online Books Presentation

[Rob Godfrey]

All,

I've just checked in a change to the xsl that generates the "chunked"
HTML presentation of our online "Books".  The change is aimed at
making the books look like they belong to the same website as the rest
of the content :-)

I've checked in the results of running the transform against the Java
Broker book [1], but haven't done so for the C++ Broker, or
Programming Apache Qpid books.

Is everybody happy with this approach to presentation?

Obviously there's still a fair amount of work to be done on making the
documents pleasant to view online... and no amount of work on the
transforms is actually going to fix the *content* which is the primary
problem with the Java book... Still, at least when the content is
corrected it may now look like it's for the right project :-)

-- Rob

[1] http://qpid.apache.org/books/trunk/AMQP-Messaging-Broker-Java-Book/html/index.html

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

[Robbie Gemmell]

Looks like a substantial improvement to me, +1 :)

Robbie

On 25 April 2012 23:11, Rob Godfrey <[hidden email]> wrote:

> All,
>
> I've just checked in a change to the xsl that generates the "chunked"
> HTML presentation of our online "Books".  The change is aimed at
> making the books look like they belong to the same website as the rest
> of the content :-)
>
> I've checked in the results of running the transform against the Java
> Broker book [1], but haven't done so for the C++ Broker, or
> Programming Apache Qpid books.
>
> Is everybody happy with this approach to presentation?
>
> Obviously there's still a fair amount of work to be done on making the
> documents pleasant to view online... and no amount of work on the
> transforms is actually going to fix the *content* which is the primary
> problem with the Java book... Still, at least when the content is
> corrected it may now look like it's for the right project :-)
>
> -- Rob
>
> [1] http://qpid.apache.org/books/trunk/AMQP-Messaging-Broker-Java-Book/html/index.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

[Rob Godfrey]

On 26 April 2012 14:20, Robbie Gemmell <[hidden email]> wrote:
> Looks like a substantial improvement to me, +1 :)
>
> Robbie
>

As an aside, I've since checked in a change so that it behaves the
same way as the rest of the site when a browser window is re-sized.  I
haven't deployed that version to the site yet.  (Why do we not
regenerate the trunk documentation every night anyway?)

-- Rob

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

[Robbie Gemmell]

On 26 April 2012 13:23, Rob Godfrey <[hidden email]> wrote:

> On 26 April 2012 14:20, Robbie Gemmell <[hidden email]> wrote:
>> Looks like a substantial improvement to me, +1 :)
>>
>> Robbie
>>
>
> As an aside, I've since checked in a change so that it behaves the
> same way as the rest of the site when a browser window is re-sized.  I
> haven't deployed that version to the site yet.  (Why do we not
> regenerate the trunk documentation every night anyway?)
>
> -- Rob
>

We dont regenerate it every night because Jenkins (what we curretly
use) is a bit heavyweight for the job, and serving files from it is
rather slow. Checking the files into svn for the live site instead
would also be an issue. We should really be running that kind of thing
on the ASFs Buildbot instances (along with other stuff, e.g. RAT
automation).

I have been meaning to talk to infra about setting that sort of thing
up but have never got around to it. That said, I certainly dont have
the monopoly on doing such things...

Robbie

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

[Alan Conway]

On 04/25/2012 06:11 PM, Rob Godfrey wrote:

> All,
>
> I've just checked in a change to the xsl that generates the "chunked"
> HTML presentation of our online "Books".  The change is aimed at
> making the books look like they belong to the same website as the rest
> of the content :-)
>
> I've checked in the results of running the transform against the Java
> Broker book [1], but haven't done so for the C++ Broker, or
> Programming Apache Qpid books.
>
> Is everybody happy with this approach to presentation?

I find the font quite heavy, it looks to me like everything is in bold.
Otherwise it looks good.

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

[Rob Godfrey]

On 30 April 2012 16:13, Alan Conway <[hidden email]> wrote:

> On 04/25/2012 06:11 PM, Rob Godfrey wrote:
>>
>> All,
>>
>> I've just checked in a change to the xsl that generates the "chunked"
>> HTML presentation of our online "Books".  The change is aimed at
>> making the books look like they belong to the same website as the rest
>> of the content :-)
>>
>> I've checked in the results of running the transform against the Java
>> Broker book [1], but haven't done so for the C++ Broker, or
>> Programming Apache Qpid books.
>>
>> Is everybody happy with this approach to presentation?
>
>
> I find the font quite heavy, it looks to me like everything is in bold.
> Otherwise it looks good.

I find the headings heavy (and not helped by most of them being over
long) but the text itself doesn't seem overly so to me... which
OS/browser are you using?

-- Rob

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

[Alan Conway]

On 04/30/2012 10:31 AM, Rob Godfrey wrote:

> On 30 April 2012 16:13, Alan Conway<[hidden email]>  wrote:
>> On 04/25/2012 06:11 PM, Rob Godfrey wrote:
>>>
>>> All,
>>>
>>> I've just checked in a change to the xsl that generates the "chunked"
>>> HTML presentation of our online "Books".  The change is aimed at
>>> making the books look like they belong to the same website as the rest
>>> of the content :-)
>>>
>>> I've checked in the results of running the transform against the Java
>>> Broker book [1], but haven't done so for the C++ Broker, or
>>> Programming Apache Qpid books.
>>>
>>> Is everybody happy with this approach to presentation?
>>
>>
>> I find the font quite heavy, it looks to me like everything is in bold.
>> Otherwise it looks good.
>
> I find the headings heavy (and not helped by most of them being over
> long) but the text itself doesn't seem overly so to me... which
> OS/browser are you using?
>

Fedora 16/firefox 12. Actually the whole site is now in bold, it's not specific
to your documentation changes. The sidebar items look normal, but the body text
looks bold. Firefox was updated this morning, maybe a it's a new firefox font
problem.

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

[Rob Godfrey]

On 30 April 2012 16:46, Alan Conway <[hidden email]> wrote:

> On 04/30/2012 10:31 AM, Rob Godfrey wrote:
>>
>> On 30 April 2012 16:13, Alan Conway<[hidden email]>  wrote:
>>>
>>> On 04/25/2012 06:11 PM, Rob Godfrey wrote:
>>>>
>>>>
>>>> All,
>>>>
>>>> I've just checked in a change to the xsl that generates the "chunked"
>>>> HTML presentation of our online "Books".  The change is aimed at
>>>> making the books look like they belong to the same website as the rest
>>>> of the content :-)
>>>>
>>>> I've checked in the results of running the transform against the Java
>>>> Broker book [1], but haven't done so for the C++ Broker, or
>>>> Programming Apache Qpid books.
>>>>
>>>> Is everybody happy with this approach to presentation?
>>>
>>>
>>>
>>> I find the font quite heavy, it looks to me like everything is in bold.
>>> Otherwise it looks good.
>>
>>
>> I find the headings heavy (and not helped by most of them being over
>> long) but the text itself doesn't seem overly so to me... which
>> OS/browser are you using?
>>
>
> Fedora 16/firefox 12. Actually the whole site is now in bold, it's not
> specific to your documentation changes. The sidebar items look normal, but
> the body text looks bold. Firefox was updated this morning, maybe a it's a
> new firefox font problem.

OK - the docs use basically the same stylesheet data as the rest of the site...

The non-heading font looks OK to me in the various Firefox / Chromium
/ Internet Explorer on Ubuntu / Windows combinations I've tried.

-- Rob

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

[Alan Conway]

On 04/30/2012 11:27 AM, Rob Godfrey wrote:

> On 30 April 2012 16:46, Alan Conway<[hidden email]>  wrote:
>> On 04/30/2012 10:31 AM, Rob Godfrey wrote:
>>>
>>> On 30 April 2012 16:13, Alan Conway<[hidden email]>    wrote:
>>>>
>>>> On 04/25/2012 06:11 PM, Rob Godfrey wrote:
>>>>>
>>>>>
>>>>> All,
>>>>>
>>>>> I've just checked in a change to the xsl that generates the "chunked"
>>>>> HTML presentation of our online "Books".  The change is aimed at
>>>>> making the books look like they belong to the same website as the rest
>>>>> of the content :-)
>>>>>
>>>>> I've checked in the results of running the transform against the Java
>>>>> Broker book [1], but haven't done so for the C++ Broker, or
>>>>> Programming Apache Qpid books.
>>>>>
>>>>> Is everybody happy with this approach to presentation?
>>>>
>>>>
>>>>
>>>> I find the font quite heavy, it looks to me like everything is in bold.
>>>> Otherwise it looks good.
>>>
>>>
>>> I find the headings heavy (and not helped by most of them being over
>>> long) but the text itself doesn't seem overly so to me... which
>>> OS/browser are you using?
>>>
>>
>> Fedora 16/firefox 12. Actually the whole site is now in bold, it's not
>> specific to your documentation changes. The sidebar items look normal, but
>> the body text looks bold. Firefox was updated this morning, maybe a it's a
>> new firefox font problem.
>
> OK - the docs use basically the same stylesheet data as the rest of the site...
>
> The non-heading font looks OK to me in the various Firefox / Chromium
> / Internet Explorer on Ubuntu / Windows combinations I've tried.
>

Looks like it's a glitch when you zoom in on the page, ctrl-0 and everything
looks fine.

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]