From cccfb45d0044513f2c632d2a5d5544127d0d019b Mon Sep 17 00:00:00 2001 From: Ramil Yanbulatov Date: Tue, 9 Aug 2022 14:50:05 +0200 Subject: [PATCH] Refs #33842 -- Removed incorrect :file: role in contrib docs. The file role is not appropriate for URLs and URL path-components. --- docs/ref/contrib/sitemaps.txt | 6 +++--- docs/ref/contrib/syndication.txt | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/ref/contrib/sitemaps.txt b/docs/ref/contrib/sitemaps.txt index c985ddb81ae..d3225405a38 100644 --- a/docs/ref/contrib/sitemaps.txt +++ b/docs/ref/contrib/sitemaps.txt @@ -156,9 +156,9 @@ Note: In both cases, "absolute path" means a URL that doesn't include the protocol or domain. Examples: - * Good: :file:`'/foo/bar/'` - * Bad: :file:`'example.com/foo/bar/'` - * Bad: :file:`'https://example.com/foo/bar/'` + * Good: ``'/foo/bar/'`` + * Bad: ``'example.com/foo/bar/'`` + * Bad: ``'https://example.com/foo/bar/'`` If :attr:`~Sitemap.location` isn't provided, the framework will call the ``get_absolute_url()`` method on each object as returned by diff --git a/docs/ref/contrib/syndication.txt b/docs/ref/contrib/syndication.txt index 1b255c6b407..9a65d7bbc2f 100644 --- a/docs/ref/contrib/syndication.txt +++ b/docs/ref/contrib/syndication.txt @@ -210,8 +210,8 @@ items based on information in the feed's URL. The police beat feeds could be accessible via URLs like this: -* :file:`/beats/613/rss/` -- Returns recent crimes for beat 613. -* :file:`/beats/1424/rss/` -- Returns recent crimes for beat 1424. +* ``/beats/613/rss/`` -- Returns recent crimes for beat 613. +* ``/beats/1424/rss/`` -- Returns recent crimes for beat 1424. These can be matched with a :doc:`URLconf ` line such as:: @@ -314,7 +314,7 @@ URLs ---- The ``link`` method/attribute can return either an absolute path (e.g. -:file:`"/blog/"`) or a URL with the fully-qualified domain and protocol (e.g. +``"/blog/"``) or a URL with the fully-qualified domain and protocol (e.g. ``"https://www.example.com/blog/"``). If ``link`` doesn't return the domain, the syndication framework will insert the domain of the current site, according to your :setting:`SITE_ID setting `.