starplot 0.20.5__tar.gz → 0.20.6__tar.gz

starplot-0.20.6/.github/workflows/archives.yaml

@@ -0,0 +1,50 @@
+name: Publish Docs (archives)
+
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-24.04
+
+    permissions:
+      contents: 'read'
+      id-token: 'write'
+
+    steps:
+    - uses: actions/checkout@v6
+
+    - name: Build Docker image
+      run: make build
+    
+    - name: Build sky.db
+      run: make db CI=true
+
+    - name: Build Examples
+      run: make examples
+    
+    - name: Build Tutorial
+      run: make tutorial
+    
+    - name: Build Data Reference
+      run: make build-doc-data
+
+    - name: Build Docs
+      run: make docs-build
+
+    - name: Set Version Environment Variable
+      run: |
+        echo "STARPLOT_VERSION=$(make version)" >> "$GITHUB_ENV"
+
+    - id: 'auth'
+      uses: 'google-github-actions/auth@v2'
+      with:
+        credentials_json: '${{ secrets.GCP_CREDENTIALS }}'
+      
+    - name: 'Set up Google Cloud SDK'
+      uses: 'google-github-actions/setup-gcloud@v2'
+      with:
+        version: '>= 363.0.0'
+
+    - name: 'Sync docs to [archives] Cloud Storage Bucket'
+      run: 'gsutil -m rsync -R -d site gs://archives.starplot.dev/$STARPLOT_VERSION'

{starplot-0.20.5 → starplot-0.20.6}/.gitignore

@@ -3,6 +3,10 @@ scripts/scratchpad.py
 
 .claude/
 
+
+.env-backup
+e2e/
+
 # astronomy data
 *.bsp
 CometEls.txt
