Re: Working on getting the web site converted to Apache's ASF-CMS...

2012-03-29 Thread The Web Maestro 
On Tue, Mar 20, 2012 at 3:59 AM, Vincent Hennebert wrote:

> A change that I personally welcome. Quite frankly the PDF versions of
> our web pages look terrible and don’t do honour to FOP. And I’ve never
> been comfortable enough with Forrest to change the way they look. And
> I must say, I don’t have the energy to learn enough of Forrest to be
> able to do it.
>
> I’m happy with the all-CMS and Markdown approach, especially if it can
> give our website a 21st century look.
>
> Vincent
>

Apologies for the making you create a new /dev/null^H^H^H^H^H mail rule to
re-direct buildbot msgs...

Well, we don't quite have the 21st century look I was hoping for yet, but
I've got a few pages on the new staging site:

http://xmlgraphics.staging.apache.org/

We're still very prelminary. I haven't done much with the look & feel yet,
but we're on our way... It took me a bit to get Forrest outputting
'MarkDown' format (insert story about Mac OS X, downgrading Java, and
multiple versions of Forrest).

I need to figure out how to make a sidebar/navigation bar (I'm hoping for a
common one!). I also need to get sub project pages up.

Of course, I/we have yet to determine exactly how we'll go about handling
the Documentation.

If you'd like to start messing around, you can start here:

https://cms.apache.org/#bookmark

and this'll help:

http://www.apache.org/dev/cmsref.html

Cheers!

Web Maestro Clay

Re: Working on getting the web site converted to Apache's ASF-CMS...

2012-03-20 Thread Clay Leeds 


 Does that mean that we would be eventually phasing out Forrest
 altogether and store the documentation directly in the CMS?
>>> 
>>> Yes. We hope to phase out Forrest... All content changes will occur in the
>>> CMS.
>>> 
>> 
>> At present, my understanding is that the forrest content is also converted
>> to PDF by translating to XML, then running through FOP. Is this correct?
>> 
>> What will happen if we switch to MD markup, which is considerably less
>> semantically rich than forrest? Will it still be possible to create the
>> same PDF docs?

>> If not, then that seems like a fairly radical change to the current
>> approach, at least for FOP documentation.

> A change that I personally welcome. Quite frankly the PDF versions of
> our web pages look terrible and don’t do honour to FOP. And I’ve never
> been comfortable enough with Forrest to change the way they look. And
> I must say, I don’t have the energy to learn enough of Forrest to be
> able to do it.
> 
> I’m happy with the all-CMS and Markdown approach, especially if it can
> give our website a 21st century look.
> 
> Vincent

Agreed. This will make it easier to update the site  but we won't eat our dog 
food, which is a bummer.

Perhaps someone can add PDF output to the CMS? GSOC?

It's definitely a topic for discussion. 

 Clay

Re: Working on getting the web site converted to Apache's ASF-CMS...

2012-03-20 Thread Vincent Hennebert 
On 20/03/12 03:37, Glenn Adams wrote:
> On Mon, Mar 19, 2012 at 9:14 PM, The Web Maestro
> wrote:
> 
>>> Does that mean that we would be eventually phasing out Forrest
>>> altogether and store the documentation directly in the CMS?
>>
>> Yes. We hope to phase out Forrest... All content changes will occur in the
>> CMS.
>>
> 
> At present, my understanding is that the forrest content is also converted
> to PDF by translating to XML, then running through FOP. Is this correct?
> 
> What will happen if we switch to MD markup, which is considerably less
> semantically rich than forrest? Will it still be possible to create the
> same PDF docs?
> 
> If not, then that seems like a fairly radical change to the current
> approach, at least for FOP documentation.

A change that I personally welcome. Quite frankly the PDF versions of
our web pages look terrible and don’t do honour to FOP. And I’ve never
been comfortable enough with Forrest to change the way they look. And
I must say, I don’t have the energy to learn enough of Forrest to be
able to do it.

I’m happy with the all-CMS and Markdown approach, especially if it can
give our website a 21st century look.

Vincent

Re: Working on getting the web site converted to Apache's ASF-CMS...

2012-03-19 Thread Glenn Adams 
On Mon, Mar 19, 2012 at 9:14 PM, The Web Maestro
wrote:

> > Does that mean that we would be eventually phasing out Forrest
> > altogether and store the documentation directly in the CMS?
>
> Yes. We hope to phase out Forrest... All content changes will occur in the
> CMS.
>

At present, my understanding is that the forrest content is also converted
to PDF by translating to XML, then running through FOP. Is this correct?

What will happen if we switch to MD markup, which is considerably less
semantically rich than forrest? Will it still be possible to create the
same PDF docs?

If not, then that seems like a fairly radical change to the current
approach, at least for FOP documentation.

Re: Working on getting the web site converted to Apache's ASF-CMS...

