{"id":18565316,"url":"https://github.com/pelican-plugins/tipue-search","last_synced_at":"2025-07-27T08:05:45.746Z","repository":{"id":52542664,"uuid":"291841637","full_name":"pelican-plugins/tipue-search","owner":"pelican-plugins","description":"DEPRECATED — SEE README. Serialize generated HTML content to a JS variable for use by the Tipue static search jQuery plugin","archived":false,"fork":false,"pushed_at":"2024-06-17T23:12:12.000Z","size":43,"stargazers_count":3,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-10T19:04:47.322Z","etag":null,"topics":["jquery-plugin","pelican","pelican-plugins","static-search","tipue-search"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pelican-plugins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-31T22:53:10.000Z","updated_at":"2024-11-02T05:45:30.000Z","dependencies_parsed_at":"2023-02-16T16:16:15.738Z","dependency_job_id":"bb65cf8a-44c5-479c-bc1d-1fb501795b5c","html_url":"https://github.com/pelican-plugins/tipue-search","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pelican-plugins/tipue-search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftipue-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftipue-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftipue-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftipue-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pelican-plugins","download_url":"https://codeload.github.com/pelican-plugins/tipue-search/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftipue-search/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267327534,"owners_count":24069442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-27T02:00:11.917Z","response_time":82,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jquery-plugin","pelican","pelican-plugins","static-search","tipue-search"],"created_at":"2024-11-06T22:18:29.680Z","updated_at":"2025-07-27T08:05:45.716Z","avatar_url":"https://github.com/pelican-plugins.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tipue-search: A Plugin for Pelican\n\n\u003e :warning: **Instead of this plugin, please use the [Pelican Search](https://github.com/pelican-plugins/search) plugin.**\n\n\u003e :warning: This plugin, and the jQuery code upon which it depends, **is abandoned and no longer maintained.**\n\nThis repository will eventually be deleted. The relevant code is archived in the [Legacy Plugin Repository](https://github.com/getpelican/pelican-plugins/tree/master/tipue_search).\n\n\n## Purpose\n\nSerialize generated HTML content to a JS variable for use by the Tipue static search jQuery plugin.\n\n\n## Installation\n\nThis plugin can be installed via:\n\n    python -m pip install -e \"git+https://github.com/getpelican/pelican-plugins/#egg=pelican-tipue-search\u0026subdirectory=tipue_search\"\n\n\n## Why do you need it?\n\nStatic sites do not offer search feature out of the box. [Tipue Search](https://web.archive.org/web/20200703134724/https://tipue.com/search/)\nis a jQuery plugin that search the static site without using any third party service, like DuckDuckGo or Google.\n\nTipue search requires the textual content of site in a JS variable.\n\n\n## How Tipue Search works\n\nTipue Search serializes the generated HTML into JSON and saves it into a JS variable. Format of JSON is as follows\n\n```javascript\nvar tipuesearch = {\n    \"pages\": [\n        {\n            \"text\": \"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla quis sem at nibh elementum imperdiet. Duis sagittis ipsum. Praesent mauris. Fusce nec tellus sed augue semper porta. Mauris massa. Vestibulum lacinia arcu eget nulla. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Curabitur sodales ligula in libero.\",\n            \"tags\": \"Example Category\",\n            \"url\" : \"http://oncrashreboot.com/plugin-example.html\",\n            \"title\": \"Everything you want to know about Lorem Ipsum\"\n        },\n        {\n            \"text\": \"Sed dignissim lacinia nunc. Curabitur tortor. Pellentesque nibh. Aenean quam. In scelerisque sem at dolor. Maecenas mattis. Sed convallis tristique sem. Proin ut ligula vel nunc egestas porttitor. Morbi lectus risus, iaculis vel, suscipit quis, luctus non, massa. Fusce ac turpis quis ligula lacinia aliquet. Mauris ipsum. Nulla metus metus, ullamcorper vel, tincidunt sed, euismod in, nibh.\",\n            \"tags\": \"Example Category\",\n            \"url\" : \"http://oncrashreboot.com/plugin-example-2.html\",\n            \"title\": \"Review of the book Lorem Ipsum\"\n        }\n    ]\n};\n```\n\nJS variable is written to file `tipuesearch_content.js` which is created in the root of `output` directory.\n\n\n## How to use\n\nYour theme needs to have Tipue Search properly configured in it. [Official documentation](https://web.archive.org/web/20200703134724/https://tipue.com/search/help/) has the required details.\n\nIn addition to the instructions from Tipue, the following has to be added in `pelicanconf.py`.\n\n```python\nPLUGIN_PATH = 'plugins'\nPLUGINS = ['tipue_search']\nDIRECT_TEMPLATES = ['index', 'tags', 'categories', 'authors', 'archives', 'search']\n```\n\nFurthermore, the generated JavaScript variable has to be sourced in the relevant HTML pages.\n\n```html\n\u003cscript src=\"{{ SITEURL }}tipuesearch_content.js\"\u003e\u003c/script\u003e\n```\n\nPelican [Plumage theme](https://github.com/kdeldycke/plumage) has Tipue Search configured. Check out its code to understand the configuration.\n\n\n## Backward Compatibility\n\nThis plugin requires Tipue Search Version 7.0 or higher.\n\nTipue used to expect content in a JSON file. Around Version 7.0, Tipue maintainers made a switch to JavaScript variable. tipue_search plugin was updated to reflect this change in commit `4a5f171fc`. Latest version of tipue_search plugin will not work with older versions of Tipue Search.\n\nIf you are using older Tipue Search, prior to 7.0 release, then you will find old version of tipue_search plugin in commit `2dcdca8c8`.\n\n\n## Source Archive\n\nThe Tipue Search project itself seems to have been long abandoned. There is no\nlonger any official canonical reference of source code or documentation. There\nonly some artifacts left that were archived by the community:\n\n* [Archived Tipue Search homepage](https://web.archive.org/web/20200703134724/https://tipue.com/search/)\n* [Archived Tipue plugin help page](https://web.archive.org/web/20200703134724/https://tipue.com/search/help/)\n* [Archived Tipue Search code v7.1](https://web.archive.org/web/20200703134724/https://www.tipue.com/search/tipuesearch.zip)\n* [GitHub repository copy](https://notabug.org/jorgesumle/Tipue-Search)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpelican-plugins%2Ftipue-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpelican-plugins%2Ftipue-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpelican-plugins%2Ftipue-search/lists"}