QuantEcon / QuantEcon/lecture-python-programming
environment.yml uses conda channel 'default' instead of 'defaults'; trailing space in _toc.yml
還沒有人認領這個 Issue。
- 主要語言
- JavaScript
- 星號
- 72
- 分支
- 31
- 平均合併
- 2 天 20 小時
- 30 天內合併 PR
- 8
描述
Two small defects in the build configuration, both found while porting this repo's scaffold into the new lecture-python-programming.ml edition (QuantEcon/lecture-python-programming.ml#6). Neither breaks the build today; the first is a latent failure worth getting ahead of.
1. environment.yml names the conda channel default, not defaults
default is not a conda channel. Conda adds it as a literal channel name and then resolves the packages from defaults, which it still adds implicitly — and warns about doing so:
Adding channel 'default'
[command]/home/runner/miniconda3/condabin/conda config --add channels default
##[warning]The 'defaults' channel might have been added implicitly. If this is intentional, add 'defaults' to the 'channels' list. Otherwise, consider setting 'conda-remove-defaults' to 'true'.
So the environment resolves by accident. Conda is deprecating the implicit-defaults behaviour, and when it goes the build fails to resolve anything.
This affects three editions — this repo, lecture-python-programming.fr and lecture-python-programming.fa — all of which carry - default. lecture-python-programming.zh-cn already has - defaults and is unaffected, so the corrected form is already proven in the fleet.
The fix is one word in environment.yml.
2. lectures/_toc.yml line 39 has a trailing space
The entry reads - file: workspace rather than - file: workspace. This is harmless in practice — YAML strips trailing whitespace from plain scalars, so both jb build and any tooling reading the file see workspace — but it propagates verbatim into every translation edition, since action-translation copies _toc.yml from source as-is. It surfaced as a review comment on the downstream PR, where fixing it locally would only have created drift against this repo.
Worth correcting here so it stops being re-copied.
貢獻指南
這個儲存庫沒有索引到貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
研究方向
開啟 environment.yml 和 lectures/_toc.yml,然後將 channel 的拼寫與 zh-cn 版本中已使用的修正形式進行比較。將 default 改為 defaults,並移除 workspace 後面的尾隨空格;執行 jb build 以確認設定仍能正確解析並順利建置。
由索引模型根據 Issue 內容生成。
評估
- 技術堆疊
- yaml
- 領域
- build-system, documentation
- Issue 類型
- 缺陷
- 難度
- 2/5
- 預估耗時
- 1-3 小時
- 活躍度
- 冷清
- 描述清晰度
- 描述清楚
- 新手友好度
- 82/100