docs: enable external link icons and new window behavior in Quarto co… #92

	name: Publish Quarto docs

	on:
	workflow_dispatch:

	push:
	branches:
	- main

	permissions:
	contents: write
	pages: write

	jobs:
	build-and-deploy:
	runs-on: ubuntu-latest
	strategy:
	fail-fast: false
	matrix:
	python-version: ["3.12"]

	steps:
	- uses: actions/checkout@v4

	- name: Set up Python ${{ matrix.python-version }}
	uses: actions/setup-python@v5
	with:
	python-version: ${{ matrix.python-version }}

	- name: Install and configure Poetry
	uses: snok/install-poetry@v1
	with:
	virtualenvs-create: true
	virtualenvs-in-project: true
	installer-parallel: true

	- name: Load cached venv
	uses: actions/cache@v4
	id: cached-poetry-dependencies
	with:
	path: .venv
	key: venv-${{ runner.os }}-${{ steps.full-python-version.outputs.version }}-${{ hashFiles('**/poetry.lock') }}

	- name: Install dependencies
	if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
	run: \|
	poetry lock --no-update
	poetry install

	- name: Set up Quarto
	uses: quarto-dev/quarto-actions/setup@v2

	- name: Run quartodoc
	run: \|
	cd docs
	poetry run quartodoc build --verbose
	poetry run quartodoc interlinks

	- name: Render and Publish to GitHub Pages
	if: github.repository == 'xability/py-maidr'
	uses: quarto-dev/quarto-actions/publish@v2
	with:
	target: gh-pages
	path: docs
	env:
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
	QUARTO_PYTHON: .venv/bin/python

Provide feedback