semvec/pypi-packages huggingface dataset:
mkdocs-media-gallery-plugin 1.0.0
MkDocs plugin providing media galleries with shortcodes
Requires Python: >=3.8
Keywords: mkdocs, image, gallery

# MKDOCS Media Galleries 

MkDocs plugin for that adds image and YouTube galleries with shortcodes.

## Install

```bash
pip install mkdocs-media-gallery-plugin
```

## Configure (mkdocs.yml)

```yaml
plugins:
  - search
  - media-gallery:
      images_path: images            # relative to docs_dir
      youtube_links_path: youtube-links.yaml  # relative to docs_dir
      generate_category_pages: true  # auto-generate one page per category
```

## Shortcodes in Markdown

- `{{ gallery_preview }}`: Shows preview tiles for each category (folder under images_path)
- `{{ gallery_full category="cats" }}`: Shows full gallery for the given category
- `{{ youtube_gallery }}`: Renders YouTube gallery from YAML (optionally `category="..."`)

## YouTube data (docs/youtube-links.yaml)

```yaml
# Either flat list
- https://www.youtube.com/watch?v=ZucM9aw6Qlo
- sHfe3nT5-jk

# Or categorized
Music:
- https://www.youtube.com/watch?v=mEK0owuRoks
Shows:
- https://www.youtube.com/watch?v=ZucM9aw6Qlo
```
obsidian-to-typst 0.2.2
Convert Obsidian vault documents to typst and pdfs
Requires Python: <3.14,>=3.11

# Obsidian to Typst

This utility attempts to make it easy to convert markdown documents written using obsidian into PDFs.

## Requirements

- typst
- mermaid
- mutool

## Getting Started

This project uses python [poetry](https://python-poetry.org/).  Follow the [intallation instructions](https://python-poetry.org/docs/#installation) for poetry.

Install typst using a package manager or `cargo install`

Run `poetry install` and `poetry shell` to install and and activate the python virtual environment.

Than, run `obsidian_to_typst .\examples\feature_guide\Widget.md` to convert the example document to a PDF.  The PDF will be placed in `.\examples\feature_guide\output\Widget.pdf`.

```powershell
watchexec --clear=clear --exts py "uv run ruff format && uv run ruff check --fix && uv run pytest && uv run obsidian-to-typst ./examples/feature_guide/Widget.md"
```