You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucy.apache.org by Marvin Humphrey <ma...@rectangular.com> on 2006/06/10 23:49:47 UTC
Website
Greets,
A basic website built using Forrest 0.7 has been uploaded to the
repository. I opted to put it outside trunk because Lucy's going to
have a lot in there as it is, what with all the build targets. The
site still needs some stuff fleshed out, which I'll take care of
forthwith.
To modify the website's content, edit the xml docs in website/src/
documentation/content. Presuming that you have successfully
installed Forrest, when you finish editing simply issue the command
"forrest" from within the "website" directory, and everything will
get exported to website/build/site.
If you want to modify the website's appearance, there's no way around
learning Forrest. It's fairly easy to work with -- so long as you
never venture off the beaten path. I understand they're working on
making it more flexible, which would be a good thing. There were two
main challenges.
First, Forrest starts you off with a directory that's pretty bloated,
with the expectation that you'll edit it down. It's hard to find
your way around at first, and also hard to determine what you don't
need. I was pretty aggressive about deleting stuff: a few warnings
crop up when I generate the site now, but they don't seem to matter.
Second, the header area of the default "skin", called "pelt", is kind
of messed up, and fixing things so that the appearance was acceptable
to this former graphic designer required some minor hackery: the
header graphic is actually an oversized background image (so you
can't see the tiling), and the links are transparent png images on
top. I'm not going to get into the gory details of why I chose that
path, but the main reason was that that hack introduced less
complexity -- and therefore, less of a maintenance burden -- than
building a custom "skin".
The header graphic was built using Adobe Illustrator 10, and the
source AI doc can be found at website/graphics_working/
lucy_header.ai. I skipped adding source docs for the clear png's.
Marvin Humphrey
Rectangular Research
http://www.rectangular.com/
Re: Website
Posted by Doug Cutting <cu...@apache.org>.
Looks good to me!
Thanks,
Doug
Marvin Humphrey wrote:
>
> I've revised and uploaded the website, and it's now visible at
> <http://lucene.apache.org/lucy/>. Dave, Doug, please have a look.
>
> Still on the todo list: establish the temporary Lucy Wiki and update the
> "Wiki" tab to point at it. Also, the bread crumb trail at the top is a
> little wacky, just like it is for Nutch and Hadoop -- I'd like to fix that.
>
> Marvin Humphrey
> Rectangular Research
> http://www.rectangular.com/
>
Re: Website
Posted by Marvin Humphrey <ma...@rectangular.com>.
On Jun 19, 2006, at 12:57 PM, Doug Cutting wrote:
> Please update the site yourself.
Done, and sync'd at people.apache.org, so the next update should see
the updated site go live.
Marvin Humphrey
Rectangular Research
http://www.rectangular.com/
Re: Website
Posted by Doug Cutting <cu...@apache.org>.
I didn't see the copy sent to the PMC list, nor a moderation message.
It may be that I'm not the moderator of that list: Erik Hatcher may be.
Marvin Humphrey wrote:
> First, I've patched the XML pages appropriately and run forrest, which
> put the site into ./build/site/, but it's not clear to me how to move it
> from there to ./publish/.
I just use 'cp -pr'. An ant task would be better.
> Second, I'm not sure that as a Lucy committer I have permissions, either
> mechanical or informal, to alter the main Lucene website.
You didn't, but you do now.
> A patch for the XML only is below. How shall I proceed?
Please update the site yourself.
Thanks!
Doug
Re: Website
Posted by Marvin Humphrey <ma...@rectangular.com>.
Doug, Dave,
I sent this to pmc*AT*lucene.apache.org about 3 hours ago, but
haven't heard from anyone. Maybe that's a closed list and it's
sitting in a moderation queue? I've received emails from Doug since
then, whom I assume I would have reached via that address -- Doug,
have you seen this?
Begin forwarded message:
From: Marvin Humphrey <marvin*AT*rectangular.com>
Date: June 19, 2006 9:09:49 AM PDT
To: pmc*AT*lucene.apache.org
Subject: Patching top-level website
Greets,
I'm preparing a patch against the top-level website for
lucene.apache.org, adding a tab, a news item, and a bullet point
under sub-projects all pointing at <http://lucene.apache.org/lucy/>.
Doug will be sending out announcements regarding Lucy to the Lucene
lists. My goal is to provide and possibly commit a patch to the
site, so that when he's ready all he has to do is svn up at
people.apache.org. However, I've got two issues.
First, I've patched the XML pages appropriately and run forrest,
which put the site into ./build/site/, but it's not clear to me how
to move it from there to ./publish/.
Second, I'm not sure that as a Lucy committer I have permissions,
either mechanical or informal, to alter the main Lucene website.
A patch for the XML only is below. How shall I proceed?
Marvin Humphrey
Rectangular Research
http://www.rectangular.com/
Index: src/documentation/content/xdocs/site.xml
===================================================================
--- src/documentation/content/xdocs/site.xml (revision 415026)
+++ src/documentation/content/xdocs/site.xml (working copy)
@@ -28,6 +28,7 @@
<nutch label="Nutch" href="ext:nutch" />
<hadoop label="Hadoop" href="ext:hadoop" />
<lucen4c label="Lucene4c" href="ext:lucene4c" />
+ <lucy label="Lucy" href="ext:lucy" />
</docs>
<external-refs>
@@ -35,6 +36,7 @@
<nutch href="http://lucene.apache.org/nutch/" />
<hadoop href="http://lucene.apache.org/hadoop/" />
<lucene4c href="http://incubator.apache.org/lucene4c/" />
+ <lucy href="http://lucene.apache.org/lucy/" />
<store href="http://www.cafepress.com/lucene/" />
</external-refs>
Index: src/documentation/content/xdocs/index.xml
===================================================================
--- src/documentation/content/xdocs/index.xml (revision 415026)
+++ src/documentation/content/xdocs/index.xml (working copy)
@@ -37,6 +37,10 @@
C-based search engine compatible with <a href="ext:java">Lucene
Java</a>, built on the Apache Portable Runtime. Lucene4c is
still under incubation.</li>
+
+ <li><a href="ext:lucy"><strong>Lucy</strong></a> is a loose C
+ port of <a href="ext:java">Lucene Java</a>, with Perl and Ruby
+ bindings.</li>
</ul>
</section>
@@ -45,6 +49,13 @@
<title>News</title>
<section>
+ <title>19 June, 2006: Lucy development commences</title>
+ <p>The Lucene PMC has approved the <a href="ext:lucy">Lucy</a>
+ sub-project, and now that the mailing lists, repositories, and
such are
+ in place, we're rolling up our sleeves and getting to work.</p>
+ </section>
+
+ <section>
<title>26 May, 2006: Lucene 2.0.0 available</title>
<p>This is mostly a bugfix release from release 1.9.1. Note
however that
deprecated 1.x features have now been removed. Any code that
compiles
Index: src/documentation/content/xdocs/tabs.xml
===================================================================
--- src/documentation/content/xdocs/tabs.xml (revision 415026)
+++ src/documentation/content/xdocs/tabs.xml (working copy)
@@ -19,5 +19,6 @@
<tab label="Nutch" href="http://lucene.apache.org/nutch/"/>
<tab label="Hadoop" href="http://lucene.apache.org/hadoop/"/>
<tab label="Lucene4c" href="http://incubator.apache.org/lucene4c/"/>
+ <tab label="Lucy" href="http://lucene.apache.org/lucy/"/>
</tabs>
Re: Website
Posted by Marvin Humphrey <ma...@rectangular.com>.
On Jun 16, 2006, at 6:50 PM, David Balmain wrote:
> I've looked at what you've done so far and I'm happy with it.
Cool, it's time to announce. I'm arranging for a change to the top-
level website. When that's done, I'm going to send out my notices.
Marvin Humphrey
Rectangular Research
http://www.rectangular.com/
Re: Website
Posted by David Balmain <db...@gmail.com>.
On 6/14/06, Marvin Humphrey <ma...@rectangular.com> wrote:
>
> On Jun 10, 2006, at 5:23 PM, Marvin Humphrey wrote:
>
> > Still on the todo list: establish the temporary Lucy Wiki and
> > update the "Wiki" tab to point at it. Also, the bread crumb trail
> > at the top is a little wacky, just like it is for Nutch and Hadoop
> > -- I'd like to fix that.
>
> Check. Check.
>
> The Wiki tab now points at <http://wiki.apache.org/jakarta-lucene/
> LucyWiki>. I've added two pages, MinimizingObjectOverhead and
> KinoSearchMergeModel. There's one more planning doc that I think is
> essential: one describing a modular file format class system. But
> unlike the first two, that one doesn't have an existing
> implementation to draw from, so I'll bring it up here after we go
> public and we can hash it out.
>
> On Jun 13, 2006, at 3:38 PM, Doug Cutting wrote:
> > Looks good to me!
>
> Dave's MIA, I haven't seen him on the Ferret list for a while. Once
> he's back and gives the OK (or makes changes then gives the OK), I'll
> announce to the the KinoSearch list and appropriate Perl forums, Dave
> can send to the Ferret list and appropriate Ruby forums, and Doug, if
> you could send a note to the Lucene list, that'd be great.
Sorry, I really have been out of it. I hadn't even signed up to the
lists yet so my last message got bounced. Anyway, I've been really
sick all week and I've got a lot to catch up on so I might be MIA for
a bit longer. I've looked at what you've done so far and I'm happy
with it.
Cheers,
Dave
Re: Website
Posted by Doug Cutting <cu...@apache.org>.
Marvin Humphrey wrote:
> Dave's MIA, I haven't seen him on the Ferret list for a while. Once
> he's back and gives the OK (or makes changes then gives the OK), I'll
> announce to the the KinoSearch list and appropriate Perl forums, Dave
> can send to the Ferret list and appropriate Ruby forums, and Doug, if
> you could send a note to the Lucene list, that'd be great.
Sounds like a fine plan.
Thanks,
Doug
Re: Website
Posted by David Balmain <db...@gmail.com>.
On 6/14/06, Marvin Humphrey <ma...@rectangular.com> wrote:
>
> On Jun 10, 2006, at 5:23 PM, Marvin Humphrey wrote:
>
> > Still on the todo list: establish the temporary Lucy Wiki and
> > update the "Wiki" tab to point at it. Also, the bread crumb trail
> > at the top is a little wacky, just like it is for Nutch and Hadoop
> > -- I'd like to fix that.
>
> Check. Check.
>
> The Wiki tab now points at <http://wiki.apache.org/jakarta-lucene/
> LucyWiki>. I've added two pages, MinimizingObjectOverhead and
> KinoSearchMergeModel. There's one more planning doc that I think is
> essential: one describing a modular file format class system. But
> unlike the first two, that one doesn't have an existing
> implementation to draw from, so I'll bring it up here after we go
> public and we can hash it out.
>
> On Jun 13, 2006, at 3:38 PM, Doug Cutting wrote:
> > Looks good to me!
>
> Dave's MIA, I haven't seen him on the Ferret list for a while. Once
> he's back and gives the OK (or makes changes then gives the OK), I'll
> announce to the the KinoSearch list and appropriate Perl forums, Dave
> can send to the Ferret list and appropriate Ruby forums, and Doug, if
> you could send a note to the Lucene list, that'd be great.
I'm back. Sorry, I've been sick all week. Love the website. I've got a
lot to catch up here.
Re: Website
Posted by Marvin Humphrey <ma...@rectangular.com>.
On Jun 10, 2006, at 5:23 PM, Marvin Humphrey wrote:
> Still on the todo list: establish the temporary Lucy Wiki and
> update the "Wiki" tab to point at it. Also, the bread crumb trail
> at the top is a little wacky, just like it is for Nutch and Hadoop
> -- I'd like to fix that.
Check. Check.
The Wiki tab now points at <http://wiki.apache.org/jakarta-lucene/
LucyWiki>. I've added two pages, MinimizingObjectOverhead and
KinoSearchMergeModel. There's one more planning doc that I think is
essential: one describing a modular file format class system. But
unlike the first two, that one doesn't have an existing
implementation to draw from, so I'll bring it up here after we go
public and we can hash it out.
On Jun 13, 2006, at 3:38 PM, Doug Cutting wrote:
> Looks good to me!
Dave's MIA, I haven't seen him on the Ferret list for a while. Once
he's back and gives the OK (or makes changes then gives the OK), I'll
announce to the the KinoSearch list and appropriate Perl forums, Dave
can send to the Ferret list and appropriate Ruby forums, and Doug, if
you could send a note to the Lucene list, that'd be great.
Marvin Humphrey
Rectangular Research
http://www.rectangular.com/
Re: Website
Posted by Marvin Humphrey <ma...@rectangular.com>.
I've revised and uploaded the website, and it's now visible at
<http://lucene.apache.org/lucy/>. Dave, Doug, please have a look.
Still on the todo list: establish the temporary Lucy Wiki and update
the "Wiki" tab to point at it. Also, the bread crumb trail at the
top is a little wacky, just like it is for Nutch and Hadoop -- I'd
like to fix that.
Marvin Humphrey
Rectangular Research
http://www.rectangular.com/