Docs

Merge pull request #38 from JuliaAstro/prepare #134

	name: Docs

	on:
	push:
	branches:
	- main
	paths:
	- "docs/**"
	- "src/**"
	- "*.toml"
	tags: ["*"]
	pull_request:
	branches:
	- main
	paths:
	- "docs/**"
	- "src/**"
	- "*.toml"
	types: [opened, synchronize, reopened]

	concurrency:
	# Skip intermediate builds: always.
	# Cancel intermediate builds: only if it is a pull request build.
	group: ${{ github.workflow }}-${{ github.ref }}
	cancel-in-progress: ${{ startsWith(github.ref, 'refs/pull/') }}

	jobs:
	docs:
	name: Documentation
	runs-on: ubuntu-latest
	permissions:
	contents: write
	steps:
	- uses: actions/checkout@v6
	- uses: julia-actions/setup-julia@v2
	with:
	version: "1"
	- name: Use Julia cache
	uses: julia-actions/cache@v2
	- name: Instantiate environment with development version of the package
	run: \|
	julia --project=docs -e '
	using Pkg
	Pkg.develop(PackageSpec(path=pwd()))
	Pkg.instantiate()'
	- name: Run doctest
	run: \|
	julia --project=docs -e '
	using Documenter: DocMeta, doctest
	using SolarPosition
	using Dates
	DocMeta.setdocmeta!(SolarPosition, :DocTestSetup, :(using SolarPosition; using Dates; obs = Observer(37.7749, -122.4194, 100.0); dt = DateTime(2023, 6, 21, 12, 0, 0)); recursive=true)
	doctest(SolarPosition)'
	- name: Generate and deploy documentation
	run: julia --project=docs docs/make.jl
	env:
	JULIA_PKG_SERVER: ""
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
	GKSwstype: "100" # https://discourse.julialang.org/t/generation-of-documentation-fails-qt-qpa-xcb-could-not-connect-to-display/60988

Provide feedback