2012-03-19 Thread The Web Maestro 
On Mon, Mar 19, 2012 at 11:45 AM, Vincent Hennebert
 wrote:
>> My intention is to build the web site in CMS, and then having
>> discussions, etc. *before* converting the site! There should
>> definitely be advance notice prior to the change.
>
> So both sites would co-exist for a while, only the Forrest-generated one
> being visible from xmlgraphics.apache.org ATM? Is it possible to have
> (and play with) a preview of the CMS version?

That's the plan...

>> If in my stumbling, an issue occurs with premature deployment I will
>> work quickly to resolve! That would certainly not be my intention, but
>> accidents happen! I am doing my best to ensure that does *not* happen!
>>
>> My current plan is to put some day-to-day pages in the CMS, and then
>> export all Forrest-based documentation to Markdown formatted
>> documents, for import to the CMS system according to this plugin:
>>
>> http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.Markdown/
>
> Does that mean that we would be eventually phasing out Forrest
> altogether and store the documentation directly in the CMS?

Yes. We hope to phase out Forrest... All content changes will occur in the CMS.

Part of the process will *hopefully* involve migrating our current
docs from Forrest to Markdown styled pages using the above Forrest
Markdown plugin.

> Also, is there any chance that we will be able to factorize content that
> is common to all XML Graphics websites? Among other things, I’m thinking
> of the ApacheCon events. ATM we have to update them on each of the 4 XML
> Graphics websites, which is a real pain.

It will all be one site, so that will no longer be an issue.

>> At present I don't have an ETA, but I hope to make good progress over
>> the coming weeks.
>
> There’s no rush ATM, but if for any reason you think you won’t be able
> to complete this by, say, the start of the summer, could you let us
> know? We will try to take over from where you’ve got.

Will do!

> Good luck,
> Vincent

Thanks!

Re: Working on getting the web site converted to Apache's ASF-CMS...

2012-03-19 Thread Vincent Hennebert 
Hi Clay,

Thanks for looking into this!

Just curious about a few things:

On 18/03/12 18:10, The Web Maestro wrote:
> Hi folks,
> 
> You may've noticed some shenanigans as I was preparing the XML
> Graphics site to the new ASF CMS system. In particular, I've added
> xmlgraphics/site/trunk/ and xmlgraphics/site/branches/ in preparation
> of the CMS deployment.
> 
> My intention is to build the web site in CMS, and then having
> discussions, etc. *before* converting the site! There should
> definitely be advance notice prior to the change.

So both sites would co-exist for a while, only the Forrest-generated one
being visible from xmlgraphics.apache.org ATM? Is it possible to have
(and play with) a preview of the CMS version?


> If in my stumbling, an issue occurs with premature deployment I will
> work quickly to resolve! That would certainly not be my intention, but
> accidents happen! I am doing my best to ensure that does *not* happen!
> 
> My current plan is to put some day-to-day pages in the CMS, and then
> export all Forrest-based documentation to Markdown formatted
> documents, for import to the CMS system according to this plugin:
> 
> http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.Markdown/

Does that mean that we would be eventually phasing out Forrest
altogether and store the documentation directly in the CMS?

Also, is there any chance that we will be able to factorize content that
is common to all XML Graphics websites? Among other things, I’m thinking
of the ApacheCon events. ATM we have to update them on each of the 4 XML
Graphics websites, which is a real pain.


> At present I don't have an ETA, but I hope to make good progress over
> the coming weeks.

There’s no rush ATM, but if for any reason you think you won’t be able
to complete this by, say, the start of the summer, could you let us
know? We will try to take over from where you’ve got.

Good luck,
Vincent


> Kind regards,
> 
> Clay Leeds
> --
>  - 
> My religion is simple. My religion is kindness.
> - HH The 14th Dalai Lama of Tibet

Working on getting the web site converted to Apache's ASF-CMS...

2012-03-18 Thread The Web Maestro 
Hi folks,

You may've noticed some shenanigans as I was preparing the XML
Graphics site to the new ASF CMS system. In particular, I've added
xmlgraphics/site/trunk/ and xmlgraphics/site/branches/ in preparation
of the CMS deployment.

My intention is to build the web site in CMS, and then having
discussions, etc. *before* converting the site! There should
definitely be advance notice prior to the change.

If in my stumbling, an issue occurs with premature deployment I will
work quickly to resolve! That would certainly not be my intention, but
accidents happen! I am doing my best to ensure that does *not* happen!

My current plan is to put some day-to-day pages in the CMS, and then
export all Forrest-based documentation to Markdown formatted
documents, for import to the CMS system according to this plugin:

http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.Markdown/

At present I don't have an ETA, but I hope to make good progress over
the coming weeks.

Kind regards,

Clay Leeds
--
 - 
My religion is simple. My religion is kindness.
- HH The 14th Dalai Lama of Tibet