# A Quarto Reader for Pelican
[](https://github.com/lmuenter/pelican-quarto/actions)
[](https://pypi.org/project/lm-pelican-quarto/)
[](https://pypi.org/project/lm-pelican-quarto/)
This plugin integrates Quarto with Pelican, allowing you to render interactive reports and high-quality documents directly within your Pelican-generated static website.
## Features
- **Seamless Integration**: Automatically read and render Quarto Markdown (`.qmd`) files found in Pelican's content directory, making it easy to use Quarto with your existing Pelican setup.
- **Interactive Content**: Easily present dynamic and interactive elements like charts, tables, and other visualizations within Pelican pages, enhancing the interactivity and engagement of your content.
- **Quarto Asset Management**: Utilizes Quarto’s asset management system, consolidating JavaScript, stylesheets, and other assets into a single `<output>/site_libs/` directory for efficient loading and maintenance.
## Installation
You can install the Pelican-Quarto plugin using pip:
```bash
pip install lm-pelican-quarto
```
After installation, add `lm_pelican_quarto` to your `PLUGINS` list in your Pelican settings file. For more detailed instructions, refer to the [How to Use Plugins](https://docs.getpelican.com/en/latest/plugins.html#how-to-use-plugins) section in the Pelican documentation.
## Usage
Once integrated, Pelican-Quarto will automatically process Quarto Markdown (`.qmd`) files present in your content directory. During the build process, Pelican will:
1. Use the Quarto CLI to render `.qmd` files into HTML.
2. Generate necessary assets and place them in the `<output>/site_libs/` directory.
3. Merge Quarto-generated HTML into Pelican's HTML structure, ensuring that your site maintains a consistent look and feel.
This seamless process allows you to leverage Quarto's advanced content capabilities with minimal configuration or manual intervention.
## Customization
Pelican-Quarto will generate a `_quarto.yml` configuration file at the root of your content directory. You can customize this file to suit your specific needs. For more details on customization options, please refer to the [Quarto Documentation](https://quarto.org/docs/projects/quarto-projects.html).
### Quarto Pre-configuration
Pelican-Quarto employs a minimalist Quarto setup to simplify integration with Pelican. By default, it uses Quarto’s `Website` project type to minimize additional asset files in your output directory. You are free to experiment with different themes, enable or disable specific Quarto features, and further customize your Quarto environment.
## Dependencies
This plugin requires Quarto to be installed and accessible in your system's PATH. Ensure that you have [downloaded and installed Quarto](https://quarto.org/docs/download/) before using this plugin.
## Current Limitations
Pelican-Quarto is currently under active development. Some planned features include:
- Enhanced customization options via Pelican settings, allowing users to specify more detailed Quarto configurations directly from their Pelican setup.
## Contributing
Contributions to Pelican-Quarto are welcome and greatly appreciated. Whether it’s improving documentation, adding new features, or fixing bugs, every contribution helps. You can also contribute by reviewing and providing feedback on [existing issues][existing issues].
To get started with contributing, please refer to the [Contributing to Pelican][Contributing to Pelican] guide, particularly the **Contributing Code** section.
[existing issues]: https://github.com/lmuenter/pelican-quarto/issues
[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html
## License
This project is licensed under the MIT License.
Raw data
{
"_id": null,
"home_page": null,
"name": "lm-pelican-quarto",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8.1",
"maintainer_email": null,
"keywords": "python, R, Quarto, data science, Rmarkdown, ggplot2, tidyverse, dplyr",
"author": null,
"author_email": "Lukas Muenter <lukas.muenter@protonmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d3/c9/0699a751347b308608bf0395ba20e9fbb365e8bf887b2e9eb93dbbfcad7c/lm_pelican_quarto-0.3.0.tar.gz",
"platform": null,
"description": "# A Quarto Reader for Pelican\n\n[](https://github.com/lmuenter/pelican-quarto/actions)\n[](https://pypi.org/project/lm-pelican-quarto/)\n[](https://pypi.org/project/lm-pelican-quarto/)\n\n\nThis plugin integrates Quarto with Pelican, allowing you to render interactive reports and high-quality documents directly within your Pelican-generated static website.\n\n## Features\n\n- **Seamless Integration**: Automatically read and render Quarto Markdown (`.qmd`) files found in Pelican's content directory, making it easy to use Quarto with your existing Pelican setup.\n\n- **Interactive Content**: Easily present dynamic and interactive elements like charts, tables, and other visualizations within Pelican pages, enhancing the interactivity and engagement of your content.\n\n- **Quarto Asset Management**: Utilizes Quarto\u2019s asset management system, consolidating JavaScript, stylesheets, and other assets into a single `<output>/site_libs/` directory for efficient loading and maintenance.\n\n## Installation\n\nYou can install the Pelican-Quarto plugin using pip:\n\n```bash\npip install lm-pelican-quarto\n```\n\nAfter installation, add `lm_pelican_quarto` to your `PLUGINS` list in your Pelican settings file. For more detailed instructions, refer to the [How to Use Plugins](https://docs.getpelican.com/en/latest/plugins.html#how-to-use-plugins) section in the Pelican documentation.\n\n## Usage\n\nOnce integrated, Pelican-Quarto will automatically process Quarto Markdown (`.qmd`) files present in your content directory. During the build process, Pelican will:\n\n1. Use the Quarto CLI to render `.qmd` files into HTML.\n2. Generate necessary assets and place them in the `<output>/site_libs/` directory.\n3. Merge Quarto-generated HTML into Pelican's HTML structure, ensuring that your site maintains a consistent look and feel.\n\nThis seamless process allows you to leverage Quarto's advanced content capabilities with minimal configuration or manual intervention.\n\n## Customization\n\nPelican-Quarto will generate a `_quarto.yml` configuration file at the root of your content directory. You can customize this file to suit your specific needs. For more details on customization options, please refer to the [Quarto Documentation](https://quarto.org/docs/projects/quarto-projects.html).\n\n### Quarto Pre-configuration\n\nPelican-Quarto employs a minimalist Quarto setup to simplify integration with Pelican. By default, it uses Quarto\u2019s `Website` project type to minimize additional asset files in your output directory. You are free to experiment with different themes, enable or disable specific Quarto features, and further customize your Quarto environment.\n\n## Dependencies\n\nThis plugin requires Quarto to be installed and accessible in your system's PATH. Ensure that you have [downloaded and installed Quarto](https://quarto.org/docs/download/) before using this plugin.\n\n## Current Limitations\n\nPelican-Quarto is currently under active development. Some planned features include:\n\n- Enhanced customization options via Pelican settings, allowing users to specify more detailed Quarto configurations directly from their Pelican setup.\n\n## Contributing\n\nContributions to Pelican-Quarto are welcome and greatly appreciated. Whether it\u2019s improving documentation, adding new features, or fixing bugs, every contribution helps. You can also contribute by reviewing and providing feedback on [existing issues][existing issues].\n\nTo get started with contributing, please refer to the [Contributing to Pelican][Contributing to Pelican] guide, particularly the **Contributing Code** section.\n\n[existing issues]: https://github.com/lmuenter/pelican-quarto/issues\n[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html\n\n## License\n\nThis project is licensed under the MIT License.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A plugin for integrating Quarto reports in your Pelican articles.",
"version": "0.3.0",
"project_urls": {
"Funding": "https://donate.getpelican.com/",
"Homepage": "https://github.com/lmuenter/pelican-quarto",
"Issue tracker": "https://github.com/lmuenter/pelican-quarto/issues"
},
"split_keywords": [
"python",
" r",
" quarto",
" data science",
" rmarkdown",
" ggplot2",
" tidyverse",
" dplyr"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "253bbd806cbeab3424d1cb454583093f0ae597a0452b7c231e9a3a3d6372f94a",
"md5": "8be9595706ecd84e665c094ccd7d10a8",
"sha256": "8260cc7f37d541814b4060d8cfc85a51976efbb00f5823b86bd58cc6e6759267"
},
"downloads": -1,
"filename": "lm_pelican_quarto-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8be9595706ecd84e665c094ccd7d10a8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8.1",
"size": 9463,
"upload_time": "2024-09-04T17:11:45",
"upload_time_iso_8601": "2024-09-04T17:11:45.381169Z",
"url": "https://files.pythonhosted.org/packages/25/3b/bd806cbeab3424d1cb454583093f0ae597a0452b7c231e9a3a3d6372f94a/lm_pelican_quarto-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d3c90699a751347b308608bf0395ba20e9fbb365e8bf887b2e9eb93dbbfcad7c",
"md5": "ec5d46d4d3290566537fb428788743ad",
"sha256": "5e5a92c9e286e1ae9d8e1c7c521f1641612b90946347df066e299b2e251704fa"
},
"downloads": -1,
"filename": "lm_pelican_quarto-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "ec5d46d4d3290566537fb428788743ad",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8.1",
"size": 9453,
"upload_time": "2024-09-04T17:11:46",
"upload_time_iso_8601": "2024-09-04T17:11:46.590845Z",
"url": "https://files.pythonhosted.org/packages/d3/c9/0699a751347b308608bf0395ba20e9fbb365e8bf887b2e9eb93dbbfcad7c/lm_pelican_quarto-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-04 17:11:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lmuenter",
"github_project": "pelican-quarto",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "lm-pelican-quarto"
}
JSON
