stdcxx-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Eric Lemings" <Eric.Lemi...@roguewave.com>
Subject RE: [jira] Assigned: (STDCXX-686) redesign web site
Date Fri, 01 Feb 2008 17:16:44 GMT
 
I like it.  It follows the style of the current site so it's not
too disruptive.

Couple minor suggestions:

1. Move the Documentation nav up to a tab next to the Download tab.

2. Move all links at the top of the home page to the nav bar,
and subdivide them into groups (e.g. General [Objectives, About],
Project [Lists, Wiki, Status, News, Team], Technical (Bugs, Readme,
License, Platforms, References]

3. Where's the logo? :)

Brad.

> -----Original Message-----
> From: Gav.... [mailto:brightoncomputers@brightontown.com.au] 
> Sent: Friday, February 01, 2008 1:25 AM
> To: dev@stdcxx.apache.org
> Subject: RE: [jira] Assigned: (STDCXX-686) redesign web site
> 
> G'Day,
> 
> > -----Original Message-----
> > From: Martin Sebor [mailto:msebor@gmail.com] On Behalf Of 
> Martin Sebor
> > Sent: Friday, 1 February 2008 3:00 PM
> > To: dev@stdcxx.apache.org
> > Subject: Re: [jira] Assigned: (STDCXX-686) redesign web site
> > 
> > Gav... wrote:
> > > Hi Martin,
> > >
> > > Let me know what info you need from me next.
> > > Once the source files I sent are in svn, then I'll be 
> able to patch
> > > properly against that.
> > 
> > It looks quite good, thanks! I published it in my home directory
> > to get some feedback from others:
> > 
> >    http://people.apache.org/~sebor/stdcxx/forrest-site/
> 
> As initial information for others, the look of this site is the
> standard issue 'forrest pelt theme' and if so wish, can be changed
> to have more unique feel to it. This can wait I think until the
> site is live and populated with docs.
> 
> > 
> > Btw., it looks like a couple of typos snuck into index.xml and
> > bugs.xml. I corrected them to get forrest to generate the static
> > site (otherwise it fails)...
> 
> Damn, sorry, I tested using 'forrest run' which ensures the 
> site is mostly
> fine and working  - but does not scrutinise the xdocs for 
> validity against
> the DTD. Only when a 'forrest site' or 'forrest 
> validate-xdocs' is run do
> the files get checked against the DTD. 
> 
> > ... but I still get the error below at the
> > end. It looks like a link is bad or something.
> > 
> > * [6/30]    [0/0]     0.016s 1.5Kb   themes/getBlank.js
> > X [0]                                     favicon.ico   BROKEN: No
> > pipeline matched request: favicon.ico
> >          at <map:mount> -
> > file:/build/sebor/apache-forrest-0.8/main/webapp/./site
> > ...
> > Total time: 0 minutes 15 seconds,  Site size: 182,695 Site pages: 42
> > Java Result: 1
> > 
> >    Copying broken links file to site root.
> > 
> > Copying 1 file to /build/sebor/tmp/site2/build/site
> > 
> > BUILD FAILED
> > /build/sebor/apache-forrest-0.8/main/targets/site.xml:180: Error
> > building site.
> > 
> > There appears to be a problem with your site build.
> 
> Easy one and my bad again. Automatically a favicon.ico is 
> associated with
> the site and is in fact copied there when doing a 'forrest 
> seed-sample'.
> As you found out though this produces many un-needed sample 
> files. So I
> created the initial layout with a 'forrest seed-basic' which gives you
> a site structure but no files and in this case no favicon either.
> 
> So the cure is to stick a favicon.ico directly into the xdocs folder.
> The site will then build successfully. 
> 
> > 
> > The two typos are: a missing underscore in the section id
> > mailing_list in index.xml and a stray # in bugs.xml. Forrest
> > gives rather cryptic errors for them.
> 
> The error messages were mainly to do with why they did not 
> conform with the
> DTD - i.e the # symbol is not allowed directly beneath <ol> 
> and points out
> that only <li> can go inside.
> 
> Most of the time, we will use Forrests v2.0 DTD - 
> 
> http://forrest.apache.org/dtdx/document-v20.dtdx.html
> 
> (it is working towards being more xhtml2 compliant)
> 
> > 
> > So sounds like the next step is to commit the prototype into svn
> > and set up a cron job to get it periodically published into some
> > sandbox (such as my home directory) so we can work on the tables
> > etc. Is that how you'd like to proceed?
> 
> Yep, fine by me, at least I'll be able to be useful with patches then.
> Once your happy with stability, completeness and the 
> forrestbot publishing
> is working well, then it can be moved when your happy.
> 
> > 
> > I'm also curious if you have a suggestion for our documentation.
> > Would it make sense to try to convert it as well or might some
> > other solution be more appropriate?
> 
> I have referred this to the Forrest dev list. It should not 
> be a problem
> in principle, convert the .html files into xdoc xml and then 
> back into .html
> integrated into the rest of the generated site. Hopefully the initial
> conversion to xdoc can be automated. Once in xdoc xml format 
> then they can
> be placed appropriately, added to the site.xml and tabs.xml 
> files and from
> then on be part of the site proper.
> 
> > 
> > >
> > > I notice Jira replies are set to issues@, is there a Jira 
> ticket filed
> > to
> > > change this to dev@.
> > 
> > Not yet. I was hoping to get to it this week but lately time has
> > a habit of getting away from me... You don't happen to know where
> > to change this, do you?
> 
> I don't have the access to do it, I've asked on #infra and 
> will let you know
> if someone does it. Otherwise you need to send a mail to 
> apmail@ and file a
> Jira Issue on infra for it to be done .
> 
> (http://apache.org/dev/reporting-issues.html#mail-config)
> 
> 
> Gav...
> 
> > 
> > Martin
> > 
> > >
> > > Gav...
> > >
> > > <quote who="Martin Sebor (JIRA)">
> > >>      [
> > >> https://issues.apache.org/jira/browse/STDCXX-
> > 
> 686?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
> > >> ]
> > >>
> > >> Martin Sebor reassigned STDCXX-686:
> > >> -----------------------------------
> > >>
> > >>     Assignee: Martin Sebor
> > >>
> > >>> redesign web site
> > >>> -----------------
> > >>>
> > >>>                 Key: STDCXX-686
> > >>>                 URL: 
> https://issues.apache.org/jira/browse/STDCXX-686
> > >>>             Project: C++ Standard Library
> > >>>          Issue Type: Improvement
> > >>>          Components: Web
> > >>>            Reporter: Martin Sebor
> > >>>            Assignee: Martin Sebor
> > >>>         Attachments: Copy of stdcxx.zip
> > >>>
> > >>>   Original Estimate: 16h
> > >>>  Remaining Estimate: 16h
> > >>>
> > >>> The current web site is a bunch of static HTML pages 
> with a lot of
> > >>> difficult-to-maintain formatting cruft copied from 
> pages of another
> > >>> incubator project. We should look into generating the site from
> > >>> easier-to-maintain "sources" using a tool like Apache 
> Forrest or some
> > >>> such.
> > >> --
> > >> This message is automatically generated by JIRA.
> > >> -
> > >> You can reply to this email to add a comment to the issue online.
> > >>
> > >>
> > >
> > >
> > 
> > 
> > 
> > --
> > Internal Virus Database is out-of-date.
> > Checked by AVG Free Edition.
> > Version: 7.5.516 / Virus Database: 269.19.2 - Release Date: 
> 1/12/2008
> > 12:00 AM
> 

Mime
View raw message