Makefile's `serve` rule checks out submodules, making testing theme changes difficult
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 35/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 停滞
- 技術スタック
- git, hugo, shell
- 領域
- build-system
調査の方向性
numpy.org と scientific-python.org の Makefile を読み、serve ルールと serve-dev ルール、および submodule の更新コマンドを比較する。Hugo がどのように呼び出されているかを確認し、serve-dev がテーマの checkout を強制せず、不一致について警告するにはどうすべきかを判断する。テーマの開発者が別の submodule checkout を、リセットされることなくテストできれば完了とする。
索引モデルが issue の本文から書いたものです。
説明
@jarrodmillman @stefanv
While working on https://github.com/numpy/numpy.org/pull/668, I noticed again that the Makefile's serve rule calls git submodule update. Since the https://github.com/scientific-python/scientific-python-hugo-theme repo is a submodule in the numpy.org and scientific-python.org repos, this makes it a bit more difficult to test theme changes against these sites, because calling make serve tries to set the theme submodules back to what the "superproject" (in git-submodule terms) expects, rather than what the theme developer may have temporarily checked out in the submodule repository.
Both the numpy.org and scientific-python.org repos' Makefiles have a serve-dev rule. In each one, the only difference from the serve rule is that it adds the argument --disableFastRender (which is a Hugo option that affects how it serves the pages locally). I wonder if it would be appropriate to also use the serve-dev rule to not force the submodules to be updated; rather, we could just print a warning if the submodules aren't what's expected. This would allow the theme developer to use a different checkout in the submodule more easily.
Please let me know what you think about this idea. If it sounds good, I'll update the Makefiles accordingly. Thanks.
- 主要言語
- Shell
- スター
- 128
- フォーク
- 133
- 平均マージ
- 1日 18時間
- マージ済み PR（30日）
- 3
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
numpy/numpy.org のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
-
sustain-2026
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
-
sustain-2026 translations
難易度 3/5 1〜2日 初心者へのやさしさ 30/100
-
難易度 4/5 3〜5日 初心者へのやさしさ 20/100
-
translations
難易度 4/5 3〜5日 初心者へのやさしさ 38/100
numpy/numpy.org の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 92/100
メンテナーはふだん 2 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
obra/superpowers#2445 ·
メンテナーはふだん 5 日以内に返信
-
package-update
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
oSoWoSo/vOid_Community_repOsitory#240 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
ai-inspected
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
メンテナーはふだん 1 日以内に返信
-
[Bug]: atuin doctor reports "Hub (authenticated)" while the client syncs with a self-hosted serverオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
メンテナーはふだん 1 日以内に返信