Tôi đang cố sử dụng của để đưa tài liệu từ một tệp vào một tệp khác, để tránh sao chép văn bản nguồn của tài liệu. Phần tôi bao gồm là trong configuration.rst (nó là một phần của các tài liệu tham khảo cho các thiết lập cấu hình) và nó có chứa một số nhãn cho tham khảo chéo mỗi thiết lập cấu hình:Nhân sư .. bao gồm cảnh báo :: chỉ thị và "trùng lặp nhãn"
.. start_config-authorization
.. _ckan.auth.anon_create_dataset:
ckan.auth.anon_create_dataset
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Example::
ckan.auth.anon_create_dataset = False
Default value: ``False``
Allow users to create datasets without registering and logging in.
.. _ckan.auth.create_unowned_dataset:
ckan.auth.create_unowned_dataset
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...
.. end_config-authorization
Trong tập tin khác (authorization.rst) tôi bao gồm chỉ các thiết lập cho phép cấu hình từ configuration.rst nội tuyến, như thế này:
.. include:: /configuration.rst
:start-after: start_config-authorization
:end-before: end_config-authorization
vấn đề là các nhãn trong văn bản bao gồm sản xuất cảnh báo này từ Sphinx:
doc/configuration.rst:224: WARNING: duplicate label ckan.auth.anon_create_dataset, other instance in doc/authorization.rst
Cho đến nay tham khảo chéo dường như không thể bị phá vỡ, nếu tôi đặt:
:ref:`ckan.auth.anon_create_dataset`
trong một tập tin thứ ba, điều này tạo ra một cách chính xác một liên kết đến định nghĩa của ckan.auth.anon_create_dataset trong configuration.html (và không phải là bản sao bao gồm của nó trong authorization.html).
Có an toàn để chỉ đơn giản là bỏ qua hoặc tắt tiếng các cảnh báo nhãn trùng lặp này và mong đợi tất cả các liên kết chéo liên kết đến configuration.html? Hay tôi nên tìm cách khác để làm điều này?
Không thực sự. Tôi nghĩ rằng nếu một bản sao được phát hiện, nó sẽ bị bỏ qua. Tham chiếu sẽ không có liên kết hoặc mục tiêu sẽ không được tạo hoặc cả hai. – erikbwork