Hotfixes new tutorial

[astrojuanlu]

Feature or Bugfix

• Bugfix

Purpose

• Fix PDF generation by replacing non-ASCII character
• Fix accidental rewrap

Relates

• Beginning of new Sphinx tutorial #9276 (comment)
• Beginning of new Sphinx tutorial #9276 (comment)

Rendered version: https://sphinx--9339.org.readthedocs.build/en/9339/tutorial/index.html

[astrojuanlu]

@jfbu By the way, I tried make latexpdf for the Sphinx docs and it didn't work even on the 4.0.x branch, where the new tutorial is not present. I guess there is some sort of special procedure to do it, or perhaps I'm missing some TeXLive dependency.

[pradyunsg]

How do you feel about adding / to make it clearer what's a directory and what's not?

Suggested change

	docs
	├── build
	├── make.bat
	├── Makefile
	└── source
	├── conf.py
	├── index.rst
	├── _static
	└── _templates
	docs/
	├── build/
	├── make.bat
	├── Makefile
	└── source/
	├── conf.py
	├── index.rst
	├── _static/
	└── _templates/

[astrojuanlu]

This is the unmodified output of tree, see #9276 (comment)

I don't have strong feelings either way, but I'm pinging @stevepiercy because he reviewed this part in the first PR.

[stevepiercy]

I prefer the unmodified output of tree because it reduces maintenance and the names of directories do not include /.

[pradyunsg]

Hmm... I was wondering why my tree has that by default, and I found that it's because it's aliased to tree -F.

I disagree with some stuff said here but that's water under the bridge now and there's better stuff to spend our collective energy on than trailing slashes! :)

[jfbu]

LGTM with nits

Also the paragraph above the code-block seems to have suffered some reflowing. Isn't it supposed to be displayed as a list?

[jfbu]

I tried make latexpdf for the Sphinx docs and it didn't work even on the 4.0.x branch,

It compiles at my locale. I can't tell more about your problem without seeing the error...

[astrojuanlu]

@jfbu No worries, I'll report the error separately then.

About your review, I think you didn't submit your nitpicks? Also, what paragraph do you refer to?

[jfbu]

oh sorry my nitpicks were only the paragraph issue i.e. https://github.com/sphinx-doc/sphinx/pull/9276/files#r651195319

[jfbu]

LGTM with nits, there is another copy of the offending Unicode character on line 44

Thanks for contribution!

[jfbu]

@jfbu No worries, I'll report the error separately then.

I think you branch does not integrate the #9333 fix currently merged in 4.0.x, so make latexpdf fails. But this does not matter, I tested at my locale merging it additionally, to check and it compiled.

[jfbu]

ah no wait there is yet another reflowed list-into-paragraph near the end

This showcases several features of the reStructuredText syntax, including:

- a **section header** using ``===`` for the underline, - two examples of
  :ref:`rst-inline-markup`: ``**strong emphasis**`` (typically bold) and
  ``*emphasis*`` (typically italics), - an **inline external link**, - and a
  ``note`` **admonition** (one of the available :ref:`directives
  <rst-directives>`)

[jfbu]

On other tidbit is that this syntax:

``build/``

  An empty directory (for now) that will hold the rendered documentation.

``make.bat`` and ``Makefile``

  Convenience scripts to simplify some common Sphinx operations, such as
  rendering the content.

etc...

is rendered using quoting for each item. It is not a description list due to blank lines. Suppressing the blank lines like this

``build/``
  An empty directory (for now) that will hold the rendered documentation.

``make.bat`` and ``Makefile``
  Convenience scripts to simplify some common Sphinx operations, such as
  rendering the content.

etc

I get this in PDF

and in html

but with the white lines I get this (still in html)

notice extra whitespace.

Please remove the extra blank lines.

[astrojuanlu]

Damn, I'm not having a brilliant day today 🤦🏽 thanks for your patience @jfbu. Going through these fixes.

[jfbu]

Damn, I'm not having a brilliant day today 🤦🏽 thanks for your patience @jfbu. Going through these fixes.

don't worry, I did some sloppy reviewing and should have avoided torturing you piecemeal :)

[astrojuanlu]

Done, thanks again @jfbu :)

[jfbu]

LGTM, thanks

I will merge after testing completes