Command to automatically link to MCNP manual

[tjlaboss]

Description

Add a :manual63: command to link to relevant sections of the MCNP6.3 user's manual. Apply it in "Getting Started".

Note that LANL used a nice, predictable subsection naming convention for MCNP6.3, and did not for MCNP6.2.

Motivation: prerequisite to address #413.

Checklist

• I have performed a self-review of my own code
• I have made corresponding changes to the documentation (if applicable)
  • Should I add a note to the developer's guide? If not, then not applicable.

[coveralls]

Pull Request Test Coverage Report for Build 9571905078

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage remained the same at 98.223%

---

Totals
Change from base Build 9550865708:	0.0%
Covered Lines:	5750
Relevant Lines:	5854

---

💛 - Coveralls

[MicahGale]

I ran this locally and was able to get the link to work.

However when I ran make linkcheck I got the error:

(        starting: line  146) broken    https://mcnp.lanl.gov/pdf_files/TechReport_2022_LANL_LA-UR-22-30006Rev.1_KuleszaAdamsEtAl.pdf#subsection.4.4.1 - 'utf-8' codec can't decode byte 0xf6 in position 10: invalid start byte

Please look into this so we can start using make linkcheck as a test.

I think this is a good start. I still want to think of how best to show the manual links in the doc strings.

Also I am ok with overriding the failed tests because:

1. the failed test is a failure in test-reporter, which is due to you being outside the organization. I should see if there's an easy solution, because it will be useless if doesn't work for all external pulls.
2. This is incremental that a changelog entry isn't merited yet.

[MicahGale]

Another issue I found. I think they used \LaTeX and so there's a difference between section and subsection (and probably subsubsection). See https://mcnp.lanl.gov/pdf_files/TechReport_2022_LANL_LA-UR-22-30006Rev.1_KuleszaAdamsEtAl.pdf#section5.2

[MicahGale]

I played around with extending this in #417.

[MicahGale]

I think the developer's guide should be updated in #417, and you don't need to do that here.

[MicahGale]

However when I ran make linkcheck I got the error:

(        starting: line  146) broken    https://mcnp.lanl.gov/pdf_files/TechReport_2022_LANL_LA-UR-22-30006Rev.1_KuleszaAdamsEtAl.pdf#subsection.4.4.1 - 'utf-8' codec can't decode byte 0xf6 in position 10: invalid start byte

I believe this is a bug in sphinx. I was able to replicate this bug with:

In [16]: url = "https://mcnp.lanl.gov/pdf_files/TechReport_2017_LANL_LA-UR-17-29981_WernerArmstrongEtAl.pdf"

In [17]: f = urllib.request.urlopen(url)

In [18]: file = f.read()

In [19]: file.decode()
---------------------------------------------------------------------------
UnicodeDecodeError                        Traceback (most recent call last)
Cell In[19], line 1
----> 1 file.decode()

UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe2 in position 10: invalid continuation byte

So don't worry about that.

[MicahGale]

sphinx-doc/sphinx#11041