Nested `deftech` fails to generate a link in Search Manual
まだ誰も着手していません。
評価
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 初心者へのやさしさ
- 45/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 停滞
調査の方向性
.scrbl スニペット内の入れ子になった deftech の例から始め、生成された .html と Search Manual の出力を再現します。"commutative diagram" と "commutative triangle" のリンクを比較します。入れ子になった定義が両方の出力で正しいリンクを生成すれば完了です。
索引モデルが issue の本文から書いたものです。
説明
What version of Racket are you using?
8.12 [cs]
What program did you run?
Here is a snippet of my .scrbl file that seems to cause the issue:
@subsection{Commutative Diagram}
Informally, a @deftech{diagram} comprises various @tech{objects} connected by
various @tech{morphisms}. When the @tech{morphisms} with the same @tech{domain}
and @tech{codomain} are the same one, the @tech{diagram} is a
@deftech{@deftech{commutative} diagram}.
@tech{Commutative diagrams} serve as a powerful language for expressing equations.
@subsubsection{Commutative Triangle}
A @deftech{commutative triangle} is a @tech{commutative diagram} that has the shape
of a triangle.
What should have happened?
The nested use of deftech should generate correct links in both the .html file and the Search Manual for all defined technical terms. Specifically, the term "commutative diagram" should be properly linked in the Search Manual like "commutative triangle".
If you got an error message, please include it here.
No error message was displayed, but the expected link creation in the Search Manual was not observed for the nested deftech tags.
Please include any other relevant details
In .html:
In Search Manual:
- 主要言語
- Racket
- スター
- 251
- フォーク
- 101
- 平均マージ
- 11日 9時間
- マージ済み PR（30日）
- 2
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
racket/scribble のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
難易度 3/5 1〜2日 初心者へのやさしさ 74/100
-
難易度 4/5 3〜5日 初心者へのやさしさ 35/100
-
難易度 3/5 1〜2日 初心者へのやさしさ 55/100
-
難易度 4/5 3〜5日 初心者へのやさしさ 35/100
racket/scribble の issue をすべて見る
似ている issue
-
area: design documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
eyalgolan/statecraft-israel#883 ·
メンテナーはふだん 1 日以内に返信
-
area:release criticality:p3 documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
registrystack/registry-stack#2085 ·
メンテナーはふだん 1 日以内に返信
-
documentation good first issue
難易度 2/5 1〜3時間 初心者へのやさしさ 87/100
メンテナーはふだん 1 日以内に返信
-
[workshop-sync] workshop/side-quest-17-06-output-injection.md: stale add_comment.cjs line referencesオープンdocumentation
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
githubnext/gh-aw-workshop#4679 ·
メンテナーはふだん 1 日以内に返信
-
git-workflow task-4
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100