Security News
Introducing the Socket Python SDK
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
github.com/quarto-ext/lightbox
An extension that uses the GLightbox javascript library to add lightbox styling and behavior to images in your HTML documents.
To install this extension in your current directory (or into the Quarto project that you're currently working in), use the following command:
quarto install extension quarto-ext/lightbox
The Lightbox extension is implemented as a filter in Quarto. Once installed, using the extension is easy.
The Lightbox extension can automatically give images in your web page a lightbox treatment. You can enable this like:
---
title: Simple Lightbox Example
filters:
- lightbox
lightbox: auto
---
![A Lovely Image](mv-1.jpg)
You can exclude an image from receiving this automatic treatment by giving it a nolightbox
class, like so:
![Don't lightbox me!](mv-1.jpg){.nolightbox}
lightbox
to the list of filters in your _quarto.yml
file or your document front matter. For example:---
title: Simple Lightbox Example
filters:
- lightbox
---
lightbox
to any images that you'd like to have the lightbox treatment. For example:---
title: Simple Lightbox Example
filters:
- lightbox
---
![A Lovely Image](mv-1.jpg){.lightbox}
In addition to simply providing a lightbox treatment for individual images, you can also group images into a 'gallery'. When the user activates the lightbox, they will be able to page through the images in the gallery without returning to the main document. To create galleries of images, apply a group
attribute (with a name) to the images that you'd like to gather into a gallery. Images with the same group name will be placed together in a gallery when given a lightbox treatment.
For example, the following three images will be treated as a gallery:
![A Lovely Image](mv-1.jpg){group="my-gallery"}
![Another Lovely Image](mv-2.jpg){group="my-gallery"}
![The Last Lovely Image](mv-3.jpg){group="my-gallery"}
The following options may be specified in the front matter for lightbox:
Option | Description |
---|---|
match | Set this to auto if you'd like any image to be given lightbox treatment. If you omit this, only images with the class lightbox will be given the lightbox treatment. |
effect | The effect that should be used when opening and closing the lightbox. One of fade , zoom , none . Defaults to zoom . |
desc-position | The position of the title and description when displaying a lightbox. One of top , bottom , left , right . Defaults to bottom . |
loop | Whether galleries should 'loop' to first image in the gallery if the user continues past the last image of the gallery. Boolean that defaults to true . |
css-class | A class name to apply to the lightbox to allow css targeting. This will replace the lightbox class with your custom class name. |
A complete example:
---
title: Complete Lightbox Example
filters:
- lightbox
lightbox:
match: auto
effect: fade
desc-position: right
loop: false
css-class: "my-css-class"
---
The following options may be specified as attributes on individual images to control the lightbox behavior:
Option | Description |
---|---|
desc-position | The position of the title and description when displaying a lightbox. One of top , bottom , left , right . Defaults to bottom |
Here is the source code for a minimal example: example.qmd
This is the output of example.qmd.
FAQs
Unknown package
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
Security News
Floating dependency ranges in npm can introduce instability and security risks into your project by allowing unverified or incompatible versions to be installed automatically, leading to unpredictable behavior and potential conflicts.
Security News
A new Rust RFC proposes "Trusted Publishing" for Crates.io, introducing short-lived access tokens via OIDC to improve security and reduce risks associated with long-lived API tokens.