Skip to content

Add pixi-based local development environment#26

Merged
joshmoore merged 1 commit into
IDR:mainfrom
ianhi:dev-ex
Oct 6, 2025
Merged

Add pixi-based local development environment#26
joshmoore merged 1 commit into
IDR:mainfrom
ianhi:dev-ex

Conversation

@ianhi

@ianhi ianhi commented Sep 30, 2025

Copy link
Copy Markdown
Contributor

I had a lot of trouble getting things to install without this. So I added the ability to build and serve the docs locally using pixi

As part of this I also played around a bit with the minima version and installation step. The end result of this is that you can view the local version with css and javascript with pixi run serve

I also wanted to test this on github pages. So here is it running off my fork via the github pages build from branch option: https://ianhuntisaak.com/ome-ngff-samples/

I also:

  • Fixed some liquid syntax errors
  • added a gitignore

- Add pixi.toml for Ruby environment management
- Update to Jekyll 4.0 and minima 2.5.2
- Add GitHub Actions workflow for unified build system
- Fix Liquid syntax errors in index.md
- Add custom head.html to support jQuery and DataTables
- Add comprehensive .gitignore for Jekyll and pixi
- Lock dependencies with Gemfile.lock for consistency
@will-moore

Copy link
Copy Markdown
Member

Once my TMPDIR issues were addressed (see #28) this is working fine for me. Nice to have it reloading with edit and refresh. I see a couple of deprecation warnings - don't know if that's a concern?

$ pixi run serve
✨ Pixi task (install): gem install bundler && bundle install                                                                                                         Successfully installed bundler-2.7.2
1 gem installed
[DEPRECATED] Platform :mingw, :mswin, :x64_mingw is deprecated. Please use platform :windows instead.
Bundle complete! 9 Gemfile dependencies, 62 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
1 installed gem you directly depend on is looking for funding.
  Run `bundle fund` for details
                                                                                                                                                                      ✨ Pixi task (serve): bundle exec jekyll serve                                                                                                                        /Users/wmoore/Desktop/IDR/ome-ngff-samples/.pixi/envs/default/share/rubygems/gems/jekyll-4.4.1/lib/jekyll.rb:26: warning: logger was loaded from the standard library, but will no longer be part of the default gems starting from Ruby 3.5.0.
You can add logger to your Gemfile or gemspec to silence this warning.
Configuration file: /Users/wmoore/Desktop/IDR/ome-ngff-samples/_config.yml
            Source: /Users/wmoore/Desktop/IDR/ome-ngff-samples
       Destination: /Users/wmoore/Desktop/IDR/ome-ngff-samples/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
Deprecation Warning [import]: Sass @import rules are deprecated and will be removed in Dart Sass 3.0.0.

More info and automated migrator: https://sass-lang.com/d/import

  ╷
1 │ @import "minima";
  │         ^^^^^^^^
  ╵
    /Users/wmoore/Desktop/IDR/ome-ngff-samples/assets/main.scss 1:9  root stylesheet
                    done in 0.749 seconds.
 Auto-regeneration: enabled for '/Users/wmoore/Desktop/IDR/ome-ngff-samples'
    Server address: http://127.0.0.1:4000/ome-ngff-samples/
  Server running... press ctrl-c to stop.

Otherwise looking good.

@joshmoore @sbesson Any issues you see with this proposal?

@joshmoore

joshmoore commented Oct 6, 2025

Copy link
Copy Markdown
Member

No objections from my side. I'll merge now. Thanks, @ianhi!

Note: The only thing that I couldn't remember was what the custom head setting was required for. I dug a little but didn't hit bottom. If anyone notices something missing, please let us know.

@joshmoore
joshmoore merged commit e090521 into IDR:main Oct 6, 2025
@ianhi
ianhi deleted the dev-ex branch October 6, 2025 15:46
@ianhi

ianhi commented Oct 6, 2025

Copy link
Copy Markdown
Contributor Author

I see a couple of deprecation warnings - don't know if that's a concern?

I think these are a concern for the future. But with the pinning and lockfiles in this PR I think this will be more robust to those warnings turning into errors.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants