Move LATEX_PREAMBLE to separate file nbsphinx.sty

[mgeier]

This moves all the LaTeX code into a separate file.

The LaTeX code is unchanged, except I have removed all the \makeatletter and \makeatother invocations.

I'm not sure if the \RequirePackage{sphinx} has to be there, but I guess it doesn't hurt, right?

@jfbu If you have time, may I ask you to have a look if the nbsphinx.sty file makes sense in your expert opinion? The main content didn't change, so no need to check this, it's mostly about the \ProvidesPackage and \RequirePackage.

[mgeier]

Generated PDF: https://output.circle-artifacts.com/output/job/aa09ed13-e096-405e-9302-60c9ee4a41e3/artifacts/0/nbsphinx.pdf

[mgeier]

Thanks as always @jfbu, you are the best!

that LaTeX packages have a "v" before the version number seems to be a community habit

I don't really care about the version number, I've just seen it written like this in some example (but now that you mention it, I think I have also seen it without the "v", and maybe even without a version number?).

So what should I do?

Should I remove the "v"? Should I remove the whole version number?

I already opted for not keeping it synchronized with the main version number, because I think this would be too much maintenance work.

I don't need the version number, and if LaTeX doesn't need it either, I might as well remove it?

Whenever the file changes in the future it should be enough to update the date, right?

[jfbu]

Whenever the file changes in the future it should be enough to update the date, right?

Yes, only the date is needed as a general demand on LaTeX package authors. This is to allow users, or rather authors of other packages to require your package at some minimal date, presumably to be sure it will be at a version containing such or such feature.

But the complete truth is that you may completely drop the square brackets and stuff after your \ProvidesPackage. LaTeX will accept ̀\ProvidesPackage{nbsphinx}.

Your nbsphinx.sty is not a priori destined to be downloadable from CTAN as an independent package that arbitrary LaTeX users will use in their documents. Only the elite people using Sphinx will have it (and most of the time will remain blissfully unaware) in their make latex build repertory.

File nbsphinx.sty:

\ProvidesPackage{nbsphinx}

% nothing here

\endinput

file test.tex:

\documentclass{article}

\usepackage{nbsphinx}

\listfiles

\begin{document}
Nothing
\end{document}

Then execute pdflatex test. Nothing bad happens and console output displays (and log contains):

*File List*
 article.cls    2022/07/02 v1.4n Standard LaTeX document class
  size10.clo    2022/07/02 v1.4n Standard LaTeX file (size option)
nbsphinx.sty    
l3backend-pdftex.def    2023-01-16 L3 backend support: PDF output (pdfTeX)
 ***********

which is a bit silent and mysterious but ok. So for minimizing maintenance you may either do as above or only include a short description and not even insert a date.

If I deliberately use \usepackage{nbsphinx}[2023/01/01] in my test.tex I get only a warning

LaTeX Warning: You have requested, on input line 3, version
               `2023/01/01' of package nbsphinx,
               but only version
               `'
               is available.

but it is not Sphinx who will add a date requirement.

Perhaps some other extension builds in the future upon nbsphinx LaTeX code and they need some feature you added at some date... but then they may as well require nbsphinx itself at some version via their pip requirements so...

[jfbu]

I already opted for not keeping it synchronized with the main version number, because I think this would be too much maintenance work.

I can only confirm. At Sphinx it is really a pain simply to worry about ̀ sphinx.sty and there are quite a few other .sty files (for most I used ̀\ProvidesFile and then \input from sphinx.sty however I should perhaps have used \ProvidesPackage and \RequirePackage for a bit neater log files ; but I am probably the sole individual on this Earth reading the log files from Sphinx LaTeX builds... )

[mgeier]

Thanks for the detailed analysis!

I have removed the version number but opted for keeping the date and short description for your log-file-reading convenience.

I am probably the sole individual on this Earth reading the log files from Sphinx LaTeX builds... )

That seems very likely.