Add Nox sessions (#167)

* http → https

* Remove benchmarks

* Remove benchmarks

* Add noxfile.py

* http → https

* Add watchdog as dependency

* Update Nox sessions

* Requirement: Nikola → Nikola[extras]

Author: namurphy

conf.py

@@ -25,10 +25,9 @@
 # This is the URL where Nikola's output will be deployed.
 # If not set, defaults to SITE_URL
 BASE_URL = "https://www.plasmapy.org/"
-BENCHMARKS = "http://www.plasmapy.org/plasmapy-benchmarks/"
 CITATION_INSTRUCTIONS = "https://docs.plasmapy.org/en/stable/about/citation.html"
 CODE_OF_CONDUCT = "https://docs.plasmapy.org/en/latest/CODE_OF_CONDUCT.html"
-DOCS = "http://docs.plasmapy.org/"
+DOCS = "https://docs.plasmapy.org/"
 FACEBOOK = "https://www.facebook.com/PlasmaPy-101663168274541"
 FEEDBACK_BOX = "https://docs.google.com/forms/d/e/1FAIpQLSdT3O5iHZrLJRuavFyzoR23PGy0Prfzx2SQOcwJGWtvHyT2lw/viewform?usp=sf_link"
 MAILING_LIST = "https://groups.google.com/forum/#!forum/plasmapy"
@@ -297,7 +296,7 @@
 # FORCE_ISO8601 = False
 
 # Date format used to display post dates. (translatable)
-# Used by babel.dates, CLDR style: http://cldr.unicode.org/translation/date-time
+# Used by babel.dates, CLDR style: https://cldr.unicode.org/translation/date-time
 # You can also use 'full', 'long', 'medium', or 'short'
 # DATE_FORMAT = 'yyyy-MM-dd HH:mm'
 
@@ -360,7 +359,7 @@
 
 # Enable reST directives that insert the contents of external files such
 # as "include" and "raw." This maps directly to the docutils file_insertion_enabled
-# config. See: http://docutils.sourceforge.net/docs/user/config.html#file-insertion-enabled
+# config. See: https://docutils.sourceforge.net/docs/user/config.html#file-insertion-enabled
 # REST_FILE_INSERTION_ENABLED = True
 
 # Create by default posts in one file format?
@@ -812,7 +811,7 @@
 # fields you want to keep in images. (See also PRESERVE_EXIF_DATA)
 #
 # For a full list of field names, please see here:
-# http://www.cipa.jp/std/documents/e/DC-008-2012_E.pdf
+# https://www.cipa.jp/std/documents/e/DC-008-2012_E.pdf
 #
 # This is a dictionary of lists. Each key in the dictionary is the
 # name of a IDF, and each list item is a field you want to preserve.
@@ -992,7 +991,6 @@
     '- <a href="{facebook}">Facebook</a> '
     '- <a href="{youtube}">YouTube</a> '
     '- <a href="{chat}">Chat</a> '
-    '- <a href="{benchmarks}">Benchmarks</a> '
     '- Powered by <a href="https://getnikola.com" rel="nofollow">Nikola</a>'
 )
 
@@ -1020,7 +1018,6 @@
             "facebook": FACEBOOK,
             "youtube": YOUTUBE_CHANNEL,
             "chat": CHAT,
-            "benchmarks": BENCHMARKS,
         },
     )
 }
@@ -1058,7 +1055,7 @@
 # INDEX_FILE = "index.html"
 
 # If a link ends in /index.html,  drop the index.html part.
-# http://mysite/foo/bar/index.html => http://mysite/foo/bar/
+# https://mysite/foo/bar/index.html => https://mysite/foo/bar/
 # (Uses the INDEX_FILE setting, so if that is, say, default.html,
 # it will instead /foo/default.html => /foo)
 STRIP_INDEXES = True
@@ -1088,7 +1085,7 @@
 # DEPLOY_DRAFTS = True
 
 # Allows scheduling of posts using the rule specified here (new_post -s)
-# Specify an iCal Recurrence Rule: http://www.kanzaki.com/docs/ical/rrule.html
+# Specify an iCal Recurrence Rule: https://www.kanzaki.com/docs/ical/rrule.html
 # SCHEDULE_RULE = ''
 # If True, use the scheduling rule to all posts (not pages!) by default
 # SCHEDULE_ALL = False

noxfile.py

@@ -0,0 +1,30 @@
+import nox
+
+nox.options.default_venv_backend = "uv|virtualenv"
+
+
+@nox.session
+def build(session) -> None:
+    """Build the site with Nikola."""
+    session.install("-r", "requirements.txt")
+    session.run("nikola", "build")
+
+
+@nox.session
+def check(session) -> None:
+    """Check links and files in the generated site."""
+    session.install("-r", "requirements.txt")
+    session.run("nikola", "build")
+    session.run(
+        "nikola",
+        "check",
+        "--check-links",
+        "--find-sources",
+    )
+
+
+@nox.session
+def clean(session) -> None:
+    """Remove output files."""
+    session.install("-r", "requirements.txt")
+    session.run("nikola", "clean")

pages/index.md

@@ -88,7 +88,7 @@ If you are unfamiliar with Python, please check out the
 
 ## Learn PlasmaPy
 
-[PlasmaPy's documentation](http://docs.plasmapy.org/en/latest) describes how to use PlasmaPy and provides several [examples](https://docs.plasmapy.org/en/latest/examples.html).
+[PlasmaPy's documentation](https://docs.plasmapy.org/en/latest) describes how to use PlasmaPy and provides several [examples](https://docs.plasmapy.org/en/latest/examples.html).
 
 ## Get Help
 
@@ -100,7 +100,7 @@ longer discussions on more detailed topics.
 
 ## Contribute and Report Bugs
 
-Making [feature requests](https://github.com/PlasmaPy/PlasmaPy/issues/new?template=Feature_request.md), [reporting bugs](https://github.com/PlasmaPy/PlasmaPy/issues/new?template=Bug_report.md), and [offering suggestions](https://docs.google.com/forms/d/e/1FAIpQLSdT3O5iHZrLJRuavFyzoR23PGy0Prfzx2SQOcwJGWtvHyT2lw/viewform) are some of the most helpful ways to contribute to the ongoing development of PlasmaPy.  The documentation discusses how to [contribute code and documentation](http://docs.plasmapy.org/en/latest/CONTRIBUTING.html) to PlasmaPy and contains a [development guide](http://docs.plasmapy.org/en/latest/development/index.html).
+Making [feature requests](https://github.com/PlasmaPy/PlasmaPy/issues/new?template=Feature_request.md), [reporting bugs](https://github.com/PlasmaPy/PlasmaPy/issues/new?template=Bug_report.md), and [offering suggestions](https://docs.google.com/forms/d/e/1FAIpQLSdT3O5iHZrLJRuavFyzoR23PGy0Prfzx2SQOcwJGWtvHyT2lw/viewform) are some of the most helpful ways to contribute to the ongoing development of PlasmaPy.  The documentation discusses how to [contribute code and documentation](https://docs.plasmapy.org/en/latest/CONTRIBUTING.html) to PlasmaPy and contains a [development guide](https://docs.plasmapy.org/en/latest/development/index.html).
 
 ## Acknowledgments
 

requirements.txt

@@ -1,2 +1,2 @@
-Nikola
+Nikola[extras]
 webassets