Inconsistent href
まだ誰も着手していません。
評価
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 初心者へのやさしさ
- 48/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 停滞
調査の方向性
test/scribblings/test.scrbl とそのパッケージ情報 info.rkt を使って問題を再現し、レポートに記載されている 3 つの scribble コマンドに従います。生成された tocviewlink href の値を比較します。生成された HTML にマシン固有の絶対ファイルパスが含まれず、文書化された呼び出しモード全体でポータブルなままであれば完了です。
索引モデルが issue の本文から書いたものです。
説明
tl;dr: generated href could be inconsistent depending on several factors. Here are some of the possible values:
<a href="file:///Users/sorawee/playground/test/scribblings/test.html#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a><a href="test.html#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a><a href="#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a>
The second and third variation seem OK, but the first variation contains an absolute path, which is not portable to other systems.
First variation
Consider test/scribblings/test.scrbl
#lang scribble/base
@section{foo}
foo content
Make sure to install test as a package with the following info.rkt:
#lang info
(define collection "test")
(define scribblings '(("scribblings/test.scrbl" ())))
Then, in the directory test/scribblings, run scribble +m test.scrbl.
The generated HTML contains:
<a href="file:///Users/sorawee/playground/test/scribblings/test.html#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a>
Second variation
Now, run scribble +m --dest . test.scrbl.
The generated HTML contains:
<a href="test.html#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a>
Third variation
Now, run raco pkg remove test and re-run scribble +m test.scrbl.
The generated HTML contains:
<a href="#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a>
- 主要言語
- 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
-
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
メンテナーはふだん 1 日以内に返信
-
area:docs documentation P3
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
Raaif-Yousuf/Wingman#837 ·
メンテナーはふだん 1 日以内に返信
-
documentation good first issue hacktoberfest
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
wassim-azi/agy-powerline#47 ·
メンテナーはふだん 1 日以内に返信
-
area/localization language/es triage/accepted
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
kubernetes/website#58112 ·
メンテナーはふだん 2 日以内に返信
-
agent:working documentation enhancement go:build lane:needs-decision
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
Sanne/incus-spawn#1435 · コメント 3 件 ·
メンテナーはふだん 1 日以内に返信