Mailing-List: contact dev-help@cayenne.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cayenne.apache.org
Received-SPF: pass (athena.apache.org: local policy)
Content-Type: text/plain; charset=windows-1252
Mime-Version: 1.0 (Mac OS X Mail 6.2 \(1499\))
Subject: Re: Website CMS
From: Andrus Adamchik <andrus@objectstyle.org>
In-Reply-To: <E384F8B7-AE71-43DB-84F5-955F183BF736@objectstyle.org>
Date: Sat, 3 Nov 2012 17:59:17 +0300
Content-Transfer-Encoding: quoted-printable
Message-Id: <40CD90D7-15B7-4D41-BDE3-43CF2FCB3F98@objectstyle.org>
References: <507E393A.5020501@apache.org>
 <38AD87B8-DF9D-44D1-A983-25CCA8863AAC@objectstyle.org>
 <507E67EB.80804@gmail.com> <507E6AB7.2080301@maniatis.org>
 <507EB69D.3010505@maniatis.org>
 <535081D5-4704-4697-B283-B9B24BC253F9@objectstyle.org>
 <507F58A5.7090407@maniatis.org>
 <B3F8ECD2-7B15-4470-99DA-17FED143ECE8@objectstyle.org>
 <50809B87.8050200@maniatis.org>
 <FA538720-9E5A-45E1-BED5-FD30DD51DA09@objectstyle.org>
 <508DDAFD.2040204@maniatis.org>
 <BD50E275-0E39-4F58-B46D-D00769649C71@objectstyle.org>
 <508E3811.7040300@maniatis.org>
 <836D2ABB-560B-4BE2-A196-785AA4C8BB6E@objectstyle.org>
 <508F924A.1030908@maniatis.org>
 <0C4C98E1-0F02-425A-9DB8-A88C36AED257@objectstyle.org>
 <508FA4BD.50408@maniatis.org>
 <7CFA3553-4A5E-4B26-91C0-0A35F147AADD@objectstyle.org>
 <50905443.2080509@maniatis.org>
 <DFFA9324-BE0F-4B73-A073-1E0A493FB2D3@objectstyle.org>
 <5090D3B8.5050102@maniatis.org>
 <E384F8B7-AE71-43DB-84F5-955F183BF736@objectstyle.org>
To: dev@cayenne.apache.org

Ok. I think I am done and we are ready to replace the site.

Last night I played with fancy way to include live feeds =
(ASF::Value::Blogs, ASF::Value::Twitter, etc.) Unfortunately this didn't =
work for me. I narrowed it down to third-party XML::Atom::Feed not =
returning any entries and left it at that for now.

This morning I ported 2 years worth of blog posts to markdown (and even =
preserved the article URLs!), and simply linked to them from the home =
page. The whole process was very simple, and for our low rate of news, I =
don't mind keeping it as is.

We may play with some RSS scanners in parallel without delaying the =
launch. For instance I would love to get a Twitter panel showing latest =
stuff from https://twitter.com/ApacheCayenne (a resource that is updated =
periodically), a commit feed, etc.

Feel free to review and tweak the site at =
http://cayenne.staging.apache.org/ At some point next week I'd like to =
flip the switch on the old site and publish the new one.=20

BTW, beside following this =
http://www.apache.org/dev/cmsref.html#publishing do we need any infra =
help to activate publishing?

Andrus


On Oct 31, 2012, at 11:50 PM, Andrus Adamchik <andrus@objectstyle.org> =
wrote:

