You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@freemarker.apache.org by Daniel Dekany <dd...@freemail.hu> on 2015/12/05 13:57:00 UTC
Re: Improve search on freemarker.org
BTW, the Google Custom Search still behaves rather strangely. Like if
I repeat the original experiment, searching for "Using FreeMarker with
servlets" with quotation marks, now it only gives one hit,
http://freemarker.incubator.apache.org/docs/xgui_declarative.html,
which doesn't even contain that expression. I don't know what's wrong
with it... maybe the domain change has driven it crazy? (I have asked
Infra to make freemarker.org canonical about 2 weeks ago, but there's
no reaction so far.)
--
Thanks,
Daniel Dekany
Sunday, November 29, 2015, 6:59:07 AM, Lee wrote:
> I fixed the issue where the search box doesn't get prepopulated. I also
> upgraded some of the npm packages. If you are on an old version of NodeJS,
> you should upgrade (should be at least 0.12.4)
>
> On Sat, Nov 28, 2015 at 9:19 PM, Lee <ev...@gmail.com> wrote:
>
>> Cool, thanks! Ivy is working now : )
>>
>> On Sat, Nov 28, 2015 at 4:45 PM, Daniel Dekany <dd...@freemail.hu>
>> wrote:
>>
>>> BTW, you can now update the site by committing into the "asf-site"
>>> branch of the "site" repo. As you will see when you check it out, it
>>> contains the files on the web server as is.
>>>
>>>
>>> Sunday, November 29, 2015, 1:36:32 AM, Daniel Dekany wrote:
>>>
>>> > I have fixed the Ivy repo checksum issue (was a CRLF VS LF problem).
>>> > Delete docgen/.ivy and try again!
>>> >
>>> >
>>> > Saturday, November 28, 2015, 7:48:12 PM, Lee wrote:
>>> >
>>> >> I'm looking at it right now actually...
>>> >>
>>> >> Also, I can't get docgen to build on my windows machine:
>>> >>
>>> >>
>>> >> [ivy:retrieve]
>>> >> [ivy:retrieve] :: problems summary ::
>>> >> [ivy:retrieve] :::: WARNINGS
>>> >> [ivy:retrieve] problem while downloading module descriptor:
>>> >>
>>> http://freemarker.org/repos/ivy/org.freemarker/freemarker/ivy-2.3-branch-head.xml:
>>> invalid sha1: ex
>>> >> pected=fc7faac4643441acd716abe4f05f635d813c2b74
>>> >> computed=41ac97d45442e9b4cdda55f221d3c47b329159e2 (1084ms)
>>> >> [ivy:retrieve] module not found:
>>> >> org.freemarker#freemarker;2.3-branch-head
>>> >> [ivy:retrieve] ==== freemarker-devel-webserver: tried
>>> >> [ivy:retrieve]
>>> >>
>>> http://freemarker.org/repos/ivy/org.freemarker/freemarker/ivy-2.3-branch-head.xml
>>> >> [ivy:retrieve] ::::::::::::::::::::::::::::::::::::::::::::::
>>> >> [ivy:retrieve] :: UNRESOLVED DEPENDENCIES ::
>>> >> [ivy:retrieve] ::::::::::::::::::::::::::::::::::::::::::::::
>>> >> [ivy:retrieve] ::
>>> >> org.freemarker#freemarker;2.3-branch-head: not found
>>> >> [ivy:retrieve] ::::::::::::::::::::::::::::::::::::::::::::::
>>> >> [ivy:retrieve]
>>> >> [ivy:retrieve]
>>> >> [ivy:retrieve] :: USE VERBOSE OR DEBUG MESSAGE LEVEL FOR MORE DETAILS
>>> >>
>>> >> On Sat, Nov 28, 2015 at 1:51 AM, Daniel Dekany <dd...@freemail.hu>
>>> wrote:
>>> >> Something is off with Google Custom Search... maybe it's a local or
>>> >> temporal issue, I don't know.
>>> >>
>>> >> As an experiment, try to search for "Using FreeMarker with servlets"
>>> >> with quotation marks(!). For me, it won't find the page whose title
>>> >> that is. Instead it finds a dozen of pages where that expression
>>> >> occurs in the side ToC (which ideally should not be considered at
>>> >> all). On the same time, plain Google gives the desired page as first
>>> >> hit.
>>> >>
>>> >> Also, now I get JavaDoc hits mixed with Manual hits, despite of what I
>>> >> have experienced earlier (no search in JavaDoc). It's not necessarily
>>> >> bad, I just didn't know that we have changed this... did we?
>>> >>
>>> >> --
>>> >> Thanks,
>>> >> Daniel Dekany
>>> >>
>>> >>
>>> >> Saturday, November 21, 2015, 9:49:29 AM, Daniel Dekany wrote:
>>> >>
>>> >>> In practice I have found some problems with search on freemarker.org:
>>> >>>
>>> >>> - I can't search in the API java docs.
>>> >>>
>>> >>> - When I search in the Manual, I often also want hits from the API
>>> >>> JavaDocs, though getting them wouldn't be logical because of the
>>> >>> structure of the site.
>>> >>>
>>> >>> - There's no search box on the Home tab. People my not realize that
>>> >>> there's on on the Manual tab.
>>> >>>
>>> >>> So I think we need a global search box, which by default searches in
>>> >>> the Manual and in the JavaDocs too. It would be a plus if it has
>>> >>> "API" and "Manual" check boxes. So that would address all the point
>>> >>> above.
>>> >>>
>>> >>> Where to put the global search box (layout...) is a trickier
>>> >>> question. Certainly the Contribut-Report-Download thing had to go
>>> >>> away to give space to it, but instead perhaps we could make them
>>> >>> more apparent in the side menu (with some icons or whatever). And
>>> >>> then on the Manual there will be a void in place of search... I
>>> >>> don't know. Can you figure out something awesome?
>>> >>>
>>> >>> - The search box is no re-filled after search, so I can't refine my
>>> >>> search.
>>> >>>
>>> >>
>>> >>
>>> >
>>>
>>> --
>>> Thanks,
>>> Daniel Dekany
>>>
>>>
>>
---
This email has been checked for viruses by Avast antivirus software.
https://www.avast.com/antivirus
Re: Improve search on freemarker.org
Posted by Daniel Dekany <dd...@freemail.hu>.
Thanks, it seems to work now!
We have this issue that the left-side menu is indexed. I'm not sure if
that can be solved though. I hope Google at least gives it a very low
weight.
Wednesday, December 9, 2015, 10:45:03 PM, Lee wrote:
> Fixed! I needed to update the url... also I need to transfer the search.
> It's still using the key that only I own, as opposed to both of us.
>
> It's going to return results from `freemarker.incubator.apache.org` btw
> (that was one of the issues)
>
> On Sat, Dec 5, 2015 at 4:57 AM, Daniel Dekany <dd...@freemail.hu> wrote:
>
>> BTW, the Google Custom Search still behaves rather strangely. Like if
>> I repeat the original experiment, searching for "Using FreeMarker with
>> servlets" with quotation marks, now it only gives one hit,
>> http://freemarker.incubator.apache.org/docs/xgui_declarative.html,
>> which doesn't even contain that expression. I don't know what's wrong
>> with it... maybe the domain change has driven it crazy? (I have asked
>> Infra to make freemarker.org canonical about 2 weeks ago, but there's
>> no reaction so far.)
>>
>> --
>> Thanks,
>> Daniel Dekany
>>
>>
>> Sunday, November 29, 2015, 6:59:07 AM, Lee wrote:
>>
>> > I fixed the issue where the search box doesn't get prepopulated. I also
>> > upgraded some of the npm packages. If you are on an old version of
>> NodeJS,
>> > you should upgrade (should be at least 0.12.4)
>> >
>> > On Sat, Nov 28, 2015 at 9:19 PM, Lee <ev...@gmail.com> wrote:
>> >
>> >> Cool, thanks! Ivy is working now : )
>> >>
>> >> On Sat, Nov 28, 2015 at 4:45 PM, Daniel Dekany <dd...@freemail.hu>
>> >> wrote:
>> >>
>> >>> BTW, you can now update the site by committing into the "asf-site"
>> >>> branch of the "site" repo. As you will see when you check it out, it
>> >>> contains the files on the web server as is.
>> >>>
>> >>>
>> >>> Sunday, November 29, 2015, 1:36:32 AM, Daniel Dekany wrote:
>> >>>
>> >>> > I have fixed the Ivy repo checksum issue (was a CRLF VS LF problem).
>> >>> > Delete docgen/.ivy and try again!
>> >>> >
>> >>> >
>> >>> > Saturday, November 28, 2015, 7:48:12 PM, Lee wrote:
>> >>> >
>> >>> >> I'm looking at it right now actually...
>> >>> >>
>> >>> >> Also, I can't get docgen to build on my windows machine:
>> >>> >>
>> >>> >>
>> >>> >> [ivy:retrieve]
>> >>> >> [ivy:retrieve] :: problems summary ::
>> >>> >> [ivy:retrieve] :::: WARNINGS
>> >>> >> [ivy:retrieve] problem while downloading module descriptor:
>> >>> >>
>> >>>
>> http://freemarker.org/repos/ivy/org.freemarker/freemarker/ivy-2.3-branch-head.xml
>> :
>> >>> invalid sha1: ex
>> >>> >> pected=fc7faac4643441acd716abe4f05f635d813c2b74
>> >>> >> computed=41ac97d45442e9b4cdda55f221d3c47b329159e2 (1084ms)
>> >>> >> [ivy:retrieve] module not found:
>> >>> >> org.freemarker#freemarker;2.3-branch-head
>> >>> >> [ivy:retrieve] ==== freemarker-devel-webserver: tried
>> >>> >> [ivy:retrieve]
>> >>> >>
>> >>>
>> http://freemarker.org/repos/ivy/org.freemarker/freemarker/ivy-2.3-branch-head.xml
>> >>> >> [ivy:retrieve]
>> ::::::::::::::::::::::::::::::::::::::::::::::
>> >>> >> [ivy:retrieve] :: UNRESOLVED DEPENDENCIES
>> ::
>> >>> >> [ivy:retrieve]
>> ::::::::::::::::::::::::::::::::::::::::::::::
>> >>> >> [ivy:retrieve] ::
>> >>> >> org.freemarker#freemarker;2.3-branch-head: not found
>> >>> >> [ivy:retrieve]
>> ::::::::::::::::::::::::::::::::::::::::::::::
>> >>> >> [ivy:retrieve]
>> >>> >> [ivy:retrieve]
>> >>> >> [ivy:retrieve] :: USE VERBOSE OR DEBUG MESSAGE LEVEL FOR MORE
>> DETAILS
>> >>> >>
>> >>> >> On Sat, Nov 28, 2015 at 1:51 AM, Daniel Dekany <ddekany@freemail.hu
>> >
>> >>> wrote:
>> >>> >> Something is off with Google Custom Search... maybe it's a local or
>> >>> >> temporal issue, I don't know.
>> >>> >>
>> >>> >> As an experiment, try to search for "Using FreeMarker with servlets"
>> >>> >> with quotation marks(!). For me, it won't find the page whose title
>> >>> >> that is. Instead it finds a dozen of pages where that expression
>> >>> >> occurs in the side ToC (which ideally should not be considered at
>> >>> >> all). On the same time, plain Google gives the desired page as first
>> >>> >> hit.
>> >>> >>
>> >>> >> Also, now I get JavaDoc hits mixed with Manual hits, despite of
>> what I
>> >>> >> have experienced earlier (no search in JavaDoc). It's not
>> necessarily
>> >>> >> bad, I just didn't know that we have changed this... did we?
>> >>> >>
>> >>> >> --
>> >>> >> Thanks,
>> >>> >> Daniel Dekany
>> >>> >>
>> >>> >>
>> >>> >> Saturday, November 21, 2015, 9:49:29 AM, Daniel Dekany wrote:
>> >>> >>
>> >>> >>> In practice I have found some problems with search on
>> freemarker.org:
>> >>> >>>
>> >>> >>> - I can't search in the API java docs.
>> >>> >>>
>> >>> >>> - When I search in the Manual, I often also want hits from the API
>> >>> >>> JavaDocs, though getting them wouldn't be logical because of the
>> >>> >>> structure of the site.
>> >>> >>>
>> >>> >>> - There's no search box on the Home tab. People my not realize that
>> >>> >>> there's on on the Manual tab.
>> >>> >>>
>> >>> >>> So I think we need a global search box, which by default
>> searches in
>> >>> >>> the Manual and in the JavaDocs too. It would be a plus if it has
>> >>> >>> "API" and "Manual" check boxes. So that would address all the
>> point
>> >>> >>> above.
>> >>> >>>
>> >>> >>> Where to put the global search box (layout...) is a trickier
>> >>> >>> question. Certainly the Contribut-Report-Download thing had to go
>> >>> >>> away to give space to it, but instead perhaps we could make them
>> >>> >>> more apparent in the side menu (with some icons or whatever). And
>> >>> >>> then on the Manual there will be a void in place of search... I
>> >>> >>> don't know. Can you figure out something awesome?
>> >>> >>>
>> >>> >>> - The search box is no re-filled after search, so I can't refine my
>> >>> >>> search.
>> >>> >>>
>> >>> >>
>> >>> >>
>> >>> >
>> >>>
>> >>> --
>> >>> Thanks,
>> >>> Daniel Dekany
>> >>>
>> >>>
>> >>
>>
>>
>> ---
>> This email has been checked for viruses by Avast antivirus software.
>> https://www.avast.com/antivirus
>>
>>
--
Thanks,
Daniel Dekany
---
This email has been checked for viruses by Avast antivirus software.
https://www.avast.com/antivirus
Re: Improve search on freemarker.org
Posted by Lee <ev...@gmail.com>.
Fixed! I needed to update the url... also I need to transfer the search.
It's still using the key that only I own, as opposed to both of us.
It's going to return results from `freemarker.incubator.apache.org` btw
(that was one of the issues)
On Sat, Dec 5, 2015 at 4:57 AM, Daniel Dekany <dd...@freemail.hu> wrote:
> BTW, the Google Custom Search still behaves rather strangely. Like if
> I repeat the original experiment, searching for "Using FreeMarker with
> servlets" with quotation marks, now it only gives one hit,
> http://freemarker.incubator.apache.org/docs/xgui_declarative.html,
> which doesn't even contain that expression. I don't know what's wrong
> with it... maybe the domain change has driven it crazy? (I have asked
> Infra to make freemarker.org canonical about 2 weeks ago, but there's
> no reaction so far.)
>
> --
> Thanks,
> Daniel Dekany
>
>
> Sunday, November 29, 2015, 6:59:07 AM, Lee wrote:
>
> > I fixed the issue where the search box doesn't get prepopulated. I also
> > upgraded some of the npm packages. If you are on an old version of
> NodeJS,
> > you should upgrade (should be at least 0.12.4)
> >
> > On Sat, Nov 28, 2015 at 9:19 PM, Lee <ev...@gmail.com> wrote:
> >
> >> Cool, thanks! Ivy is working now : )
> >>
> >> On Sat, Nov 28, 2015 at 4:45 PM, Daniel Dekany <dd...@freemail.hu>
> >> wrote:
> >>
> >>> BTW, you can now update the site by committing into the "asf-site"
> >>> branch of the "site" repo. As you will see when you check it out, it
> >>> contains the files on the web server as is.
> >>>
> >>>
> >>> Sunday, November 29, 2015, 1:36:32 AM, Daniel Dekany wrote:
> >>>
> >>> > I have fixed the Ivy repo checksum issue (was a CRLF VS LF problem).
> >>> > Delete docgen/.ivy and try again!
> >>> >
> >>> >
> >>> > Saturday, November 28, 2015, 7:48:12 PM, Lee wrote:
> >>> >
> >>> >> I'm looking at it right now actually...
> >>> >>
> >>> >> Also, I can't get docgen to build on my windows machine:
> >>> >>
> >>> >>
> >>> >> [ivy:retrieve]
> >>> >> [ivy:retrieve] :: problems summary ::
> >>> >> [ivy:retrieve] :::: WARNINGS
> >>> >> [ivy:retrieve] problem while downloading module descriptor:
> >>> >>
> >>>
> http://freemarker.org/repos/ivy/org.freemarker/freemarker/ivy-2.3-branch-head.xml
> :
> >>> invalid sha1: ex
> >>> >> pected=fc7faac4643441acd716abe4f05f635d813c2b74
> >>> >> computed=41ac97d45442e9b4cdda55f221d3c47b329159e2 (1084ms)
> >>> >> [ivy:retrieve] module not found:
> >>> >> org.freemarker#freemarker;2.3-branch-head
> >>> >> [ivy:retrieve] ==== freemarker-devel-webserver: tried
> >>> >> [ivy:retrieve]
> >>> >>
> >>>
> http://freemarker.org/repos/ivy/org.freemarker/freemarker/ivy-2.3-branch-head.xml
> >>> >> [ivy:retrieve]
> ::::::::::::::::::::::::::::::::::::::::::::::
> >>> >> [ivy:retrieve] :: UNRESOLVED DEPENDENCIES
> ::
> >>> >> [ivy:retrieve]
> ::::::::::::::::::::::::::::::::::::::::::::::
> >>> >> [ivy:retrieve] ::
> >>> >> org.freemarker#freemarker;2.3-branch-head: not found
> >>> >> [ivy:retrieve]
> ::::::::::::::::::::::::::::::::::::::::::::::
> >>> >> [ivy:retrieve]
> >>> >> [ivy:retrieve]
> >>> >> [ivy:retrieve] :: USE VERBOSE OR DEBUG MESSAGE LEVEL FOR MORE
> DETAILS
> >>> >>
> >>> >> On Sat, Nov 28, 2015 at 1:51 AM, Daniel Dekany <ddekany@freemail.hu
> >
> >>> wrote:
> >>> >> Something is off with Google Custom Search... maybe it's a local or
> >>> >> temporal issue, I don't know.
> >>> >>
> >>> >> As an experiment, try to search for "Using FreeMarker with servlets"
> >>> >> with quotation marks(!). For me, it won't find the page whose title
> >>> >> that is. Instead it finds a dozen of pages where that expression
> >>> >> occurs in the side ToC (which ideally should not be considered at
> >>> >> all). On the same time, plain Google gives the desired page as first
> >>> >> hit.
> >>> >>
> >>> >> Also, now I get JavaDoc hits mixed with Manual hits, despite of
> what I
> >>> >> have experienced earlier (no search in JavaDoc). It's not
> necessarily
> >>> >> bad, I just didn't know that we have changed this... did we?
> >>> >>
> >>> >> --
> >>> >> Thanks,
> >>> >> Daniel Dekany
> >>> >>
> >>> >>
> >>> >> Saturday, November 21, 2015, 9:49:29 AM, Daniel Dekany wrote:
> >>> >>
> >>> >>> In practice I have found some problems with search on
> freemarker.org:
> >>> >>>
> >>> >>> - I can't search in the API java docs.
> >>> >>>
> >>> >>> - When I search in the Manual, I often also want hits from the API
> >>> >>> JavaDocs, though getting them wouldn't be logical because of the
> >>> >>> structure of the site.
> >>> >>>
> >>> >>> - There's no search box on the Home tab. People my not realize that
> >>> >>> there's on on the Manual tab.
> >>> >>>
> >>> >>> So I think we need a global search box, which by default
> searches in
> >>> >>> the Manual and in the JavaDocs too. It would be a plus if it has
> >>> >>> "API" and "Manual" check boxes. So that would address all the
> point
> >>> >>> above.
> >>> >>>
> >>> >>> Where to put the global search box (layout...) is a trickier
> >>> >>> question. Certainly the Contribut-Report-Download thing had to go
> >>> >>> away to give space to it, but instead perhaps we could make them
> >>> >>> more apparent in the side menu (with some icons or whatever). And
> >>> >>> then on the Manual there will be a void in place of search... I
> >>> >>> don't know. Can you figure out something awesome?
> >>> >>>
> >>> >>> - The search box is no re-filled after search, so I can't refine my
> >>> >>> search.
> >>> >>>
> >>> >>
> >>> >>
> >>> >
> >>>
> >>> --
> >>> Thanks,
> >>> Daniel Dekany
> >>>
> >>>
> >>
>
>
> ---
> This email has been checked for viruses by Avast antivirus software.
> https://www.avast.com/antivirus
>
>