Metadata-Version: 2.3
Name: mkdocs-macros-utils
Version: 0.0.8
Summary: mkdocs-macros-utils is a mkdocs-macros-plugin based project that provides macros to extend cards, code blocks, etc, in MkDocs documents.
Author: 7rikazhexde
Author-email: 33836132+7rikazhexde@users.noreply.github.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: jinja2 (>=3.0.0)
Requires-Dist: mkdocs-macros-plugin (>=1.3.7,<2.0.0)
Requires-Dist: mkdocs-material (>=9.6.1,<10.0.0)
Requires-Dist: pygments (>=2.19.1)
Requires-Dist: requests (>=2.25.0)
Project-URL: Documentation, https://7rikazhexde.github.io/mkdocs-macros-utils/
Project-URL: Homepage, https://github.com/7rikazhexde/mkdocs-macros-utils
Project-URL: Repository, https://github.com/7rikazhexde/mkdocs-macros-utils
Description-Content-Type: text/markdown

# mkdocs-macros-utils

[mkdocs-macros-utils](https://7rikazhexde.github.io/mkdocs-macros-utils/) is [mkdocs-macros-plugin](https://mkdocs-macros-plugin.readthedocs.io/en/latest/) based project that provides macros to extend cards, code blocks, etc, in MkDocs documents.

[![pages-build-deployment](https://github.com/7rikazhexde/mkdocs-macros-utils/actions/workflows/pages/pages-build-deployment/badge.svg?branch=gh-pages)](https://github.com/7rikazhexde/mkdocs-macros-utils/actions/workflows/pages/pages-build-deployment) [![DOCS](https://img.shields.io/badge/Docs-Click%20Here-blue?colorA=24292e&colorB=0366d6&logo=github)](https://7rikazhexde.github.io/mkdocs-macros-utils/)

## Features

- **Link Card**: Create link cards with images and descriptions, etc
- **Gist Code Block**: Embed and syntax-highlight code from GitHub Gists
- **X/Twitter Card**: Embed tweets with proper styling and dark mode support

## Usage

### Install `mkdocs-macros-utils`

```bash
# For pip
pip install mkdocs-macros-utils

# For poetry
poetry add mkdocs-macros-utils
```

### Config settings

1. Add the plugin to your `mkdocs.yml`

    ```yaml
    plugins:
      - macros:
          modules: [mkdocs_macros_utils]

    markdown_extensions:
      - attr_list
      - md_in_html

    extra:
      debug:
        link_card: false  # Set to true for debug logging
        gist_codeblock: false
        x_twitter_card: false

    extra_css:
      - stylesheets/macros-utils/link-card.css
      - stylesheets/macros-utils/gist-cb.css
      - stylesheets/macros-utils/x-twitter-link-card.css

    extra_javascript:
      - javascripts/macros-utils/x-twitter-widget.js
    ```

1. Start the development server

    ```bash
    poetry run mkdocs serve
    ```

The plugin will automatically create the required directories and copy CSS/JS files during the build process.

## Documentation

For detailed usage and examples, please see the [documentation](https://7rikazhexde.github.io/mkdocs-macros-utils/).

## License

MIT License - see the [LICENSE](./LICENCE) file for details.

