search

mosra / m.css

A no-nonsense, no-JavaScript CSS framework, site and documentation theme for content-oriented websites
https://mcss.mosra.cz
MIT License
399 stars 88 forks source link

Adding search, for an m.css newbie #234

Closed maphew closed 1 year ago

maphew commented 1 year ago

I see a number of issues and PR in m.css github related to search functionality but I haven't found anything in the docs yt about how to turn it on or configure it. (It's not a listed plugin for example.) Where do I get started? Are the discussions here referring to the official plugin or something else?

I've gotten some results following https://github.com/pelican-plugins/search but I'm not happy with the search box placement I have. I'm not sure where in m.css/.../templates/base.html it should go or even if that's the right file to be using.

mosra commented 1 year ago

Hi, the search functionality is currently limited to Python and Doxygen documentation generators, not the Pelican theme.

In particular, it was designed mainly for searching symbols / API names by a prefix, not for a fulltext search in general prose content. I can imagine it could work for searching page / article / section titles, but even that would be probably useless in practice.

maphew commented 1 year ago

Ah, ok. Thanks for the background. I'll close this for now, since I've run into other problems to deal with, and come back and open this when I'm ready to participate in figuring it out.