Revert "Support and prefer .jinja to _t for static templates (#11165)" (#11329)

This reverts commit 5d13215.

Author: jayaddison

CHANGES

@@ -23,11 +23,6 @@ Deprecated
 ----------
 
 * #11247: Deprecate the legacy ``intersphinx_mapping`` format
-* #11165: Warn when the ``_t`` suffix is used for template files. The formal
-  deprecation process will begin no earlier than 31 December 2024.
-  Templates should change to use the ``.jinja`` filename suffix instead.
-  For more information, see :ref:`theming-static-templates`.
-  Patch by James Addison and Adam Turner
 
 Features added
 --------------
@@ -65,10 +60,6 @@ Features added
   ``= 'xelatex'``.  Patch by Dimitar Dimitrov
 * #11109, #9643: Add :confval:`python_display_short_literal_types` option for
   condensed rendering of ``Literal`` types.
-* #11165: Support the `officially recommended`_ ``.jinja`` suffix for template
-  files. Patch by James Addison
-
-  .. _officially recommended: https://jinja.palletsprojects.com/en/latest/templates/#template-file-extension
 
 Bugs fixed
 ----------

doc/development/theming.rst

@@ -603,8 +603,7 @@ def build_content(self) -> None:
                                             html.escape(self.refnodes[0]['refuri'])))
 
         # write the project file
-        content_t = path.join(self.template_dir, 'content.opf.jinja')
-        copy_asset_file(content_t, self.outdir, metadata)
+        copy_asset_file(path.join(self.template_dir, 'content.opf_t'), self.outdir, metadata)
 
     def new_navpoint(self, node: dict[str, Any], level: int, incr: bool = True) -> NavPoint:
         """Create a new entry in the toc from the node at given level."""
@@ -687,7 +686,7 @@ def build_toc(self) -> None:
         navpoints = self.build_navpoints(refnodes)
         level = max(item['level'] for item in self.refnodes)
         level = min(level, self.config.epub_tocdepth)
