ドキュメント用タスク（task doc）

$ task doc
$ task doc:build

MkDocs設定

tasks:
  # Documentation
  doc:
    desc: Serve documentation locally
    cmds:
      - uv run mkdocs serve -o

  doc:build:
    desc: Build documentation as static HTML
    cmds:
      - uv run mkdocs build

Sphinx設定

tasks:
  doc:
    desc: Serve documentation locally
    dir: docs
    cmds:
      - poetry run make livehtml

  doc:build:
    desc: Build documentation as static HTML
    dir: docs
    cmds:
      - poetry run make html

  doc:pdf:
    desc: Build documentation as PDF
    dir: docs
    cmds:
      - poetry run make latexpdf

make livehtmlは、sphinx-autobuildを使ってSphinxドキュメントをライブプレビューする設定です。 通常は、ドキュメントのあるディレクトリ（docs）に移動してからmake livehtmlコマンドを実行する必要があります。 このタスクを設定すると、どのディレクトリからでもtask docで確認できるようになります。