{"id":15978921,"url":"https://github.com/phrozenbyte/pico-excerpt","last_synced_at":"2025-03-16T14:42:51.665Z","repository":{"id":57041107,"uuid":"138503200","full_name":"PhrozenByte/pico-excerpt","owner":"PhrozenByte","description":"This is Pico's official plugin to create page excerpts. Pico is a stupidly simple, blazing fast, flat file CMS.","archived":false,"fork":false,"pushed_at":"2018-06-24T21:29:18.000Z","size":7,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-23T02:11:52.323Z","etag":null,"topics":["abandoned","deprecated","excerpts","pico","pico-excerpt","picocms","picocms-plugin"],"latest_commit_sha":null,"homepage":"http://picocms.org/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PhrozenByte.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-06-24T17:46:18.000Z","updated_at":"2022-10-02T23:51:54.000Z","dependencies_parsed_at":"2022-08-23T23:30:42.019Z","dependency_job_id":null,"html_url":"https://github.com/PhrozenByte/pico-excerpt","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhrozenByte%2Fpico-excerpt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhrozenByte%2Fpico-excerpt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhrozenByte%2Fpico-excerpt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhrozenByte%2Fpico-excerpt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PhrozenByte","download_url":"https://codeload.github.com/PhrozenByte/pico-excerpt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243885888,"owners_count":20363644,"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","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":["abandoned","deprecated","excerpts","pico","pico-excerpt","picocms","picocms-plugin"],"created_at":"2024-10-07T23:40:21.879Z","updated_at":"2025-03-16T14:42:51.645Z","avatar_url":"https://github.com/PhrozenByte.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Pico Excerpt\n============\n\nThis is the repository of Pico's official `PicoExcerpt` plugin.\n\nPico is a stupidly simple, blazing fast, flat file CMS. See http://picocms.org/ for more info.\n\n**This plugin exists for historic reasons only and should not be used!**\n\n`PicoExcerpt` is a simple plugin that creates excperts of all your pages and makes them available using `{{ page.excerpt }}`. Installing this plugin is **highly discouraged**, because it depends on Pico's official [`PicoParsePagesContent` plugin][PicoParsePagesContent], that has a significant negative impact on your website's performance.\n\nThe main reason Pico started parsing the Markdown contents of all pages (see `PicoParsePagesContent`), was the desire for automatically generated page excerpts. We later realized that this is the wrong approach and started searching for alternatives - and we think we found a better solution. We recommend to part from the concept of automatically generated excerpts. Instead, you should use the `Description` meta header to write excerpts on your own. Starting with Pico 1.0 you can use `%meta.*%` placeholders in your Markdown files, so you don't have to repeat yourself - simply add `%meta.description%` to the page content and Pico will replace it with your excerpt.\n\nBy popular request we removed parsing the Markdown contents of all pages with Pico 1.0. This significantly improved Pico's performance. To preserve backwards compatibility (BC) we introduced the `PicoParsePagesContent` and `PicoExcerpt` plugins. Both plugins have been removed from Pico's default installation with Pico 2.0, but you can still install them manually.\n\nInstall\n-------\n\nIf you're using a `composer`-based installation of Pico (e.g. [`picocms/pico-composer`][PicoComposer]), simply open a shell on your server, navigate to Pico's install directory (e.g. `/var/www/html`) and run `composer require phrozenbyte/pico-excerpt` (via [Packagist.org][]). That's it!\n\nIf you're rather using one of [Pico's pre-built release packages][PicoRelease], you must install the [`PicoParsePagesContent` plugin][PicoParsePagesContent] first. After you've installed `PicoParsePagesContent`, create a empty `plugins/PicoExcerpt` directory in Pico's install directory (e.g. `/var/www/html`) on your server. Then download [`PicoExcerpt`'s latest source package][PicoPluginRelease] and upload all containing files (esp. `PicoExcerpt.php`) into said `plugins/PicoExcerpt` directory (resulting in `plugins/PicoExcerpt/PicoExcerpt.php`).\n\n`PicoExcerpt` requires Pico 1.0+\n\nConfig\n------\n\n`PicoExcerpt` is disabled by default due to the significant negative performance impact of the required `PicoParsePagesContent` plugin. You can enable the plugin by adding the following to your `config/config.yml`:\n\n```yml\nPicoExcerpt.enabled: true\n```\n\n`PicoExcerpt` itself has no config options.\n\n[PicoComposer]: https://github.com/picocms/pico-composer\n[Packagist.org]: https://packagist.org/packages/phrozenbyte/pico-excerpt\n[PicoRelease]: https://github.com/picocms/Pico/releases/latest\n[PicoPluginRelease]: https://github.com/PhrozenByte/pico-excerpt/releases/latest\n[PicoParsePagesContent]: https://github.com/PhrozenByte/pico-parse-pages-content\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphrozenbyte%2Fpico-excerpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphrozenbyte%2Fpico-excerpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphrozenbyte%2Fpico-excerpt/lists"}