Merge pull request #85 from MridulS/wheel_build

 copier update to bump pypi publish action

Author: MridulS

.copier-answers.yml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
-_commit: 5c4fd02
+_commit: cdbfd9c
 _src_path: gh:scipp/copier_template
 description: Polarization data reduction for the European Spallation Source
 max_python: '3.13'

.github/workflows/docs.yml

@@ -65,11 +65,13 @@ jobs:
       - run: tox -e linkcheck
         if: ${{ inputs.linkcheck }}
       - uses: actions/upload-artifact@v4
+        id: artifact-upload-step
         with:
           name: docs_html
           path: html/
+      - run: echo "::notice::https://remote-unzip.deno.dev/${{ github.repository }}/artifacts/${{ steps.artifact-upload-step.outputs.artifact-id }}"
 
-      - uses: JamesIves/[email protected].2
+      - uses: JamesIves/[email protected].3
         if: ${{ inputs.publish }}
         with:
           branch: gh-pages

.github/workflows/release.yml

@@ -68,7 +68,7 @@ jobs:
     if: github.event_name == 'release' && github.event.action == 'published'
     steps:
       - uses: actions/download-artifact@v4
-      - uses: pypa/gh-action-pypi-publish@v1.8.14
+      - uses: pypa/gh-action-pypi-publish@v1.12.4
 
   upload_conda:
     name: Deploy Conda

.gitignore

@@ -14,6 +14,7 @@ venv
 .venv
 
 # Caches
+*.DS_Store
 .clangd/
 *.ipynb_checkpoints
 __pycache__/

docs/index.md

@@ -1,10 +1,42 @@
-# ESSpolarization
+:::{image} _static/logo.svg
+:class: only-light
+:alt: ESSpolarization
+:width: 60%
+:align: center
+:::
+:::{image} _static/logo-dark.svg
+:class: only-dark
+:alt: ESSpolarization
+:width: 60%
+:align: center
+:::
 
-<span style="font-size:1.2em;font-style:italic;color:#5a5a5a">
+```{raw} html
+   <style>
+    .transparent {display: none; visibility: hidden;}
+    .transparent + a.headerlink {display: none; visibility: hidden;}
+   </style>
+```
+
+```{role} transparent
+```
+
+# {transparent}`ESSpolarization`
+
+<span style="font-size:1.2em;font-style:italic;color:var(--pst-color-text-muted)">
   Polarization data reduction for the European Spallation Source
   </br></br>
 </span>
 
+:::{include} user-guide/installation.md
+:heading-offset: 1
+:::
+
+## Get in touch
+
+- If you have questions that are not answered by these documentation pages, ask on [discussions](https://github.com/scipp/esspolarization/discussions). Please include a self-contained reproducible example if possible.
+- Report bugs (including unclear, missing, or wrong documentation!), suggest features or view the source code [on GitHub](https://github.com/scipp/esspolarization).
+
 ```{toctree}
 ---
 hidden:

docs/user-guide/index.md

@@ -33,4 +33,5 @@ workflow
 sans-polarization-analysis-methodology
 inverse_of_polarization_matrices
 zoom
+installation
 ```

docs/user-guide/installation.md

@@ -0,0 +1,16 @@
+# Installation
+
+To install ESSpolarization and all of its dependencies, use
+
+`````{tab-set}
+````{tab-item} pip
+```sh
+pip install esspolarization
+```
+````
+````{tab-item} conda
+```sh
+conda install -c conda-forge -c scipp esspolarization
+```
+````
+`````

tox.ini

@@ -64,6 +64,8 @@ description = Update dependencies by running pip-compile-multi
 deps =
   pip-compile-multi
   tomli
+  # Avoid https://github.com/jazzband/pip-tools/issues/2131
+  pip==24.2
 skip_install = true
 changedir = requirements
 commands = python ./make_base.py --nightly scipp,sciline,scippnexus