-        copy_asset_file(path.join(self.template_dir, 'toc.ncx.jinja'), self.outdir,
+        copy_asset_file(path.join(self.template_dir, 'toc.ncx_t'), self.outdir,
                         self.toc_metadata(level, navpoints))
 
     def build_epub(self) -> None:

doc/latex.rst

@@ -133,10 +133,10 @@ def hl(no: int, line: str) -> str:
                 f.write(self.templates.render('changes/rstsource.html', ctx))
         themectx = {'theme_' + key: val for (key, val) in
                     self.theme.get_options({}).items()}
-        default_t = path.join(package_dir, 'themes', 'default', 'static', 'default.css.jinja')
-        copy_asset_file(default_t, self.outdir, context=themectx, renderer=self.templates)
-        basic = path.join(package_dir, 'themes', 'basic', 'static', 'basic.css')
-        copy_asset_file(basic, self.outdir)
+        copy_asset_file(path.join(package_dir, 'themes', 'default', 'static', 'default.css_t'),
+                        self.outdir, context=themectx, renderer=self.templates)
+        copy_asset_file(path.join(package_dir, 'themes', 'basic', 'static', 'basic.css'),
+                        self.outdir)
 
     def hl(self, text: str, version: str) -> str:
         text = html.escape(text)

sphinx/builders/_epub_base.py

@@ -184,7 +184,7 @@ def build_navigation_doc(self) -> None:
             # 'includehidden'
             refnodes = self.refnodes
         navlist = self.build_navlist(refnodes)
-        copy_asset_file(path.join(self.template_dir, 'nav.xhtml.jinja'), self.outdir,
+        copy_asset_file(path.join(self.template_dir, 'nav.xhtml_t'), self.outdir,
                         self.navigation_doc_metadata(navlist))
 
         # Add nav.xhtml to epub file

sphinx/builders/changes.py

@@ -283,7 +283,7 @@ def finish(self) -> None:
             ensuredir(path.join(self.outdir, path.dirname(textdomain)))
 
             context['messages'] = list(catalog)
-            content = GettextRenderer(outdir=self.outdir).render('message.pot.jinja', context)
+            content = GettextRenderer(outdir=self.outdir).render('message.pot_t', context)
 
             pofn = path.join(self.outdir, textdomain + '.pot')
             if should_write(pofn, content):

sphinx/builders/epub3.py

@@ -402,7 +402,7 @@ def copy_support_files(self) -> None:
         # use pre-1.6.x Makefile for make latexpdf on Windows
         if os.name == 'nt':
             staticdirname = path.join(package_dir, 'texinputs_win')
-            copy_asset_file(path.join(staticdirname, 'Makefile.jinja'),
+            copy_asset_file(path.join(staticdirname, 'Makefile_t'),
                             self.outdir, context=context)
 
     @progress_message(__('copying additional files'))
@@ -441,7 +441,7 @@ def write_message_catalog(self) -> None:
         if self.context['babel'] or self.context['polyglossia']:
             context['addtocaptions'] = r'\addto\captions%s' % self.babel.get_language()
 
-        filename = path.join(package_dir, 'templates', 'latex', 'sphinxmessages.sty.jinja')
+        filename = path.join(package_dir, 'templates', 'latex', 'sphinxmessages.sty_t')
         copy_asset_file(filename, self.outdir, context=context, renderer=LaTeXRenderer())
 
 

sphinx/builders/gettext.py

@@ -370,29 +370,29 @@ def write_file(fpath: str, content: str, newline: str | None = None) -> None:
             if 'quiet' not in d:
                 print(__('File %s already exists, skipping.') % fpath)
 
-    conf_path = os.path.join(templatedir, 'conf.py.jinja') if templatedir else None
+    conf_path = os.path.join(templatedir, 'conf.py_t') if templatedir else None
     if not conf_path or not path.isfile(conf_path):
-        conf_path = os.path.join(package_dir, 'templates', 'quickstart', 'conf.py.jinja')
+        conf_path = os.path.join(package_dir, 'templates', 'quickstart', 'conf.py_t')
     with open(conf_path, encoding="utf-8") as f:
         conf_text = f.read()
 
     write_file(path.join(srcdir, 'conf.py'), template.render_string(conf_text, d))
 
     masterfile = path.join(srcdir, d['master'] + d['suffix'])
-    if template._has_custom_template('quickstart/master_doc.rst.jinja'):
+    if template._has_custom_template('quickstart/master_doc.rst_t'):
         msg = ('A custom template `master_doc.rst_t` found. It has been renamed to '
                '`root_doc.rst_t`.  Please rename it on your project too.')
         print(colorize('red', msg))
-        write_file(masterfile, template.render('quickstart/master_doc.rst.jinja', d))
+        write_file(masterfile, template.render('quickstart/master_doc.rst_t', d))
     else:
-        write_file(masterfile, template.render('quickstart/root_doc.rst.jinja', d))
+        write_file(masterfile, template.render('quickstart/root_doc.rst_t', d))
 
     if d.get('make_mode') is True:
-        makefile_template = 'quickstart/Makefile.new.jinja'
-        batchfile_template = 'quickstart/make.bat.new.jinja'
+        makefile_template = 'quickstart/Makefile.new_t'
+        batchfile_template = 'quickstart/make.bat.new_t'
     else:
-        makefile_template = 'quickstart/Makefile.jinja'
-        batchfile_template = 'quickstart/make.bat.jinja'
+        makefile_template = 'quickstart/Makefile_t'
+        batchfile_template = 'quickstart/make.bat_t'
 
     if d['makefile'] is True:
         d['rsrcdir'] = 'source' if d['sep'] else '.'

sphinx/builders/latex/__init__.py

@@ -62,31 +62,3 @@ def __getattr__(name):
 
     warnings.warn(message + " Check CHANGES for Sphinx API modifications.",
                   warning_class, stacklevel=3)
-
-
-class OldJinjaSuffixWarning(PendingDeprecationWarning):
-    """Warning class for ``_old_jinja_template_suffix_warning``.
-
-    This class exists only so that extensions and themes can silence the legacy
-    filename warning via Python's `warning control`_ mechanisms. See
-    :ref:`theming-static-templates` for an example.
-
-    This warning class will be removed, and the warning class changed to the
-    appropriate RemovedInSphinx_0Warning no earlier than 31 December 2024, at
-    which point the standard deprecation process for ``_t`` template suffixes
-    will start.
-
-    .. _warning control: https://docs.python.org/3/library/warnings.html#the-warnings-filter
-    """
-
-
-def _old_jinja_template_suffix_warning(filename: str) -> None:
-    if filename.endswith('_t'):
-        warnings.warn(
-            f"{filename!r}: the '_t' suffix for Jinja templates is deprecated. "
-            "If the file is a template, use the suffix '.jinja' instead. "
-            'For more information, see '
-            'https://www.sphinx-doc.org/en/master/development/theming.html#static-templates',
-            OldJinjaSuffixWarning,
-            stacklevel=3,
-        )