{"id":22288687,"url":"https://github.com/amaurycarrade/grav-plugin-zmarkdown-engine","last_synced_at":"2025-03-25T21:19:58.000Z","repository":{"id":145950167,"uuid":"137796036","full_name":"AmauryCarrade/grav-plugin-zmarkdown-engine","owner":"AmauryCarrade","description":"Brings the ZMarkdown engine to Grav","archived":false,"fork":false,"pushed_at":"2022-11-21T14:09:35.000Z","size":50,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-30T18:38:37.356Z","etag":null,"topics":["grav","grav-plugin","markdown-engine","zds","zmarkdown","zmarkdown-engine","zmarkdown-server"],"latest_commit_sha":null,"homepage":null,"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/AmauryCarrade.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"2018-06-18T19:18:02.000Z","updated_at":"2022-11-20T19:18:30.000Z","dependencies_parsed_at":"2023-12-20T22:45:13.383Z","dependency_job_id":null,"html_url":"https://github.com/AmauryCarrade/grav-plugin-zmarkdown-engine","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmauryCarrade%2Fgrav-plugin-zmarkdown-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmauryCarrade%2Fgrav-plugin-zmarkdown-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmauryCarrade%2Fgrav-plugin-zmarkdown-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmauryCarrade%2Fgrav-plugin-zmarkdown-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AmauryCarrade","download_url":"https://codeload.github.com/AmauryCarrade/grav-plugin-zmarkdown-engine/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245543426,"owners_count":20632648,"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":["grav","grav-plugin","markdown-engine","zds","zmarkdown","zmarkdown-engine","zmarkdown-server"],"created_at":"2024-12-03T17:06:22.173Z","updated_at":"2025-03-25T21:19:57.993Z","avatar_url":"https://github.com/AmauryCarrade.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZMarkdown Engine Plugin\n\nThe **ZMarkdown Engine** Plugin is for [Grav CMS](http://github.com/getgrav/grav). Allows to use the [ZMarkdown engine](https://github.com/zestedesavoir/zmarkdown) to parse the markdown.\n\n**Warning**: this plugin does not include zmarkdown: it must be installed separately.\n\n## Installation\n\nInstalling the zmarkdown engine plugin can be done in one of two ways. The GPM (Grav Package Manager) installation method enables you to quickly and easily install the plugin with a simple terminal command, while the manual method enables you to do so via a zip file.\n\n### GPM Installation (Preferred)\n\nThe simplest way to install this plugin is via the [Grav Package Manager (GPM)](http://learn.getgrav.org/advanced/grav-gpm) through your system's terminal (also called the command line). From the root of your Grav installation, type:\n\n    bin/gpm install zmarkdown-engine\n\nThis will install the zmarkdown engine plugin into your `/user/plugins` directory within Grav. Its files can be found under `/your/site/grav/user/plugins/zmarkdown-engine`.\n\n### Manual Installation\n\nTo install this plugin, just download the zip version of this repository and unzip it under `/your/site/grav/user/plugins`. Then, rename the folder to `zmarkdown-engine`. You can find these files on [GitHub](https://github.com/Nebulius/grav-plugin-zmarkdown-engine) or via [GetGrav.org](http://getgrav.org/downloads/plugins#extras).\n\nYou should now have all the plugin files under\n\n    /your/site/grav/user/plugins/zmarkdown-engine\n\t\n\u003e NOTE: This plugin is a modular component for Grav which requires [Grav](http://github.com/getgrav/grav) and the [Error](https://github.com/getgrav/grav-plugin-error) and [Problems](https://github.com/getgrav/grav-plugin-problems) to operate.\n\n### Admin Plugin\n\nIf you use the admin plugin, you can install directly through the admin plugin by browsing the `Plugins` tab and clicking on the `Add` button.\n\n### ZMarkdown installation\n\nYou can install zmarkdown in any way, but a simple one is [to use NPM](https://www.npmjs.com/package/zmarkdown):\n\n```bash\nmkdir zmarkdown\ncd zmarkdown\nnpm install zmarkdown\nnpm run server\n```\n\nYou can also [deploy zmarkdown with Ansible](https://zestedesavoir.com/billets/3928/integrer-zmarkdown-a-laravel-avec-ansible/) (in French).\n\n## Configuration\n\nBefore configuring this plugin, you should copy the `user/plugins/zmarkdown-engine/zmarkdown-engine.yaml` to `user/config/plugins/zmarkdown-engine.yaml` and only edit that copy.\n\nHere is the default configuration and an explanation of available options:\n\n```yaml\nenabled: true\nzmd_server: http://127.0.0.1:27272\n```\n\nThe `zmd_server` option must contain a link to the root of the zmarkdown engine server, with the port and without trailing slash. Hint: the default port is 27272.\n\nNote that if you use the admin plugin, a file with your configuration, and named zmarkdown-engine.yaml will be saved in the `user/config/plugins/` folder once the configuration is saved in the admin.\n\n## Usage\n\nFor this plugin to work, you must have a ZMarkdown server running and accessible from Grav's backend. Then, fill the `zmd_server` configuration option (using the Admin plugin or the yml file). Now, the engine is ready to run.\n\nThe last thing to do is to tell Grav (and this plugin) to actually use this engine. To do so, you can either enable it globally, by disabling the `markdown` processor and adding a new `zmarkdown` set to `true`, in the `system.yaml` file, as below:\n\n```yaml\npages:\n  # ...\n  process:\n    markdown: false\n    twig: false\n    zmarkdown: true\n```\n\n…or configure it per page by adding something like this in the page's frontmatter.\n\n```yaml\nprocess:\n    zmarkdown: true\n    markdown: false\n    twig: false\n```\n\nIf you use the admin plugin, you'll be able to change that using the page or system configuration forms—a “zmarkdown” option is added to the _Process_ fields in both system config and page forms.\n\nYou can use Twig and zmarkdown processing at the same time, but not Markdown and zmarkdown. If both are enabled, Grav Markdown will take precedence.\n\n## Credits\n\nThis plugin uses (obviously) the [zmarkdown engine](https://github.com/zestedesavoir/zmarkdown), initially developed for Zeste de Savoir. Also, thanks to the developers of [SimpleHTMLDOM](http://simplehtmldom.sourceforge.net/), used to backport images and links processing to zmarkdown.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famaurycarrade%2Fgrav-plugin-zmarkdown-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famaurycarrade%2Fgrav-plugin-zmarkdown-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famaurycarrade%2Fgrav-plugin-zmarkdown-engine/lists"}