0.10.2: sphinx warnings `reference target not found`
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 38/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- python
- Lĩnh vực
- documentation
Hướng nghiên cứu
Tái hiện báo cáo bằng sphinx-build -n -T -b man docs build/sphinx/man, sau đó kiểm tra các docstring được tham chiếu trong tomlkit/init.py, tomlkit/items.py và tomlkit/toml_document.py cùng với cấu hình tài liệu. Hoàn thành khi quá trình build không còn phát ra các cảnh báo missing-reference, duplicate-description và thiếu _static đã được báo cáo.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
On building my packages I'm using sphinx-build command with -n switch which shows warmings about missing references. These are not critical issues.
Here is the output with warnings:
+ /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man
Running Sphinx v4.5.0
making output directory... done
WARNING: html_static_path entry '_static' does not exist
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 3 added, 0 changed, 0 removed
reading sources... [100%] quickstart
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items:1: WARNING: duplicate object description of tomlkit.items, other instance in api, use :noindex: for one of them
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/__init__.py:docstring of tomlkit.api.string:7: ERROR: Unknown target name: "https://toml.io/en/v1.0.0#string".
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... tomlkit.1 { quickstart api } /home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/__init__.py:docstring of tomlkit.api.dump:: WARNING: py:class reference target not found: collections.abc.Mapping
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/__init__.py:docstring of tomlkit.api.dump:: WARNING: py:obj reference target not found: typing.IO
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/__init__.py:docstring of tomlkit.api.dumps:: WARNING: py:class reference target not found: collections.abc.Mapping
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/__init__.py:docstring of tomlkit.api.load:: WARNING: py:obj reference target not found: typing.IO
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of tomlkit.toml_document.TOMLDocument:1: WARNING: py:class reference target not found: tomlkit.container.Container
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of tomlkit.container.Container.add:: WARNING: py:class reference target not found: tomlkit.container.Container
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of tomlkit.container.Container.append:: WARNING: py:class reference target not found: tomlkit.container.Container
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of collections.abc.MutableMapping.clear:: WARNING: py:class reference target not found: None. Remove all items from D.
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of tomlkit.container.Container.copy:: WARNING: py:class reference target not found: a shallow copy of D
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of collections.abc.Mapping.get:: WARNING: py:class reference target not found: D[k] if k in D, else d. d defaults to None.
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of collections.abc.Mapping.items:: WARNING: py:class reference target not found: a set-like object providing a view on D's items
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of collections.abc.Mapping.keys:: WARNING: py:class reference target not found: a set-like object providing a view on D's keys
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of collections.abc.MutableMapping.pop:: WARNING: py:class reference target not found: v, remove specified key and return the corresponding value.
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of collections.abc.MutableMapping.popitem:: WARNING: py:class reference target not found: (k, v), remove and return some (key, value) pair
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of tomlkit.container.Container.remove:: WARNING: py:class reference target not found: tomlkit.container.Container
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of tomlkit.container.Container.setdefault:: WARNING: py:class reference target not found: D.get(k,d), also set D[k]=d if k not in D
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of collections.abc.MutableMapping.update:: WARNING: py:class reference target not found: None. Update D from mapping/iterable E and F.
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/toml_document.py:docstring of collections.abc.Mapping.values:: WARNING: py:class reference target not found: an object providing a view on D's values
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.AoT:1: WARNING: py:class reference target not found: tomlkit.items._CustomList
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Array:1: WARNING: py:class reference target not found: tomlkit.items._CustomList
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.BoolType:1: WARNING: py:class reference target not found: enum.Enum
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Date:1: WARNING: py:class reference target not found: datetime.date
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Date.replace:: WARNING: py:class reference target not found: datetime.date
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.DateTime:: WARNING: py:class reference target not found: datetime.tzinfo
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.DateTime:1: WARNING: py:class reference target not found: datetime.datetime
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.DateTime.astimezone:: WARNING: py:class reference target not found: datetime.tzinfo
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.DateTime.astimezone:: WARNING: py:class reference target not found: datetime.datetime
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.DateTime.replace:: WARNING: py:class reference target not found: datetime.datetime
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.InlineTable:: WARNING: py:class reference target not found: container.Container
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.InlineTable:1: WARNING: py:class reference target not found: tomlkit.items.AbstractTable
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Key:1: WARNING: py:class reference target not found: abc.ABC
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.KeyType:1: WARNING: py:class reference target not found: enum.Enum
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.StringType:1: WARNING: py:class reference target not found: enum.Enum
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Table:: WARNING: py:class reference target not found: container.Container
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Table:1: WARNING: py:class reference target not found: tomlkit.items.AbstractTable
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Time:: WARNING: py:class reference target not found: datetime.tzinfo
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Time:1: WARNING: py:class reference target not found: datetime.time
/home/tkloczko/rpmbuild/BUILD/tomlkit-0.10.2/tomlkit/items.py:docstring of tomlkit.items.Time.replace:: WARNING: py:class reference target not found: datetime.time
done
build succeeded, 41 warnings.
- Ngôn ngữ chính
- Python
- Star
- 850
- Fork
- 163
- Merge trung bình
- 13 phút
- Pull request đã merge (30 ngày)
- 2
Hướng dẫn đóng góp
Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của python-poetry/tomlkit
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
python-poetry/tomlkit#546 · 2 bình luận ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100
python-poetry/tomlkit#603 ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 52/100
python-poetry/tomlkit#580 · 1 bình luận ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 72/100
python-poetry/tomlkit#577 ·
-
Looking for a co-maintainer Đang mở
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 20/100
python-poetry/tomlkit#574 · 5 bình luận ·
Tất cả issue của python-poetry/tomlkit
Issue tương tự
-
bug confirmed issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
open-webui/open-webui#30750 · 1 bình luận ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
OpenwaterHealth/openmotion-bloodflow-app#604 · 1 bình luận ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
-
good first issue
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 90/100