The PreTeXt Guide

Create an account with Google (GMail, YouTube, etc.) and make sure you are signed in.

Visit GCSE⁷ and add a new search engine via New Search Engine.

Provide a URL for the top-level domain name/directory for your book/document. Everything below this will be indexed. We have taken some care to mark knowl content in a way compatible with the search facility, but there is more work to do here.

Give the engine a GCSE-specific name, so you can tell later which one it is when you have several.

Under Edit Search Engine in the Basics tab locate Search engine ID which has a string that uniquely identifies your new search engine. Save this, you’ll need to make it part of your PreTeXt document.

Under the Users tab add co-authors or trusted backup personnel.

Fiddle with Edit Search Engine > Look and Feel at your own risk! Only the defaults are tested and supported.

Provisions for removing advertisements for non-profit sites seem to have changed. If your university already contracts with Google, you should investigate having a “SuperAdmin” at your institution so this setup for you, and make you a trusted collaborator. Then it should be an easy matter to turn off advertisements.

Because these sign-ups are dependent on your site, this is a publisher activity, and hence configured with the publication file (Section 26.1), see Subsection 44.4.11 for details.

The search/@google-cx attribute will alert the PreTeXt conversion and fully enable and implement search. You are done, and everything should just work. You should see a Google-branded search box to the top right of each of your pages. (We have no control over the branding.)

Time to rebuild your HTML output and make the improved version available.