> Tonight I fixed legacy docs wrappers and created small per-version =
menus for each piece of the docs. Also checked in a bunch of smaller =
things, like the Twitter button, doc titles with version in them, etc.
>=20
> News seems to be the only thing remaining before we can go live.
>=20
> Andrus
>=20
> On Oct 31, 2012, at 10:31 AM, Aristedes Maniatis <ari@maniatis.org> =
wrote:
>=20
>> On 31/10/12 5:20pm, Andrus Adamchik wrote:
>>> I'll take a look at porting the news. Don't think we need to port =
many past news.
>>=20
>> Some would be nice to give the project history.
>>=20
>>>> Why can't the third template extend skeleton?
>>>=20
>>> My thinking was that we don't need left hand menu for the docs. For =
instance looking at Docbook produced HTML I like how clean and =
distraction free it is. Wanted to keep that across the board for docs. I =
would imagine we'll just need a Cayenne header with a backlink to the =
main site, and a copyright/privacy policy footer. Anyways, I'll refactor =
the templates to maybe have a single skeleton and optional menu include. =
Will need to play with it a bit.
>>=20
>> Sure, that makes sense. Let me know when you are done and I'll play =
with the css a bit. It is a bit ugly right now.
>>=20
>>=20
>> Ari
>>=20
>>=20
>>=20
>>> Andrus
>>>=20
>>>=20
>>> On Oct 31, 2012, at 1:27 AM, Aristedes Maniatis <ari@maniatis.org> =
wrote:
>>>> On 31/10/12 7:24am, Andrus Adamchik wrote:
>>>>=20
>>>>> Note that second and third templates do not extend skeleton =
template, as they are essentially incompatible. I just committed the =
changes, and here are the rendered examples:
>>>>>=20
>>>>> http://cayenne.staging.apache.org/download.html
>>>>> http://cayenne.staging.apache.org/doc30/api/index.html
>>>>> http://cayenne.staging.apache.org/doc30/overview.html
>>>>=20
>>>> Why can't the third template extend skeleton? I tried to strip out =
the bits of the html from the Confluence export which were incompatible, =
leaving only (hopefully) compatible bits. Perhaps we can put back =
skeleton and tweak the css a little to cope?
>>>>=20
>>>> I think the next steps are just news and tying in the automated =
docbook/javadoc builds for trunk documentation.
>>>>=20
>>>> If we go down the Apache Blog approach for news, this is what we =
do:
>>>>=20
>>>> {% for e in blog.list %}
>>>>     <h2><a href=3D"{{ e.url }}">{{ e.title }}</a></h2>
>>>>     <div class=3D"section-content">{{ =
e.content|safe|truncatewords_html:355 }}</div>
>>>>     <hr>
>>>>   {% endfor %}
>>>>=20
>>>> in our path.pm file:
>>>>=20
>>>> [ qr!^/index\.mdtext$!, news_page =3D> {
>>>>        blog     =3D> ASF::Value::Blogs->new(blog =3D> "cayenne", =
limit=3D> 4),
>>>> } ],
>>>>=20
>>>>=20
>>>> Pluses:
>>>>=20
>>>> * people can add comments to the posts
>>>> * we get broader publicity on the main apache site as well with no =
extra effort
>>>> * there is probably an rss feed
>>>>=20
>>>> Minuses:
>>>>=20
>>>> * I don't know if we can carry forward historical news, so we'd =
need to handle that separately
>>>>=20
>>>>=20
>>>> Andrus, would you like to give this a try since you now have a =
local environment? I can then style up the news items. Later on if we =
get really clever it seems we might be able to have a feed on the side =
of recent Jira comments and svn commits. That would be nice to show the =
activity that happens behind the scenes.
>>>>=20
>>>>=20
>>>> Ari
>>>>=20
>>>>=20
>>>> --
>>>> -------------------------->
>>>> Aristedes Maniatis
>>>> GPG fingerprint CBFB 84B4 738D 4E87 5E5C  5EFA EF6A 7D2E 3E49 102A
>>>>=20
>>>=20
>>=20
>> --=20
>> -------------------------->
>> Aristedes Maniatis
>> GPG fingerprint CBFB 84B4 738D 4E87 5E5C  5EFA EF6A 7D2E 3E49 102A
>>=20
>=20
>=20