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/11/21 09:49:29 UTC
Improve search on freemarker.org
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
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
>
>
Re: Improve search on freemarker.org
Posted by Daniel Dekany <dd...@freemail.hu>.
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 Lee <ev...@gmail.com>.
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
>>
>>
>
Re: Improve search on freemarker.org
Posted by Lee <ev...@gmail.com>.
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
>
>
Re: Improve search on freemarker.org
Posted by Daniel Dekany <dd...@freemail.hu>.
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
Re: Improve search on freemarker.org
Posted by Daniel Dekany <dd...@freemail.hu>.
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
Re: Improve search on freemarker.org
Posted by Lee <ev...@gmail.com>.
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.
> >
>
>
Re: Improve search on freemarker.org
Posted by Daniel Dekany <dd...@freemail.hu>.
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.
>
Re: Improve search on freemarker.org
Posted by Lee <ev...@gmail.com>.
Excellent!
On Sun, Nov 22, 2015 at 12:51 AM, Daniel Dekany <dd...@freemail.hu> wrote:
> Sunday, November 22, 2015, 9:30:49 AM, Lee wrote:
>
> > For the homepage we could add a search link that opens when the
> > user clicks on it... then on the manual we could add the checkboxes
> > when the user focuses on the search box. (These are just a quick
> > sketch, the design would look more polished when finished)
>
> Sounds good!
>
> --
> Thanks,
> Daniel Dekany
>
>
> > I can also fix the search box not being refilled, too
> >
> > On Sat, Nov 21, 2015 at 12:49 AM, Daniel Dekany <dd...@freemail.hu>
> 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
>
>
Re: Improve search on freemarker.org
Posted by Daniel Dekany <dd...@freemail.hu>.
Sunday, November 22, 2015, 9:30:49 AM, Lee wrote:
> For the homepage we could add a search link that opens when the
> user clicks on it... then on the manual we could add the checkboxes
> when the user focuses on the search box. (These are just a quick
> sketch, the design would look more polished when finished)
Sounds good!
--
Thanks,
Daniel Dekany
> I can also fix the search box not being refilled, too
>
> On Sat, Nov 21, 2015 at 12:49 AM, Daniel Dekany <dd...@freemail.hu> 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