@@ -49,7 +53,10 @@ docs/images/examples/*.png
 docs/images/examples/*.jpg
 docs/images/examples/*.svg
 tutorial/*.png
+tutorial/*.svg
 docs/images/tutorial/*.png
+docs/images/tutorial/*.svg
+docs/images/reference/*.*
 docs/data/*.json
 
 # Profiling files

{starplot-0.20.5 → starplot-0.20.6}/CITATION.cff

@@ -20,5 +20,5 @@ keywords:
   - graphs
   - plotting
 license: MIT
-version: 0.20.5
-date-released: '2026-08-18'
+version: 0.20.6
+date-released: '2026-09-17'

{starplot-0.20.5 → starplot-0.20.6}/Makefile

@@ -22,7 +22,7 @@ DOCKER_RUN_PYTHON_TEST=docker run --rm $(DR_ARGS) starplot-$(PYTHON_VERSION)
 export PYTHONPATH=./src/
 
 # ------------------------------------------------------------------
-build: PYTHON_VERSION=3.12.12
+build: PYTHON_VERSION=3.11.14
 build: DOCKER_BUILD_ARGS=-t starplot-dev
 build:
 	touch -a .env

{starplot-0.20.5 → starplot-0.20.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starplot
-Version: 0.20.5
+Version: 0.20.6
 Summary: Star charts and maps of the sky
 Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
 Author-email: Steve Berardi <hello@steveberardi.com>
@@ -20,7 +20,7 @@ Requires-Dist: pandas <= 2.2.3
 Requires-Dist: pydantic >= 2.10.6
 Requires-Dist: shapely >= 2.0.1
 Requires-Dist: skyfield >= 1.41
-Requires-Dist: cartopy >= 0.21.1
+Requires-Dist: cartopy <= 0.24.1
 Requires-Dist: geopandas >= 1.0.1
 Requires-Dist: pillow >= 10.0.0
 Requires-Dist: PyYAML >= 6.0.1

{starplot-0.20.5 → starplot-0.20.6}/docs/changelog.md

@@ -15,6 +15,7 @@
 - [**v0.20.3**] Fixes bugs with styling and class variables
 - [**v0.20.4**] Makes deserializing star data more reliable across environments
 - [**v0.20.5**] Adds Italian translation
+- [**v0.20.6**] Pins `cartopy` version to `<= 0.24.1`
 
 ## v0.19.x
 [Documentation](https://archives.starplot.dev/0.19.6/)

{starplot-0.20.5 → starplot-0.20.6}/docs/data/dsos.md

@@ -40,7 +40,7 @@ The table below shows all the deep sky objects (DSOs) available in OpenNGC's dat
             'Geometry',
         ],
         server: {
-            url: '/data/ongc.json',
+            url: '../../data/ongc.json',
             then: data => data.map(dso => [
                 dso.name,
                 dso.type,

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/horizon-double-cluster.md

@@ -1,11 +1,11 @@
 ---
 title: Finding the Double Cluster in Perseus
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Finding the Double Cluster in Perseus {.example-header}
 
-![horizon-double-cluster](/images/examples/horizon_double_cluster.png)
+![horizon-double-cluster](../images/examples/horizon_double_cluster.png)
 
 
 Here's a chart you might create to help you find the [Double Cluster](https://en.wikipedia.org/wiki/Double_Cluster) (NGC 884 and 869) in Perseus and to visualize the field of view with 10x binoculars (the red dashed circle).
@@ -13,7 +13,7 @@ Here's a chart you might create to help you find the [Double Cluster](https://en
 This example uses many of Starplot's features:
 
 - [Looking up objects][starplot.Constellation.get]
-- Using properties on those objects to [selectively plot stars](/reference-selecting-objects/) (in this example, we use the constellation models to _only_ plot stars that are part of the lines in the constellation)
+- Using properties on those objects to [selectively plot stars](../reference-selecting-objects.md) (in this example, we use the constellation models to _only_ plot stars that are part of the lines in the constellation)
 - Drawing a circle to [show the field of view for bincoulars][starplot.HorizonPlot.optic_fov]
 - Drawing an [arrow][starplot.HorizonPlot.arrow] to show which stars you can use as guides to finding the double cluster
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/horizon-gradient.md

@@ -1,15 +1,15 @@
 ---
 title: Horizon Gradient
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Horizon Gradient {.example-header}
 
-![horizon-gradient](/images/examples/horizon_gradient.png)
+![horizon-gradient](../images/examples/horizon_gradient.png)
 
 This plot shows what was in the sky when looking south from Stonehaugh, England on July 26, 2025 at 11pm BST. A color gradient has been applied for visual effect.
 
-Learn more about using gradient backgrounds by reading the docs on the [style's background color](/reference-styling/#starplot.PlotStyle.background_color).
+Learn more about using gradient backgrounds by reading the docs on the [style's background color](../reference-styling.md#starplot.PlotStyle.background_color).
 
 ```python
 --8<-- "examples/horizon_gradient.py"

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/horizon-sgr.md

@@ -1,11 +1,11 @@
 ---
 title: Horizon Plot
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Horizon Plot {.example-header}
 
-![horizon-sgr](/images/examples/horizon_sgr.png)
+![horizon-sgr](../images/examples/horizon_sgr.png)
 
 This plot shows what was in the sky when looking south from Lone Pine, California on August 30, 2024 at 9pm PT.
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-big-dipper.md

@@ -1,11 +1,11 @@
 ---
 title: The Big Dipper with Custom Markers
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # The Big Dipper with Custom Markers {.example-header}
 
-![map-big-dipper](/images/examples/map_big_dipper.png)
+![map-big-dipper](../images/examples/map_big_dipper.png)
 
 Here's a fun one 😃 Let's create a small plot of the big dipper ([Ursa Major](https://en.wikipedia.org/wiki/Ursa_Major)), but with custom star-shaped markers:
 

starplot-0.20.6/docs/examples/map-big.md

@@ -0,0 +1,14 @@
+---
+title: Big Map
+---
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
+
+# Big Map {.example-header}
+
+![map-big](../images/examples/map_big.png)
+
+```python
+--8<-- "examples/map_big.py"
+```
+
+

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-canis-major.md

@@ -1,11 +1,11 @@
 ---
 title: Map of Canis Major
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Map of Canis Major {.example-header}
 
-![map-canis-major](/images/examples/map_canis_major.png)
+![map-canis-major](../images/examples/map_canis_major.png)
 
 In this example, we set the plot's `clip_path` to the border of Canis Major, so only objects in that constellation are plotted:
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-carina-nebula.md

@@ -1,11 +1,11 @@
 ---
 title: Carina Nebula + Clusters
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Carina Nebula + Clusters {.example-header}
 
-![map-carina](/images/examples/map_carina.png)
+![map-carina](../images/examples/map_carina.png)
 
 
 ```python

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-cassiopeia.md

@@ -1,11 +1,11 @@
 ---
 title: Map of Cassiopeia
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Map of Cassiopeia {.example-header}
 
-![map-cas](/images/examples/map_cas.png)
+![map-cas](../images/examples/map_cas.png)
 
 ```python
 --8<-- "examples/map_cas.py"

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-custom-marker.md

@@ -1,11 +1,11 @@
 ---
 title: Map with Custom Galaxy Markers
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Map with Custom Galaxy Markers {.example-header}
 
-![map-sagittarius](/images/examples/galaxy_custom_marker.png)
+![map-sagittarius](../images/examples/galaxy_custom_marker.png)
 
 
 ```python

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-galaxy.md

@@ -1,11 +1,11 @@
 ---
 title: Galaxy Plot
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Galaxy Plot {.example-header}
 
-![map-galaxy](/images/examples/map_galaxy.png)
+![map-galaxy](../images/examples/map_galaxy.png)
 
 ```python
 --8<-- "examples/map_galaxy.py"

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-milky-way-stars.md

@@ -1,11 +1,11 @@
 ---
 title: The Milky Way
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # The Milky Way {.example-header}
 
-![map-milky-way-stars](/images/examples/map_milky_way_stars.png)
+![map-milky-way-stars](../images/examples/map_milky_way_stars.png)
 
 In this example, we first plot all stars with a limiting magnitude of 11, which clearly shows the Milky Way. And then we use [Pillow](https://pillow.readthedocs.io/en/latest/index.html) to apply a median filter, which helps make the Milky Way stand out more in the image.
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-orion.md

@@ -1,11 +1,11 @@
 ---
 title: Map of Orion
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Map of Orion {.example-header}
 
-![map-orion](/images/examples/map_orion.png)
+![map-orion](../images/examples/map_orion.png)
 
 The following code will create a simple map plot that shows the area around the constellation [Orion](https://en.wikipedia.org/wiki/Orion_(constellation)):
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-orthographic.md

@@ -1,11 +1,11 @@
 ---
 title: Orthographic Map
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Orthographic Map {.example-header}
 
-![map-big](/images/examples/map_orthographic.png)
+![map-big](../images/examples/map_orthographic.png)
 
 ```python
 --8<-- "examples/map_orthographic.py"

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/map-sagittarius.md

@@ -1,11 +1,11 @@
 ---
 title: Map of Sagittarius
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Map of Sagittarius {.example-header}
 
-![map-sagittarius](/images/examples/map_sagittarius.png)
+![map-sagittarius](../images/examples/map_sagittarius.png)
 
 
 ```python

starplot-0.20.6/docs/examples/map-virgo-cluster.md

@@ -0,0 +1,18 @@
+---
+title: Map of the Virgo Galaxy Cluster
+---
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
+
+# Map of the Virgo Galaxy Cluster {.example-header}
+
+![map-virgo-galaxy-cluster](../images/examples/map_virgo_cluster.png)
+
+In this example, we create a custom [CollisionHandler](../reference-collisions.md) for points to ensure _all_ labels are plotted in the very busy area of the Virgo Galaxy Cluster:
+
+<div class="tutorial">
+```python
+--8<-- "examples/map_virgo_cluster.py"
+```
+</div>
+
+<br/><br/>

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/optic-iss-transit.md

@@ -1,11 +1,11 @@
 ---
 title: ISS Moon Transit
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Optic Plot of the ISS transiting the Moon {.example-header}
 
-![optic-iss-moon-transit](/images/examples/optic_iss_transit.png)
+![optic-iss-moon-transit](../images/examples/optic_iss_transit.png)
 
 This plot shows the [International Space Station (ISS)](https://en.wikipedia.org/wiki/International_Space_Station) when it transits the Moon on December 8, 2025 at 8:03am PT as seen from lat/lon `33.0225028`, `-116.507025` (near Lake Cuyamaca in California, USA).
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/optic-m45.md

@@ -1,11 +1,11 @@
 ---
 title: Optic Plot of the Pleiades with a Refractor Telescope
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Optic Plot of the Pleiades with a Refractor Telescope {.example-header}
 
-![optic-m45](/images/examples/optic_m45.png)
+![optic-m45](../images/examples/optic_m45.png)
 
 The following code will create an optic plot that shows what The Pleiades looked like through a refractor telescope on December 16, 2023 at 9pm PT from Palomar Mountain in California.
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/optic-moon-saturn.md

@@ -1,11 +1,11 @@
 ---
 title: Moon and Saturn Conjunction
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Moon and Saturn Conjunction {.example-header}
 
-![optic-moon-saturn](/images/examples/optic_moon_saturn.png)
+![optic-moon-saturn](../images/examples/optic_moon_saturn.png)
 
 ```python
 --8<-- "examples/optic_moon_saturn.py"

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/optic-orion.md

@@ -1,11 +1,11 @@
 ---
 title: Optic Plot of the Orion Nebula with a Refractor Telescope
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Optic Plot of the Orion Nebula with a Refractor Telescope
 
-![optic-orion](/images/examples/optic_orion_nebula.png)
+![optic-orion](../images/examples/optic_orion_nebula.png)
 
 
 ```python

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/optic-solar-eclipse.md

@@ -1,11 +1,11 @@
 ---
 title: Total Solar Eclipse 2024
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Total Solar Eclipse 2024 {.example-header}
 
-![optic-moon-saturn](/images/examples/optic_solar_eclipse.png)
+![optic-moon-saturn](../images/examples/optic_solar_eclipse.png)
 
 This example shows the Moon and Sun _about 30 minutes before_ the total solar eclipse that occurred on [April 8, 2024](https://en.wikipedia.org/wiki/Solar_eclipse_of_April_8,_2024), as seen from Cleveland, Ohio.
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/star-chart-basic.md

@@ -1,11 +1,11 @@
 ---
 title: Star Chart for Time/Location
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Star Chart for Time/Location {.example-header}
 
-![starchart-blue](/images/examples/star_chart_basic.png)
+![starchart-blue](../images/examples/star_chart_basic.png)
 
 To create a star chart for the sky as seen from [Palomar Mountain](https://en.wikipedia.org/wiki/Palomar_Mountain) in California on July 13, 2023 at 10pm PT:
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/star-chart-detail.md

@@ -1,12 +1,12 @@
 ---
 title: Star Chart with More Detail
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Star Chart with More Detail {.example-header}
 
 
-![zenith-coma](/images/examples/star_chart_detail.png)
+![zenith-coma](../images/examples/star_chart_detail.png)
 
 Building on the first example, you can also plot additional objects and even customize their style. Here's an example that plots a bunch of extra stuff (including the Milky Way, ecliptic, Deep Sky Objects, and more). It also demonstrates how you can plot your own markers, like the dashed yellow circle around the [Coma Star Cluster](https://en.wikipedia.org/wiki/Coma_Star_Cluster) (Melotte 111):
 

{starplot-0.20.5 → starplot-0.20.6}/docs/examples/star-chart-french.md

@@ -1,11 +1,11 @@
 ---
 title: Star Chart in French
 ---
-[:octicons-arrow-left-24: Back to Examples](/examples)
+[:octicons-arrow-left-24: Back to Examples](../examples.md)
 
 # Star Chart in French {.example-header}
 
-![starchart-french](/images/examples/star_chart_french.png)
+![starchart-french](../images/examples/star_chart_french.png)
 
 
 ```python