[LaTexWriter] Better spacing between section number and title

[ViralBShah]

No description provided.

[mortenpi]

If I am not mistaken, this would remove the section links everywhere. I don't generally use the PDF documentation, but I feel that if I did, I would find it helpful to be able to jump to the right section? Each .md page of the manual is quite long.

[ViralBShah]

I guess that can be useful to have since the manual is so large. Maybe we just need to improve the spacing for sections in the manual.

@inkydragon Would you know how to do that?

[inkydragon]

improve the spacing for sections in the manual.

Documenter.jl/src/Writers/LaTeXWriter.jl

Lines 248 to 249 in d2ed9b8

	% indent before section number
	\\setlength{\\cftsectionindent}{2.5em \\@plus \\p@}

Maybe inc 2.5em

---

But these style adjustments are julia manual related, not universal, right?

It seems like I need to update this pr JuliaLang/julia#43698.

[ViralBShah]

I think Julia manual is the biggest user of generating pdf docs. Also a bit of extra spacing will not hurt other projects -so I think we should just do it universally. And we should revert my change to TOC depth here- and increase spacing for sections.

[ViralBShah]

Mainly need to fix these two (which should be fixed in Documenter.jl):

[ViralBShah]

Do we not need something like this to increase the spacing between the section number and section title?

\setlength{\cftsectionnumwidth}{2.5em \@plus \p@}

[inkydragon]

Do we not need something like this to increase the spacing between the section number and section title?

Yes, and \setlength{\cftsectionnumwidth}{3.0em \@plus \p@} look good.

—— Figure 9.2, memman

---

With:

\setlength{\cftsectionnumwidth}{3.0em \@plus \p@}

Left: julia#master(dacf9d6) + Documenter.jl#v0.27.15 VS Right with patch

---

PDF building Tips:

• Use Documenter.LaTeX(platform = "none") in make.jl then you got all *.tex files.
• Modify documenter.sty:

% listings
-\usepackage{listings, minted}
+\usepackage{listings}
+\usepackage[draft=true]{minted}

This turns off the highlighting of the code and can greatly speed up the compilation process.

• Compile all *.tex by youself. I recommend using tectonic.

[ViralBShah]

Thanks to your really nice comments in the code, I had indeed found that diagram, which is the most useful documentation!

@inkydragon Does this PR look good? I am using 4.0em to give it a bit more spacing.

[ViralBShah]

It would be nice to add the PDF building tips to Documenter's docs.

[inkydragon]

4.0em VSVS 3.0em

Does this PR look good?

LGTM.

It would be nice to add the PDF building tips to Documenter's docs.

Yes, however, it looks like only julia's manual is slow to compile, so perhaps the PDF building tips should be added to julia's project documentation.

Documenter.jl might need to include a test that has multiple levels of chapters & sections, like julia's manual.

[ViralBShah]

I installed tectonic with homebrew. It doesn't seem to have latex and such commands. Howevever, I have been hearing that people are rapidly adopting tectonic, and we may want to do that ourselves eventually. I had to use the docker method to build the pdf in julia base.

[inkydragon]

It doesn't seem to have latex and such commands.

tectonic -X compile --keep-logs -Z shell-escape  TheJuliaLanguage.tex

And if you want code highlighting, you need install minted: installing - How to install minted in Ubuntu - TeX - LaTeX Stack Exchange

minted needs to call an external program pygments which is a python pkg.

[ViralBShah]

With the tectonic command, I get:

error: ./documenter.sty:4: Package fontspec Error: The font "DejaVu Sans" cannot be found.

For immediate help type H <return>
Writing `TheJuliaLanguage.log` (12.21 KiB)

[ViralBShah]

@mortenpi @fredrikekre Can I go ahead and tag a new release to get these pdf improvements into julia?

[inkydragon]

The font "DejaVu Sans" cannot be found.

Missing fonts

• DejaVuSans.ttf
• DejaVuSansMono.ttf

Install dejavu-fonts on macOS with MacPorts

[ViralBShah]

Appreciate it. Now:

error: _minted-TheJuliaLanguage/681C970CC716FB99FA936E8A6E371DE25218153D23BFA92BF6039169C02165FC.pygtex:2: Undefined control sequence
Writing `TheJuliaLanguage.log` (58.65 KiB)
error: halted on potentially-recoverable error as specified

I have pygments installed.

[inkydragon]

Deleting temporary files and folder _minted-*, then try again.

pdftex - Minted not working - TeX - LaTeX Stack Exchange

[ViralBShah]

Thank you - that worked.