mkdocs-texsmith 0.0.2.dev0__tar.gz

mkdocs_texsmith-0.0.2.dev0/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 4
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{md,js,json,css,yml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

mkdocs_texsmith-0.0.2.dev0/.gitignore

@@ -0,0 +1,121 @@
+*~
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+site/
+links.yml
+mkdocs_french/artifacts/morphalou_data.json.gz

mkdocs_texsmith-0.0.2.dev0/.markdownlint.yaml

@@ -0,0 +1,4 @@
+MD046: false # Conflic between code and admonition blocks
+
+MD013:
+  line_length: 1000

mkdocs_texsmith-0.0.2.dev0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Isaac Muse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mkdocs_texsmith-0.0.2.dev0/Makefile

@@ -0,0 +1,19 @@
+# Temporary compatibility mechanism between Poetry and uv.
+# While waiting for full adoption of PEP 751 (the standardized lock format `pylock.toml`),
+# we maintain separate lock files for each tool (`poetry.lock` and `uv.lock`)
+# and also generate a unified `pylock.toml` for future interoperability.
+# This ensures that developers can use either Poetry or uv seamlessly in the same project.
+
+deps:
+	uv sync
+
+deps-poetry:
+	poetry install
+
+lock-all:
+	uv lock
+	poetry lock
+	uv export -o pylock.toml
+	git add pylock.toml
+
+.PHONY: deps deps-poetry lock-all

mkdocs_texsmith-0.0.2.dev0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: mkdocs-texsmith
+Version: 0.0.2.dev0
+Summary: Convert MkDocs documentation to LaTeX PDF.
+Project-URL: Homepage, https://github.com/yves-chevallier/mkdocs-texsmith
+Author-email: Yves Chevallier <yves.chevalier@heig-vd.ch>
+License-Expression: MIT
+License-File: LICENSE.md
+Keywords: convert,extensions,latex,markdown,mkdocs,texsmith
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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-Python: >=3.10
+Requires-Dist: texsmith==0.0.2.dev0
+Description-Content-Type: text/markdown
+
+# MkDocs TeXSmith Plugin
+
+`mkdocs-texsmith` turns any MkDocs project into a set of LaTeX sources ready for high-quality PDF production. The plugin reuses the TeXSmith rendering pipeline to transform the pages that MkDocs renders into TeX, keeping navigation structure, numbering, cross references, and assets in sync.
+
+## Highlights
+
+- Export one or many "books" from the same MkDocs site, each with its own metadata and output folder.
+- Reuse TeXSmith templates or override individual blocks to match your house style.
+- Combine global `.bib` files, per-book bibliographies, inline citations, and DOI lookups into a single bibliography.
+- Copy and prune assets automatically so only referenced images end up in the LaTeX project.
+- Optional HTML snapshots for debugging, plus Material for MkDocs specific tweaks out of the box.
+
+## Installation
+
+```bash
+pip install mkdocs-texsmith
+```
+
+The package targets Python 3.12+. If you manage dependencies with [uv](https://github.com/astral-sh/uv), run:
+
+```bash
+uv add mkdocs-texsmith
+```
+
+## Quick Start
+
+1. Add the plugin to your `mkdocs.yml`.
+
+   ```yaml
+   plugins:
+     - search
+     - texsmith:
+         build_dir: press # where LaTeX sources are written
+         template: book # TeXSmith template to use
+         bibliography:
+           - docs/references.bib
+   ```
+
+2. Build your site as usual:
+
+   ```bash
+   mkdocs build
+   ```
+
+3. The LaTeX project for each configured book is created under `press/`. Compile the resulting `index.tex` with your preferred tool (`latexmk`, `tectonic`, etc.) to produce the PDF.
+
+## Configuration
+
+All plugin options are declared under the `texsmith` plugin entry.
+
+- `enabled` (bool): turns the plugin on or off; automatically disabled during `mkdocs serve`.
+- `build_dir` (str): output root for generated LaTeX projects. Defaults to `press`.
+- `template` (str): default TeXSmith template name. Falls back to `book`.
+- `parser` (str): HTML parser backend used by TeXSmith (`lxml` by default).
+- `copy_assets` (bool): copy images and other assets referenced by the book into the build directory.
+- `clean_assets` (bool): remove unused files from the generated `assets/` folder after rendering.
+- `save_html` (bool): if `true`, store the rendered HTML alongside LaTeX snapshots under `html/`.
+- `language` (str): override auto-detected language for templates and hyphenation.
+- `bibliography` (list[str]): global `.bib` files applied to every book.
+- `books` (list[dict]): per-book configuration (see below).
+- `template_overrides` (dict[str, str]): map of template block names to override files.
+- `register_material` (bool): register Material for MkDocs specific renderers (enabled by default).
+
+### Multiple books
+
+The `books` list lets you export distinct artefacts from the same site. Each entry accepts [`BookConfig`](../../src/texsmith/core/config.py) fields plus book-specific extras (`template`, `template_overrides`, `bibliography`):
+
+```yaml
+plugins:
+  - texsmith:
+      books:
+        - title: "User Guide"
+          root: "Guide"
+          folder: "user-guide"
+          template: book
+          bibliography:
+            - docs/guide.bib
+        - title: "API Reference"
+          root: "Reference"
+          base_level: 2
+          copy_files:
+            docs/appendix/*.tex: backmatter/
+```
+
+If you do not declare any books, the plugin creates one automatically using the first navigation page as the root section.
+
+### Bibliography sources
+
+- Global `bibliography` files apply to every book.
+- Book-level `bibliography` entries augment or override the global list.
+- YAML front matter can declare inline bibliography entries, including DOI links. DOIs are resolved at build time; failures are logged but do not stop the build.
+- Per-book `.bib` files are emitted with the LaTeX project, and an `assets_map.yml` manifest records the asset locations used by the renderer.
+
+### Templates and overrides
+
+TeXSmith templates bundle LaTeX, Jinja, and formatter fragments. Set `template` globally or per book, then override specific fragments via `template_overrides`:
+
+```yaml
+plugins:
+  - texsmith:
+      template: book
+      template_overrides:
+        heading: overrides/heading.j2
+      books:
+        - title: "Whitepaper"
+          template_overrides:
+            cover: overrides/custom_cover.tex.j2
+```
+
+The plugin automatically registers TeXSmith's Material integration when `register_material` is `true`, aligning colors and fonts with the Material theme if you use it.
+
+### Assets and HTML snapshots
+
+- `copy_assets: true` copies images and other referenced files into `<build_dir>/<book>/assets/`.
+- `clean_assets: true` prunes unused files after rendering, keeping the LaTeX project tidy.
+- Enable `save_html` to keep the intermediate HTML for each page under `<build_dir>/<book>/html/`, which helps when troubleshooting rendering issues.
+
+## Development
+
+1. Clone the repository and install dependencies:
+
+   ```bash
+   uv sync
+   ```
+
+2. Run the documentation site locally:
+
+   ```bash
+   uv run mkdocs serve
+   ```
+
+3. Use `pytest` or `uv run pytest` to execute tests before contributing patches.
+
+The repository maintains a `Makefile` shortcut (`make deps`) that mirrors the `uv sync` step.
+
+## License
+
+The project is distributed under the MIT License. See `LICENSE.md` for the full text.

mkdocs_texsmith-0.0.2.dev0/README.md

@@ -0,0 +1,138 @@
+# MkDocs TeXSmith Plugin
+
+`mkdocs-texsmith` turns any MkDocs project into a set of LaTeX sources ready for high-quality PDF production. The plugin reuses the TeXSmith rendering pipeline to transform the pages that MkDocs renders into TeX, keeping navigation structure, numbering, cross references, and assets in sync.
+
+## Highlights
+
+- Export one or many "books" from the same MkDocs site, each with its own metadata and output folder.
+- Reuse TeXSmith templates or override individual blocks to match your house style.
+- Combine global `.bib` files, per-book bibliographies, inline citations, and DOI lookups into a single bibliography.
+- Copy and prune assets automatically so only referenced images end up in the LaTeX project.
+- Optional HTML snapshots for debugging, plus Material for MkDocs specific tweaks out of the box.
+
+## Installation
+
+```bash
+pip install mkdocs-texsmith
+```
+
+The package targets Python 3.12+. If you manage dependencies with [uv](https://github.com/astral-sh/uv), run:
+
+```bash
+uv add mkdocs-texsmith
+```
+
+## Quick Start
+
+1. Add the plugin to your `mkdocs.yml`.
+
+   ```yaml
+   plugins:
+     - search
+     - texsmith:
+         build_dir: press # where LaTeX sources are written
+         template: book # TeXSmith template to use
+         bibliography:
+           - docs/references.bib
+   ```
+
+2. Build your site as usual:
+
+   ```bash
+   mkdocs build
+   ```
+
+3. The LaTeX project for each configured book is created under `press/`. Compile the resulting `index.tex` with your preferred tool (`latexmk`, `tectonic`, etc.) to produce the PDF.
+
+## Configuration
+
+All plugin options are declared under the `texsmith` plugin entry.
+
+- `enabled` (bool): turns the plugin on or off; automatically disabled during `mkdocs serve`.
+- `build_dir` (str): output root for generated LaTeX projects. Defaults to `press`.
+- `template` (str): default TeXSmith template name. Falls back to `book`.
+- `parser` (str): HTML parser backend used by TeXSmith (`lxml` by default).
+- `copy_assets` (bool): copy images and other assets referenced by the book into the build directory.
+- `clean_assets` (bool): remove unused files from the generated `assets/` folder after rendering.
+- `save_html` (bool): if `true`, store the rendered HTML alongside LaTeX snapshots under `html/`.
+- `language` (str): override auto-detected language for templates and hyphenation.
+- `bibliography` (list[str]): global `.bib` files applied to every book.
+- `books` (list[dict]): per-book configuration (see below).
+- `template_overrides` (dict[str, str]): map of template block names to override files.
+- `register_material` (bool): register Material for MkDocs specific renderers (enabled by default).
+
+### Multiple books
+
+The `books` list lets you export distinct artefacts from the same site. Each entry accepts [`BookConfig`](../../src/texsmith/core/config.py) fields plus book-specific extras (`template`, `template_overrides`, `bibliography`):
+
+```yaml
+plugins:
+  - texsmith:
+      books:
+        - title: "User Guide"
+          root: "Guide"
+          folder: "user-guide"
+          template: book
+          bibliography:
+            - docs/guide.bib
+        - title: "API Reference"
+          root: "Reference"
+          base_level: 2
+          copy_files:
+            docs/appendix/*.tex: backmatter/
+```
+
+If you do not declare any books, the plugin creates one automatically using the first navigation page as the root section.
+
+### Bibliography sources
+
+- Global `bibliography` files apply to every book.
+- Book-level `bibliography` entries augment or override the global list.
+- YAML front matter can declare inline bibliography entries, including DOI links. DOIs are resolved at build time; failures are logged but do not stop the build.
+- Per-book `.bib` files are emitted with the LaTeX project, and an `assets_map.yml` manifest records the asset locations used by the renderer.
+
+### Templates and overrides
+
+TeXSmith templates bundle LaTeX, Jinja, and formatter fragments. Set `template` globally or per book, then override specific fragments via `template_overrides`:
+
+```yaml
+plugins:
+  - texsmith:
+      template: book
+      template_overrides:
+        heading: overrides/heading.j2
+      books:
+        - title: "Whitepaper"
+          template_overrides:
+            cover: overrides/custom_cover.tex.j2
+```
+
+The plugin automatically registers TeXSmith's Material integration when `register_material` is `true`, aligning colors and fonts with the Material theme if you use it.
+
+### Assets and HTML snapshots
+
+- `copy_assets: true` copies images and other referenced files into `<build_dir>/<book>/assets/`.
+- `clean_assets: true` prunes unused files after rendering, keeping the LaTeX project tidy.
+- Enable `save_html` to keep the intermediate HTML for each page under `<build_dir>/<book>/html/`, which helps when troubleshooting rendering issues.
+
+## Development
+
+1. Clone the repository and install dependencies:
+
+   ```bash
+   uv sync
+   ```
+
+2. Run the documentation site locally:
+
+   ```bash
+   uv run mkdocs serve
+   ```
+
+3. Use `pytest` or `uv run pytest` to execute tests before contributing patches.
+
+The repository maintains a `Makefile` shortcut (`make deps`) that mirrors the `uv sync` step.
+
+## License
+
+The project is distributed under the MIT License. See `LICENSE.md` for the full text.

mkdocs_texsmith-0.0.2.dev0/docs/about.md

@@ -0,0 +1,3 @@
+# About
+
+This plugin provides a seamless way to convert your MkDocs documentation into a LaTeX document, which can then be compiled into a PDF. It leverages the power of TeXSmith to handle the conversion process, ensuring high-quality output that adheres to LaTeX standards.

mkdocs_texsmith-0.0.2.dev0/docs/images/latex-hummingbird.svg

@@ -0,0 +1,153 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 27.5.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Ebene_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 207.8 120" style="enable-background:new 0 0 207.8 120;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#008080;}
+	.st1{fill:#FFFFFF;}
+	.st2{fill:#FFFFFF;stroke:#FFFFFF;stroke-width:0.4166;stroke-miterlimit:1.9933;}
+	.st3{fill:#37C871;stroke:#FFFFFF;stroke-width:0.4166;stroke-miterlimit:1.9933;}
+</style>
+<g id="layer1" transform="matrix(1.199992,0,0,1.199992,-229.2782,-646.32266)">
+	<g id="g3363" transform="matrix(0.58826838,0,0,-0.58826838,191.06432,638.60215)">
+		<g id="g3365" transform="translate(-131.809,509.294)">
+			<g id="g3367">
+				<g id="g3369">
+					<g id="g3371">
+						<path id="path3373" d="M208.1-347.8c1.9-3.4,3.9-6.4,5.9-8.9l0,0l0,0c-0.9,0.1-1.9,0.2-2.9,0.2c-2,0-4.2-0.4-6.5-1.1
+							c4-3.3,7.4-5.8,10.4-7.7c-0.1,0-0.2,0.1-0.2,0.1l0.2-0.1c-4.6,1.4-9.6,1.6-15.4-1.1c4.2-2.6,7.7-4.5,10.8-6
+							c-0.1,0-0.2,0-0.3,0l0.2-0.1c-4.8,0.8-9.9,0.4-15.3-3.2c3.6-1.6,6.7-2.8,9.4-3.7l0,0l0.2-0.1c-4.6-0.2-9.2-1.6-13.6-5.9
+							c3.9-1,7.2-1.6,10.2-2c-0.1,0-0.2,0-0.2,0c-0.1,0-0.2,0-0.3,0h0.1c-3.4-0.8-6.8-2.5-10.1-5.8c2.7-0.6,5-1,7.2-1.3
+							c-2.7-1.3-5.2-3.3-7.6-6.4c3.1-0.2,5.8-0.3,8.2-0.3c-2.9-1.4-5.7-3.5-8.2-6.9c4.4-0.2,8-0.2,11.2,0c-0.1,0-0.1-0.1-0.2-0.1
+							c-0.2,0-0.4,0-0.6,0l0.3-0.1c-3.3-1.4-6.3-3.8-8.9-7.7c5.4-0.1,9.7,0.2,13.3,0.6c-0.1,0-0.2-0.1-0.3-0.1s-0.3,0-0.4,0h0.2
+							c-4.2-1.3-8.2-3.7-11.4-8.6c4.4-0.1,8,0.1,11.2,0.4c-0.1,0-0.1-0.1-0.2-0.1c-3.8-2.1-7-5.2-9.1-10.6c3.9,0.7,7.1,1.5,9.9,2.3
+							l-0.1-0.1h0.2c-2.9-2.2-5.3-5.2-6.9-9.6c2.7,0.6,5,1.2,7.1,1.8c-1.9-2.3-3.4-5.2-4.2-9c2.9,1.1,5.4,2.1,7.6,3.1
+							c0,0,0-0.1-0.1-0.1l-0.1-0.1h0.1c-2-2.4-3.6-5.5-4.4-9.6c4.1,1.6,7.4,3.2,10.1,4.7c-0.1-0.1-0.2-0.1-0.2-0.2h0.1
+							c-2.5-2.7-4.3-6.2-5-10.9c4.8,2.1,8.5,4.1,11.5,5.9l-0.1-0.1l0.2,0.1c-3.4-2.9-6.1-6.9-7-12.8c6.5,2.8,11,5.4,14.5,7.8
+							c-1.5-3-2.3-6.6-1.9-11c6.2,4.8,10.2,8.6,13.1,12.1v-0.1c-0.2-2.2,0-4.5,0.6-7.1c3.7,6.4,7.4,9,11.2,11.2
+							c-4.7-3-3.9-5.5-3.9-8.3c5.6,5.9,13.4,12.2,15.8,16.1c-3.2-4.8-4.5-9.3-5.3-13.4c-16.3-8.6-26.3-10.9-37.4-14.3
+							c4.3-1.6,9-3.1,7-5.3l-5.1-5.1c3.3,1,6.6,2.5,9.5,0.5c-0.3-2.7-3.7-4-6.6-5.6c5.1,1.8,6.2,1.4,7.5,1c0.7-3.2-1.7-4.9-3.2-7
+							c12.8,9.7,29.5,17.4,41.3,20.6c16.6,5.6,37.9,11.4,43.7,25.5l5.8,23.3c6.8,7.4,13.1,15,16,24.3c19,3.7,34.3,2.4,50.3,1.9
+							c-1.5,0.2-48.8,8.3-48.8,8.3c-13.8,18.9-34.5,6.1-41.3-12.7c-1.7-4.7-11.5-4.7-14.3,0C271.1-382.7,237.1-357.2,208.1-347.8
+							L208.1-347.8L208.1-347.8z"/>
+					</g>
+					<g id="g3375">
+						<path id="path3377" class="st0" d="M207.7-346.4c1.9-3.4,3.9-6.4,6-8.9c-0.9,0.1-1.9,0.2-2.9,0.2c-2,0-4.1-0.4-6.5-1.1
+							c4-3.4,7.5-5.9,10.5-7.8c-4.7,1.5-9.7,1.7-15.6-1.1c4.3-2.7,7.9-4.6,11.1-6.1c-4.9,0.9-10.1,0.5-15.6-3.2
+							c3.7-1.6,6.9-2.9,9.7-3.8c-4.6-0.2-9.2-1.6-13.7-5.9c3.9-1,7.2-1.6,10.2-2c-3.6-0.7-7.1-2.5-10.6-5.9c2.7-0.6,5-1,7.2-1.3
+							c-2.7-1.3-5.2-3.3-7.6-6.4c3.1-0.2,5.8-0.3,8.2-0.4c-2.9-1.4-5.7-3.5-8.2-7c4.4-0.2,8-0.2,11.2,0c-3.5-1.4-6.6-3.8-9.4-7.9
+							c5.4-0.1,9.7,0.2,13.3,0.6c-4.5-1.2-8.6-3.7-12-8.8c4.4-0.1,8,0.1,11.2,0.4c-3.8-2.1-7.1-5.3-9.3-10.7c4,0.7,7.3,1.6,10.1,2.4
+							c-3-2.2-5.5-5.2-7.1-9.8c2.7,0.6,5,1.2,7.1,1.8c-1.9-2.3-3.4-5.2-4.2-9c2.9,1.1,5.4,2.1,7.6,3.1c-2.1-2.5-3.7-5.6-4.5-9.7
+							c4.1,1.6,7.4,3.2,10.1,4.7c-2.5-2.7-4.4-6.2-5.2-11.1c4.9,2.2,8.7,4.2,11.8,6.1c-3.5-3-6.3-6.9-7.2-13
+							c6.5,2.8,11,5.4,14.5,7.8c-1.5-3-2.3-6.6-1.9-11.1c6.2,4.8,10.2,8.7,13.1,12.1c-0.2-2.2,0-4.6,0.6-7.2
+							c4.5,7.7,8.9,9.9,13.5,12.5c-7.3-3.7-6.2-6.5-6.2-9.7c5.6,5.9,13.4,12.1,15.8,16.1c-3.2-4.8-4.5-9.3-5.3-13.3
+							c-16.3-8.6-26.3-10.9-37.4-14.3c4.3-1.6,9-3.1,7-5.3l-5.1-5.1c3.3,1,6.6,2.5,9.5,0.5c-0.3-2.7-3.7-4-6.6-5.6
+							c5.1,1.8,6.2,1.4,7.5,1c0.7-3.2-1.7-4.9-3.2-7.1c12.8,9.7,29.5,17.4,41.3,20.7c16.6,5.6,37.9,11.4,43.7,25.5l5.8,23.3
+							c6.8,7.4,13.1,15,16,24.3c19,3.7,34.3,2.3,50.3,1.9c-1.5,0.2-48.8,8.3-48.8,8.3c-13.8,18.9-34.5,6.1-41.3-12.6
+							c-1.7-4.7-11.5-4.7-14.3,0C270.8-381.3,236.7-355.8,207.7-346.4L207.7-346.4L207.7-346.4z"/>
+					</g>
+					<g id="g3379">
+						<path id="path3381" class="st1" d="M319.6-395.8l-0.1-0.2c-0.5-0.9-1.3-1.5-2.5-1.9s-2.7-0.5-4.4-0.4h-1.1l0.8-0.8
+							c0.4-0.4,0.5-0.7,0.5-1s-0.1-0.6-0.4-0.9c-0.5-0.7-1.6-1.4-2.5-2.1l-0.3-0.2l0.2-0.3c0.8-1.2,1.2-2.2,1.3-2.9
+							c0.1-0.7-0.1-1.3-0.4-1.7c-0.7-0.9-2.2-1.5-3.5-2.3l-0.2-0.1v-0.3c0.1-0.7-0.1-1.3-0.6-1.8c-0.5-0.6-1.3-1.1-2.5-1.6l-0.3-0.1
+							v-0.3c0.2-1.5,0.7-2.8,1.6-3.6c0.9-0.8,2.2-1,3.8-0.6c0.3-1.6,0.7-3.1,1.7-4c1-1,2.5-1.3,4.6-0.7c0.5-1.1,1.1-1.9,1.9-2.4
+							c0.9-0.6,2-0.8,2.9-1.1l0.5,0.6c-0.9,0.3-2.2,0.7-3,1.2c-0.7,0.5-1.3,1.2-1.7,2.3l-0.1,0.4l-0.4-0.1c-2.1-0.7-3.3-0.4-4.1,0.4
+							c-0.8,0.8-1.3,2.3-1.5,4l-0.1,0.4l-0.4-0.1c-1.7-0.5-2.8-0.2-3.5,0.4s-1,1.6-1.3,2.9c1,0.5,1.9,1,2.4,1.6s0.8,1.4,0.7,2.2
+							c1.2,0.7,2.7,1.3,3.6,2.4c0.4,0.6,0.7,1.4,0.6,2.3c-0.1,0.8-0.5,1.8-1.2,3c0.9,0.6,1.8,1.3,2.4,2c0.3,0.4,0.6,0.9,0.6,1.4
+							c0,0.3-0.3,0.6-0.4,0.8c1.5,0,2.9,0.1,4,0.4c1.2,0.4,2.1,1.1,2.8,2.1c1.8,0,3.7-0.4,5.5-0.6c1.9-0.3,3.9-0.3,5.8,0.5l-0.3,0.8
+							c-1.6-0.7-3.4-0.7-5.3-0.4c-1.9,0.2-3.8,0.7-5.8,0.7L319.6-395.8L319.6-395.8z"/>
+					</g>
+					<g id="g3383">
+						<path id="path3385" class="st2" d="M326.6-395.5c0-2-1.6-3.5-3.5-3.5c-2,0-3.5,1.6-3.5,3.5c0,2,1.6,3.5,3.5,3.5
+							S326.6-393.6,326.6-395.5z"/>
+					</g>
+					<g id="g3387">
+						<path id="path3389" class="st1" d="M337.1-392.2c-3.2-4.1-4-3.1-5.9-3.8l-0.3-0.1v-0.3c0.7-4.2,3.2-5.5,5.1-7l0.1,0.3l0.5,0.1
+							c-1.9,1.5-4,2.8-4.8,6.3c1.4,0.3,2.8-0.1,5.8,3.8L337.1-392.2L337.1-392.2z"/>
+					</g>
+					<g id="g3391">
+						<path id="path3393" class="st1" d="M214.8-364c6-3.7,15.9-7.6,22.2-11.6c3.5-2.2,6.6-4.4,9.1-6.4c2.4-1.9,4.2-3.9,4.9-4.5
+							s1.1-0.3,0.7,0.5c-0.4,0.8-2.6,2.8-5.1,4.7c-2.5,1.9-5.6,4.1-9.1,6.4C230.5-370.4,222.2-366.4,214.8-364L214.8-364z"/>
+					</g>
+					<g id="g3395">
+						<path id="path3397" class="st1" d="M213.7-355.3c2.5-0.6,6.2-2.7,10.4-5c4.1-2.3,8.6-5.1,12.8-7.9c4.1-2.7,7.3-5.2,9.8-7.1
+							c2.4-2.1,3.6-3.4,4.1-3.4c0.1,0,0.1,0,0.2,0c0.1,0,0.3,0.1,0.3,0.2c0.1,0.2,0.1,0.3,0,0.4c0,0.1,0,0.1-0.1,0.2
+							c-0.1,0.2-0.3,0.4-0.6,0.7c-0.6,0.6-1.6,1.4-2.9,2.3c-2.6,2-6.3,4.6-10.4,7.4c-4.1,2.8-8.7,5.6-12.8,7.9
+							C223-359,215.7-355.2,213.7-355.3L213.7-355.3L213.7-355.3z"/>
+					</g>
+					<g id="g3399">
+						<path id="path3401" class="st1" d="M210.3-371.2c7.7-3.1,18.7-6.8,26-11.4c3.9-2.5,7.4-5,9.9-7c1.3-1,2.3-1.9,3.1-2.7
+							c0.8-0.7,1.2-1.4,1.5-1.6c0.5-0.4,0.9-0.1,0.7,0.5c-0.2,0.5-0.8,1-1.6,1.7s-1.9,1.7-3.2,2.7c-2.6,2.1-6,4.6-10,7.1
+							C228.8-376.9,219.3-372.4,210.3-371.2L210.3-371.2z"/>
+					</g>
+					<g id="g3403">
+						<path id="path3405" class="st1" d="M204.3-378.2c6,0,18.4-5.5,23.6-8.3c8.5-4.5,16.2-10.3,20.4-14.4c0.5-0.5,1.2-0.1,0.6,0.6
+							c-4,4.6-12.1,10-20.7,14.5C219.8-381.1,211-378.2,204.3-378.2L204.3-378.2z"/>
+					</g>
+					<g id="g3407">
+						<path id="path3409" class="st1" d="M200.9-386.1c9-1.3,19.9-5,27.7-8.9c4.4-2.2,8.3-4.6,11.3-6.7c3-2.1,5.2-4.5,5.8-5.1
+							c0.5-0.6,1.2-0.6,0.7,0.4c-0.5,1.1-3,3.2-6,5.4c-3,2.2-7,4.5-11.4,6.8C220.1-389.7,210-386.2,200.9-386.1L200.9-386.1z"/>
+					</g>
+					<g id="g3411">
+						<path id="path3413" class="st1" d="M203.9-392.8c-2.2,0.2-4.3-0.3-6.3-0.5c8,0.8,19.2-2.9,26.7-6.4
+							c8.8-4.1,16.1-9.8,19.6-13.4c0.5-0.6,0.9,0.2,0.6,0.5c-3.3,4.2-11,9.5-19.9,13.6C217.9-395.8,210.6-393.4,203.9-392.8
+							L203.9-392.8z"/>
+					</g>
+					<g id="g3415">
+						<path id="path3417" class="st1" d="M198.2-400c7.9-0.6,18.5-2.5,25.9-5.9c7.4-3.5,13.1-8,15.9-10.6c0.4-0.4,1.2-0.1,0.6,0.6
+							c-2.6,3-8.6,7.2-16.2,10.7C216.9-401.6,207.7-399.4,198.2-400L198.2-400z"/>
+					</g>
+					<g id="g3419">
+						<path id="path3421" class="st1" d="M205.2-406.6c-1.7,0.1-2.4-0.3-4.1-0.4c5.4-0.2,13.9-1.7,18.6-3.3c6.1-2.1,11.1-5.3,14-7.8
+							c0.6-0.5,1,0.2,0.6,0.6c-2.7,3-8.1,5.9-14.3,8C215.4-407.9,210.2-406.8,205.2-406.6L205.2-406.6z"/>
+					</g>
+					<g id="g3423">
+						<path id="path3425" class="st1" d="M205-414.4c11.5-0.8,18.4-2.8,23.7-7.5c0.4-0.4,1,0.1,0.6,0.6
+							C223.9-415.4,213.1-413.8,205-414.4L205-414.4z"/>
+					</g>
+					<g id="g3427">
+						<path id="path3429" class="st1" d="M213.8-421.2c-3.5,0.3-6.4-0.5-9.5-1.5c9.3,1.5,13.1,0.8,20.1-2.5c0.8-0.4,0.8,0.5,0.4,0.7
+							C221.1-422.3,217.3-421.5,213.8-421.2L213.8-421.2z"/>
+					</g>
+					<g id="g3431">
+						<path id="path3433" class="st1" d="M213.5-427.7c-3.3-0.3-6.1-1.4-8.4-3.3c9.2,3.5,11.7,2.8,18.7,0.8c0.9-0.3,0.6,0.6,0.3,0.8
+							C219.9-427.7,216.8-427.4,213.5-427.7L213.5-427.7z"/>
+					</g>
+					<g id="g3435">
+						<path id="path3437" class="st1" d="M231.7-433.4c-4.9,0.5-10.4-0.1-15.2-0.9c-4.8-0.9-9-2.7-11.3-4.6c8,3.4,9.5,3.4,11.5,3.8
+							c4.8,0.9,9.5,1.2,15,0.9C232.1-434.2,232.1-433.4,231.7-433.4L231.7-433.4z"/>
+					</g>
+					<g id="g3439">
+						<path id="path3441" class="st1" d="M234.5-437.3c-5.3,0.2-10.8-1.1-15.5-2.5c-4.7-1.4-8.3-3.2-10.6-5.1
+							c4.7,2.3,9.1,3.8,10.8,4.3c4.7,1.3,9.4,2.5,15.3,2.4C235-438.2,235.3-437.4,234.5-437.3L234.5-437.3z"/>
+					</g>
+					<g id="g3443">
+						<path id="path3445" class="st1" d="M238.8-440.6c-5-0.7-10.2-2.2-14.8-3.8c-4.6-1.5-7.8-3.4-9.9-5.6c5.4,3.1,8.4,4.2,10.2,4.8
+							c4.5,1.5,8.7,2.6,14.7,3.7C239.7-441.3,239.1-440.5,238.8-440.6L238.8-440.6z"/>
+					</g>
+					<g id="g3447">
+						<path id="path3449" class="st1" d="M241.4-444.7c-10-1.6-16.5-5.9-20.6-10.2c6.4,4.8,10.8,7.4,20.8,9.4
+							C242.2-445.4,242-444.6,241.4-444.7L241.4-444.7z"/>
+					</g>
+					<g id="g3451">
+						<path id="path3453" class="st1" d="M246.3-448.4c-10.1-1.6-15.9-7.7-18.3-11.7c6.4,6.4,11.3,9.8,18.5,10.9
+							C247.2-449.1,247-448.3,246.3-448.4L246.3-448.4z"/>
+					</g>
+					<g id="g3455">
+						<path id="path3457" class="st1" d="M249.3-451.6c-1.6-0.2-3.7-1.3-5.7-2.6c-2-1.3-3.5-2.8-4.5-4.9c2.4,2.5,3.4,3.2,4.9,4.2
+							c1.9,1.2,3.9,2,5.5,2.5C250.2-452.2,249.7-451.5,249.3-451.6L249.3-451.6z"/>
+					</g>
+					<g id="g3459">
+						<path id="path3461" class="st2" d="M326.6-395.5c0-2-1.6-3.5-3.5-3.5c-2,0-3.5,1.6-3.5,3.5c0,2,1.6,3.5,3.5,3.5
+							S326.6-393.6,326.6-395.5z"/>
+					</g>
+					<g id="g3463">
+						<path id="path3465" class="st3" d="M326.6-395.5c0-2-1.6-3.5-3.5-3.5c-2,0-3.5,1.6-3.5,3.5c0,2,1.6,3.5,3.5,3.5
+							S326.6-393.6,326.6-395.5z"/>
+					</g>
+				</g>
+			</g>
+		</g>
+	</g>
+</g>
+</svg>

mkdocs_texsmith-0.0.2.dev0/docs/index.md

@@ -0,0 +1,18 @@
+# MkDocs LaTeX Plugin
+
+This Plugin uses behind-the-scenes TeXSmith to convert your MkDocs documentation into a beautiful PDF document.
+
+## Features
+
+- Convert your entire MkDocs site into a single PDF file.
+- Support for custom LaTeX templates.
+- Automatic handling of images and links.
+- Configurable options for page size, margins, and fonts.
+
+## Installation
+
+To install the MkDocs LaTeX Plugin, use pip:
+
+```bash
+pip install mkdocs-latex
+```

mkdocs_texsmith-0.0.2.dev0/hatch_build.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from hatchling.metadata.plugin.interface import MetadataHookInterface
+
+
+class CustomMetadataHook(MetadataHookInterface):
+    """Inject dynamic metadata for mkdocs-texsmith."""
+
+    def update(self, metadata: dict) -> None:
+        # Keep the plugin in lockstep with the main texsmith package version.
+        version = str(metadata["version"])
+        metadata["dependencies"] = [f"texsmith=={version}"]