You are viewing a plain text version of this content. The canonical link for it is here.
Posted to pylucene-dev@lucene.apache.org by Thomas Koch <ko...@orbiteam.de> on 2012/08/08 16:42:26 UTC
PyLucene 3.6 build on MacOS and PyLucene website
Hi,
I'm also running Mac OS now (besides windows still ,-) and was able to build
& install PyLucene 3.6.0.2 on MacOS-X (10.7/intel/Python2.7) without any
problems - that's the good news.
However it was quite difficult for me to get the download files and
installation instructions:
Download:
-------------
>From http://lucene.apache.org/pylucene/ there is no visible download link
(it even does not contain the word "Download"). There is a hint "Source
distributions are available
<http://www.apache.org/dyn/closer.cgi/lucene/pylucene/> here." on the main
page, below "News", though.
The Install page at http://lucene.apache.org/pylucene/install.html has a
download link in the news on the bottom of the page:
"Lucene can be downloaded from
<http://lucene.apache.org/core/mirrors-core-3x-redir.html?>
http://lucene.apache.org/core/mirrors-core-3x-redir.html " ,but this page
only lists the Java version.
In the end I did open this manually "crafted" URL
www.apache.org/dyn/closer.cgi/lucene/ and was able to browse to a /pylucene/
folder. (because I didn't see the "source dist" hint in the first place).
Install:
--------
On the Install page at http://lucene.apache.org/pylucene/install.html there
are broken links:
"see JCC's <site:jcc/documentation/install> installation instructions " ->
site:jcc/documentation/install
The file INSTALL in the distribution says
--
Please see doc/documentation/install.html or
http://lucene.apache.org/pylucene/documentation/install.html
--
But there is no "doc" directory in the distribution! (Same for README which
points to non-existing 'doc/documentation/readme.html' - and the jcc/README
and jcc/INSTALL). Possibly the doc-dir just slipped through the build
process . (I've seen this directory before)
There was some discussion about fixes to the website on the mailing list, so
I thought this would be worth mentioning.
Note there is a nice download button on the Java Lucene site at
lucene.apache.org - that's probably the first thing most devs are looking
for ,-)
regards
Thomas
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Andi Vajda <va...@apache.org>.
On Thu, 23 Aug 2012, Robert Muir wrote:
> On Thu, Aug 23, 2012 at 12:51 PM, Andi Vajda <va...@apache.org> wrote:
>>
>> I can now retract my 'crying shame' comment on the site. A bunch of work is
>> still needed but there is enough critical mass there to get the formatting
>> correct proceeding by example. Before it was a "oh, where do I even start,
>> kind of mess"
>>
>
> A few things i noticed (in general I didnt want to try to change
> content or anything like that but just fix formatting and links so
> things are readable and work)
>
> * does pylucene have a logo?
>
> it currently uses the lucene logo. on the other hand, if we want to
> keep the current logo we could at least apply the shadow'd apache
> feather to make it nicer: compare the lucene logo at
> http://lucene.apache.org/ with http://lucene.apache.org/pylucene
No, it doesn't have a logo. I think using Lucene's logo is fine.
If people disagree and want to contribute a logo, by all means !
> * does pylucene want the slides functionality that is on
> http://lucene.apache.org/core/ and http://lucene.apache.org/solr ? if
> so we just need a list of some 'text snippets/slogans' to rotate
> through, could probably reuse the lucene core images.
I don't think it's a must but if people want to contribute text snippets and
set that up, it sure looks nice.
> * should the pylucene download button appear under jcc/ pages? I
> wasn't sure if it should, but thats easy to fix.
Yes, but it should then point at the http://pypi.python.org/pypi/JCC/2.13
URL which might be a bit touchy with regards to Apache's rules.
> * pylucene and jcc "Features" pages are really "Documentation", this
> is a little confusing. I think the link should be renamed
> "Documentation" and maybe have a separate features list like
> http://lucene.apache.org/core/features.html ?
Agreed. Their current name came over from the 'forrest' content.
> * the application of italics/bold is somewhat arbitrary: I did this
> because previously these had <code>...</code> which causes a big blue
> blockquoted section with line breaks, useful really for code examples
> but not for reference to functions or class names. If there is some
> defined scheme (java class name monospace, functions italics, command
> lines and arguments bold, or whatever), it could probably be more
> consistent.
Looks great to me. I originally wanted all code to use a fixed width font
and respect the indentation of the source file, thus the code blocks. This
worked fine with Forrest but markdown thinks differently. As long as what
replaces the fixed width font for code is used consistently and respects
indentation so that code sames are legible, I'm happy with the change.
> * maybe in addition to the download 'button' there should also be a
> simple page with the information about how to retrieve older versions
> from the apache archives etc. (similar to
> http://lucene.apache.org/core/downloads.html)
+1 !
Andi..
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Robert Muir <rc...@gmail.com>.
On Thu, Aug 23, 2012 at 12:51 PM, Andi Vajda <va...@apache.org> wrote:
>
> I can now retract my 'crying shame' comment on the site. A bunch of work is
> still needed but there is enough critical mass there to get the formatting
> correct proceeding by example. Before it was a "oh, where do I even start,
> kind of mess"
>
A few things i noticed (in general I didnt want to try to change
content or anything like that but just fix formatting and links so
things are readable and work)
* does pylucene have a logo?
it currently uses the lucene logo. on the other hand, if we want to
keep the current logo we could at least apply the shadow'd apache
feather to make it nicer: compare the lucene logo at
http://lucene.apache.org/ with http://lucene.apache.org/pylucene
* does pylucene want the slides functionality that is on
http://lucene.apache.org/core/ and http://lucene.apache.org/solr ? if
so we just need a list of some 'text snippets/slogans' to rotate
through, could probably reuse the lucene core images.
* should the pylucene download button appear under jcc/ pages? I
wasn't sure if it should, but thats easy to fix.
* pylucene and jcc "Features" pages are really "Documentation", this
is a little confusing. I think the link should be renamed
"Documentation" and maybe have a separate features list like
http://lucene.apache.org/core/features.html ?
* the application of italics/bold is somewhat arbitrary: I did this
because previously these had <code>...</code> which causes a big blue
blockquoted section with line breaks, useful really for code examples
but not for reference to functions or class names. If there is some
defined scheme (java class name monospace, functions italics, command
lines and arguments bold, or whatever), it could probably be more
consistent.
* maybe in addition to the download 'button' there should also be a
simple page with the information about how to retrieve older versions
from the apache archives etc. (similar to
http://lucene.apache.org/core/downloads.html)
--
lucidworks.com
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Andi Vajda <va...@apache.org>.
On Thu, 23 Aug 2012, Robert Muir wrote:
> On Thu, Aug 23, 2012 at 11:45 AM, Andi Vajda <va...@apache.org> wrote:
>
>>
>> Also, the jcc part of the site doesn't seem to be inheriting any of the css from the rest of the site.
>>
>
> Do you have an example URL where this is a problem? Maybe its a
> browser refresh issue?
>
> I see the correct CSS layout for all 3 files under jcc/
> http://lucene.apache.org/pylucene/jcc/
> http://lucene.apache.org/pylucene/jcc/features.html
> http://lucene.apache.org/pylucene/jcc/install.html
This is simply amazing !!
Last time I looked at the site, when integrating patches from Petrus a few
weeks ago, it still looked really bad.
This is looking so much better already. Whoever did this (Robert ?), thank
you so much. And, yes, it does look like the jcc part is looking just as
good as the rest.
A big thank you, this is quite a boost !
I can now retract my 'crying shame' comment on the site. A bunch of work is
still needed but there is enough critical mass there to get the formatting
correct proceeding by example. Before it was a "oh, where do I even start,
kind of mess"
Andi..
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Robert Muir <rc...@gmail.com>.
On Thu, Aug 23, 2012 at 11:45 AM, Andi Vajda <va...@apache.org> wrote:
>
> Also, the jcc part of the site doesn't seem to be inheriting any of the css from the rest of the site.
>
Do you have an example URL where this is a problem? Maybe its a
browser refresh issue?
I see the correct CSS layout for all 3 files under jcc/
http://lucene.apache.org/pylucene/jcc/
http://lucene.apache.org/pylucene/jcc/features.html
http://lucene.apache.org/pylucene/jcc/install.html
--
lucidworks.com
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Andi Vajda <va...@apache.org>.
On Aug 23, 2012, at 8:07, Robert Muir <rc...@gmail.com> wrote:
> On Thu, Aug 23, 2012 at 3:05 AM, Thomas Koch <ko...@orbiteam.de> wrote:
>
>>>
>> I want to have a look at the process and see how I can help, but can't
>> promise anything right now. Won't have time until next week to give it a
>> try, but will provide feedback then anyway.
>>
>
> OK, thanks. I think i addressed most of your concerns yesterday. I
> tried to fix the formatting so various code samples and instructions
> etc look correct.
> When reviewing it would be good to look for any crazy formatting or
> cases where __init__() shows up as init() because _'s are treated as
> markdown characters (i tried to find all these and escape them).
> Also to check if the formatting is appropriate (e.g. italics versus
> bold or whatever), and no huge headings or anything like that.
> I'm sure there are some little problems but imo its looking a lot more readable.
Also, the jcc part of the site doesn't seem to be inheriting any of the css from the rest of the site.
Andi..
>
> --
> lucidworks.com
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Robert Muir <rc...@gmail.com>.
On Thu, Aug 23, 2012 at 3:05 AM, Thomas Koch <ko...@orbiteam.de> wrote:
>>
> I want to have a look at the process and see how I can help, but can't
> promise anything right now. Won't have time until next week to give it a
> try, but will provide feedback then anyway.
>
OK, thanks. I think i addressed most of your concerns yesterday. I
tried to fix the formatting so various code samples and instructions
etc look correct.
When reviewing it would be good to look for any crazy formatting or
cases where __init__() shows up as init() because _'s are treated as
markdown characters (i tried to find all these and escape them).
Also to check if the formatting is appropriate (e.g. italics versus
bold or whatever), and no huge headings or anything like that.
I'm sure there are some little problems but imo its looking a lot more readable.
--
lucidworks.com
AW: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Thomas Koch <ko...@orbiteam.de>.
> > If anyone wants to help, here is link with a video on how to make
> > edits and submit them
> > (http://www.apache.org/dev/cmsref.html#non-committer)
>
> Contributions would be much appreciated.
>
> Andi..
>
I want to have a look at the process and see how I can help, but can't
promise anything right now. Won't have time until next week to give it a
try, but will provide feedback then anyway.
Regards
Thomas
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Andi Vajda <va...@apache.org>.
On Wed, 22 Aug 2012, Robert Muir wrote:
> Sorry, I missed this thread and reported the same thing.
>
> I think i got the links working, I'll see if i can figure out some of
> this formatting.
Thanks, Robert !
> I dont know any of this much myself, only barely squeezing by to get
> the lucene Java releases out.
>
> If anyone wants to help, here is link with a video on how to make
> edits and submit them
> (http://www.apache.org/dev/cmsref.html#non-committer)
Contributions would be much appreciated.
Andi..
>
> On Wed, Aug 8, 2012 at 11:21 AM, Andi Vajda <va...@apache.org> wrote:
>> Since the switch to the new Apache CMS, a year ago, the PyLucene website has been a shameful wreck.
>>
>> I don't have the spare cycles to spend the time to fix it. Call it an unfunded mandate (timewise).
>>
>> The good news is that anyone can actually fix it and send in patches to get applied to the public site.
>>
>> You can either check out the sources or use the interactive interface on the Apache CMS itself.
>>
>> It would be nice to inherit the look from the main Lucene site as well as its buttons.
>>
>> See Lucene bug 2748 for details, especially Grant's comment from 06/Aug/2011 22:13.
>>
>> Clearly, the PyLucene site needs volunteers. It's not a huge task other than the learning curve if battling with css and markdown.
>>
>> Any takers ?
>>
>> Andi..
>>
>> On Aug 8, 2012, at 16:42, "Thomas Koch" <ko...@orbiteam.de> wrote:
>>
>>> Hi,
>>>
>>> I'm also running Mac OS now (besides windows still ,-) and was able to build
>>> & install PyLucene 3.6.0.2 on MacOS-X (10.7/intel/Python2.7) without any
>>> problems - that's the good news.
>>>
>>>
>>>
>>> However it was quite difficult for me to get the download files and
>>> installation instructions:
>>>
>>>
>>>
>>> Download:
>>>
>>> -------------
>>>
>>>> From http://lucene.apache.org/pylucene/ there is no visible download link
>>> (it even does not contain the word "Download"). There is a hint "Source
>>> distributions are available
>>> <http://www.apache.org/dyn/closer.cgi/lucene/pylucene/> here." on the main
>>> page, below "News", though.
>>>
>>>
>>>
>>> The Install page at http://lucene.apache.org/pylucene/install.html has a
>>> download link in the news on the bottom of the page:
>>>
>>> "Lucene can be downloaded from
>>> <http://lucene.apache.org/core/mirrors-core-3x-redir.html?>
>>> http://lucene.apache.org/core/mirrors-core-3x-redir.html " ,but this page
>>> only lists the Java version.
>>>
>>>
>>>
>>> In the end I did open this manually "crafted" URL
>>> www.apache.org/dyn/closer.cgi/lucene/ and was able to browse to a /pylucene/
>>> folder. (because I didn't see the "source dist" hint in the first place).
>>>
>>>
>>>
>>> Install:
>>>
>>> --------
>>>
>>> On the Install page at http://lucene.apache.org/pylucene/install.html there
>>> are broken links:
>>>
>>> "see JCC's <site:jcc/documentation/install> installation instructions " ->
>>> site:jcc/documentation/install
>>>
>>>
>>>
>>> The file INSTALL in the distribution says
>>>
>>> --
>>>
>>> Please see doc/documentation/install.html or
>>>
>>> http://lucene.apache.org/pylucene/documentation/install.html
>>>
>>> --
>>>
>>> But there is no "doc" directory in the distribution! (Same for README which
>>> points to non-existing 'doc/documentation/readme.html' - and the jcc/README
>>> and jcc/INSTALL). Possibly the doc-dir just slipped through the build
>>> process . (I've seen this directory before)
>>>
>>>
>>>
>>> There was some discussion about fixes to the website on the mailing list, so
>>> I thought this would be worth mentioning.
>>>
>>>
>>>
>>> Note there is a nice download button on the Java Lucene site at
>>> lucene.apache.org - that's probably the first thing most devs are looking
>>> for ,-)
>>>
>>>
>>>
>>>
>>>
>>> regards
>>> Thomas
>>>
>
>
>
> --
> lucidworks.com
>
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Robert Muir <rc...@gmail.com>.
Sorry, I missed this thread and reported the same thing.
I think i got the links working, I'll see if i can figure out some of
this formatting.
I dont know any of this much myself, only barely squeezing by to get
the lucene Java releases out.
If anyone wants to help, here is link with a video on how to make
edits and submit them
(http://www.apache.org/dev/cmsref.html#non-committer)
On Wed, Aug 8, 2012 at 11:21 AM, Andi Vajda <va...@apache.org> wrote:
> Since the switch to the new Apache CMS, a year ago, the PyLucene website has been a shameful wreck.
>
> I don't have the spare cycles to spend the time to fix it. Call it an unfunded mandate (timewise).
>
> The good news is that anyone can actually fix it and send in patches to get applied to the public site.
>
> You can either check out the sources or use the interactive interface on the Apache CMS itself.
>
> It would be nice to inherit the look from the main Lucene site as well as its buttons.
>
> See Lucene bug 2748 for details, especially Grant's comment from 06/Aug/2011 22:13.
>
> Clearly, the PyLucene site needs volunteers. It's not a huge task other than the learning curve if battling with css and markdown.
>
> Any takers ?
>
> Andi..
>
> On Aug 8, 2012, at 16:42, "Thomas Koch" <ko...@orbiteam.de> wrote:
>
>> Hi,
>>
>> I'm also running Mac OS now (besides windows still ,-) and was able to build
>> & install PyLucene 3.6.0.2 on MacOS-X (10.7/intel/Python2.7) without any
>> problems - that's the good news.
>>
>>
>>
>> However it was quite difficult for me to get the download files and
>> installation instructions:
>>
>>
>>
>> Download:
>>
>> -------------
>>
>>> From http://lucene.apache.org/pylucene/ there is no visible download link
>> (it even does not contain the word "Download"). There is a hint "Source
>> distributions are available
>> <http://www.apache.org/dyn/closer.cgi/lucene/pylucene/> here." on the main
>> page, below "News", though.
>>
>>
>>
>> The Install page at http://lucene.apache.org/pylucene/install.html has a
>> download link in the news on the bottom of the page:
>>
>> "Lucene can be downloaded from
>> <http://lucene.apache.org/core/mirrors-core-3x-redir.html?>
>> http://lucene.apache.org/core/mirrors-core-3x-redir.html " ,but this page
>> only lists the Java version.
>>
>>
>>
>> In the end I did open this manually "crafted" URL
>> www.apache.org/dyn/closer.cgi/lucene/ and was able to browse to a /pylucene/
>> folder. (because I didn't see the "source dist" hint in the first place).
>>
>>
>>
>> Install:
>>
>> --------
>>
>> On the Install page at http://lucene.apache.org/pylucene/install.html there
>> are broken links:
>>
>> "see JCC's <site:jcc/documentation/install> installation instructions " ->
>> site:jcc/documentation/install
>>
>>
>>
>> The file INSTALL in the distribution says
>>
>> --
>>
>> Please see doc/documentation/install.html or
>>
>> http://lucene.apache.org/pylucene/documentation/install.html
>>
>> --
>>
>> But there is no "doc" directory in the distribution! (Same for README which
>> points to non-existing 'doc/documentation/readme.html' - and the jcc/README
>> and jcc/INSTALL). Possibly the doc-dir just slipped through the build
>> process . (I've seen this directory before)
>>
>>
>>
>> There was some discussion about fixes to the website on the mailing list, so
>> I thought this would be worth mentioning.
>>
>>
>>
>> Note there is a nice download button on the Java Lucene site at
>> lucene.apache.org - that's probably the first thing most devs are looking
>> for ,-)
>>
>>
>>
>>
>>
>> regards
>> Thomas
>>
--
lucidworks.com
Re: PyLucene 3.6 build on MacOS and PyLucene website
Posted by Andi Vajda <va...@apache.org>.
Since the switch to the new Apache CMS, a year ago, the PyLucene website has been a shameful wreck.
I don't have the spare cycles to spend the time to fix it. Call it an unfunded mandate (timewise).
The good news is that anyone can actually fix it and send in patches to get applied to the public site.
You can either check out the sources or use the interactive interface on the Apache CMS itself.
It would be nice to inherit the look from the main Lucene site as well as its buttons.
See Lucene bug 2748 for details, especially Grant's comment from 06/Aug/2011 22:13.
Clearly, the PyLucene site needs volunteers. It's not a huge task other than the learning curve if battling with css and markdown.
Any takers ?
Andi..
On Aug 8, 2012, at 16:42, "Thomas Koch" <ko...@orbiteam.de> wrote:
> Hi,
>
> I'm also running Mac OS now (besides windows still ,-) and was able to build
> & install PyLucene 3.6.0.2 on MacOS-X (10.7/intel/Python2.7) without any
> problems - that's the good news.
>
>
>
> However it was quite difficult for me to get the download files and
> installation instructions:
>
>
>
> Download:
>
> -------------
>
>> From http://lucene.apache.org/pylucene/ there is no visible download link
> (it even does not contain the word "Download"). There is a hint "Source
> distributions are available
> <http://www.apache.org/dyn/closer.cgi/lucene/pylucene/> here." on the main
> page, below "News", though.
>
>
>
> The Install page at http://lucene.apache.org/pylucene/install.html has a
> download link in the news on the bottom of the page:
>
> "Lucene can be downloaded from
> <http://lucene.apache.org/core/mirrors-core-3x-redir.html?>
> http://lucene.apache.org/core/mirrors-core-3x-redir.html " ,but this page
> only lists the Java version.
>
>
>
> In the end I did open this manually "crafted" URL
> www.apache.org/dyn/closer.cgi/lucene/ and was able to browse to a /pylucene/
> folder. (because I didn't see the "source dist" hint in the first place).
>
>
>
> Install:
>
> --------
>
> On the Install page at http://lucene.apache.org/pylucene/install.html there
> are broken links:
>
> "see JCC's <site:jcc/documentation/install> installation instructions " ->
> site:jcc/documentation/install
>
>
>
> The file INSTALL in the distribution says
>
> --
>
> Please see doc/documentation/install.html or
>
> http://lucene.apache.org/pylucene/documentation/install.html
>
> --
>
> But there is no "doc" directory in the distribution! (Same for README which
> points to non-existing 'doc/documentation/readme.html' - and the jcc/README
> and jcc/INSTALL). Possibly the doc-dir just slipped through the build
> process . (I've seen this directory before)
>
>
>
> There was some discussion about fixes to the website on the mailing list, so
> I thought this would be worth mentioning.
>
>
>
> Note there is a nice download button on the Java Lucene site at
> lucene.apache.org - that's probably the first thing most devs are looking
> for ,-)
>
>
>
>
>
> regards
> Thomas
>