OpusVL / perldoc.perl.org

perldoc.perl.org website
27 stars 10 forks source link

Consider moving to using Google search, instead of client-side search? #149

Open rspier opened 4 years ago

rspier commented 4 years ago

https://cse.google.com/cse?cx=9b3be95fffc4e30ab is a CSE that just searches perldoc.perl.org

Example searches:

Ways to use it:

<script async src="https://cse.google.com/cse.js?cx=9b3be95fffc4e30ab"></script>
<div class="gcse-search"></div>
<script async src="https://cse.google.com/cse.js?cx=9b3be95fffc4e30ab"></script>
<div class="gcse-searchresults-only"></div>
rspier commented 4 years ago

This would be another way to fix issue #148. @PaulGWebster

Grinnz commented 4 years ago

It would be an improvement over the current broken setup, but far from ideal, since google does not understand the nuances of versioned documentation or perl symbols. http://blogs.perl.org/users/grinnz/2019/06/searching-perldocs.html

rspier commented 4 years ago

As I demonstrated, it's trivial to restrict it to a version. There are also ways of using annotations or contexts (I do t remember which one) to do it in an official way. I have some other examples of this, if someone is going to actually dig into it.

Perl symbols are hard in any system.