Skip to main content

A plugin for integrating Quarto reports in your Pelican articles.

Project description

A Quarto Reader for Pelican

Build Status PyPI Version Downloads License

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:

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 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.

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 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.

To get started with contributing, please refer to the Contributing to Pelican guide, particularly the Contributing Code section.

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lm_pelican_quarto-0.4.0.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

lm_pelican_quarto-0.4.0-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file lm_pelican_quarto-0.4.0.tar.gz.

File metadata

  • Download URL: lm_pelican_quarto-0.4.0.tar.gz
  • Upload date:
  • Size: 9.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for lm_pelican_quarto-0.4.0.tar.gz
Algorithm Hash digest
SHA256 891cdc74c8b0b87384d7f691f1f12419fa90718777fa1efa82ec1c195ec41159
MD5 02e2967b102b31e7ef03dc9e3829701e
BLAKE2b-256 623d8d3d300466874042c497a238da30a88e837a40b9424e4c532ab4f2f6a0b0

See more details on using hashes here.

Provenance

File details

Details for the file lm_pelican_quarto-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for lm_pelican_quarto-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 02a72593b09650c6b3d513a6b8ce26ab8ea2e603d1fd2659fe5d34dd71b0e5c0
MD5 256675efe4164689b5337400ded3109d
BLAKE2b-256 7a0d0782063989dccec18bf93155c75b3027a8a84c625136038ade729d8811dc

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page