Repository navigation
Conversation
Add pixi.toml/pixi.lock (default, dev, test, doc envs) and sync-locks task exporting conda files to envs/. Replace Makefile with pixi tasks, micromamba CI with setup-pixi, add bi-weekly lockfile update workflow. Build RTD docs via pixi; drop conda directives from Snakefile; update docs and templates.
Pure renames to preserve history; content is converted in the next commit.
Convert doc/*.md pages, add mkdocs.yml (search, table-reader, snippets) and PyPSA-Eur colour css. Replace literalinclude markers in compile_cost_assumptions.py with snippet sections; fix missing add-solar-from-others. Build RTD with mkdocs via pixi doc env; drop doc/conf.py and doc/Makefile.
euronion
force-pushed
the
pixi-mkdocs
branch
2 times, most recently
from
November 6, 2026 13:32
f54c703 to
9c46f8e
Compare
Collaborator
Author
Member
|
Totally fine with this PR! Thanks for taking care of it! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Note
This PR description and the changes were created with the help of AI (Claude Code) and reviewed by the author.
Changes proposed in this Pull Request
This PR moves
Both follow the setup in PyPSA-Eur.
1. conda --> pixi
pixi.tomlandpixi.lock. Also addresses the CI failure in e.g. Fix bug preventing add_energy_storage_database to run through #286 which is caused by non-pinned packages / package version misalignment.tabula-pyandcurrencyconverternow come from conda-forge, so nopipdependencies anymore.pixitasks:pixi run unit-tests,pixi run run-all(full workflow),pixi run build-docs <dir>andpixi run sync-locks. CI runs the two test workflows withpixi run -e test snakemake ...directly.pixi run sync-locksexportsenvs/environment.yamlandenvs/default_<platform>.pin.txt, so conda users still have a supported path. Like in PyPSA-Eur. The rootenvironment.yamlis removed.conda:directives are removed from theSnakefile. Instead runpixi run snakemake ...update-lockfile.yamlworkflow. It opens a PR with refreshed locks twice a month.2. Sphinx --> MkDocs
mkdocs.ymlwith the Material theme.mkdocsis pinned to<2for known reasons.{{ read_csv(...) }}. Code excerpts usepymdownx.snippetssections. The markers inscripts/compile_cost_assumptions.pychanged from# [name]to# --8<-- [start:name]/# --8<-- [end:name].Side-fix:
add-solar-from-othersexcerpt inaddnewrendered empty before, because its marker did not exist. It now has a marker.Important breaking changes
environment.yamlmoved toenvs/environment.yamland holds only runtime dependencies./installation.htmlto/installation/.Questions for @lkstrp
update-lockfile.yamlneeds the repo setting "Allow GitHub Actions to create and approve pull requests" - can you configure?Checklist
doc.pixi.tomlandpixi run sync-lockswas run (if applicable).doc/release_notes.mdof the upcoming release is included.