From 5cc221f77d50a9faa7b2090fff9c45f908ece9c9 Mon Sep 17 00:00:00 2001 From: Nick Murphy Date: Mon, 12 Jan 2026 16:57:08 -0500 Subject: [PATCH 1/6] pre-commit autoupdate --- .pre-commit-config.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 99729b58..2c5eb6f6 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -50,7 +50,7 @@ repos: - id: forbid-bidi-controls - repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks - rev: v2.15.0 + rev: v2.16.0 hooks: - id: pretty-format-ini args: [--autofix] @@ -63,7 +63,7 @@ repos: exclude: .github/labeler.yml|.pre-commit-search-and-replace.yaml - repo: https://github.com/astral-sh/ruff-pre-commit - rev: v0.14.10 + rev: v0.14.11 hooks: - id: ruff name: ruff (see https://docs.astral.sh/ruff/rules) From 626e904a8f24316c31b56280ab1bb590f0a24eeb Mon Sep 17 00:00:00 2001 From: Nick Murphy Date: Mon, 12 Jan 2026 16:59:01 -0500 Subject: [PATCH 2/6] Update ruff hooks --- .pre-commit-config.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 2c5eb6f6..e97b215e 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -65,8 +65,8 @@ repos: - repo: https://github.com/astral-sh/ruff-pre-commit rev: v0.14.11 hooks: - - id: ruff - name: ruff (see https://docs.astral.sh/ruff/rules) + - id: ruff-check + name: ruff-check (see https://docs.astral.sh/ruff/rules) args: [--fix] - id: ruff-format name: autoformat source code with ruff formatter From e776e0aa475b38df8197a2d69a7d7fbf0eca937f Mon Sep 17 00:00:00 2001 From: Nick Murphy Date: Mon, 12 Jan 2026 16:59:10 -0500 Subject: [PATCH 3/6] Add hook for mdformat --- .pre-commit-config.yaml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index e97b215e..12b41f45 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -70,3 +70,10 @@ repos: args: [--fix] - id: ruff-format name: autoformat source code with ruff formatter + +- repo: https://github.com/hukkin/mdformat + rev: 1.0.0 + hooks: + - id: mdformat + additional_dependencies: + - mdformat-gfm From fbdf2e23a93173a836b12eb2383c54d7720b34b1 Mon Sep 17 00:00:00 2001 From: Nick Murphy Date: Mon, 12 Jan 2026 17:01:52 -0500 Subject: [PATCH 4/6] Apply mdformat changes --- CONTRIBUTING.md | 30 ++-- LICENSE.md | 8 +- pages/about.md | 8 +- pages/affiliates/index.md | 6 +- pages/index.md | 41 ++--- pages/license.md | 8 +- .../1st_workshop_2020_at_bryn_mawr/index.md | 141 +++++++++--------- .../aps/62nd_dpp_mini_conf_followups.md | 3 +- pages/meetings/index.md | 7 +- pages/meetings/magnetus2023.md | 27 ++-- pages/meetings/summer-school-2024.md | 12 +- pages/meetings/weekly.md | 13 +- plugins/localsearch/README.md | 8 +- posts/plasmapy-v060-release.md | 24 +-- 14 files changed, 176 insertions(+), 160 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 654326c1..2132d227 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -3,9 +3,9 @@ ## Prerequisites [PlasmaPy's website](https://www.plasmapy.org) is built using the -[Nikola](https://getnikola.com/) static website generator. In order to build +[Nikola](https://getnikola.com/) static website generator. In order to build the website locally on your computer, you will need to [install -Nikola](https://getnikola.com/getting-started.html#install). This may +Nikola](https://getnikola.com/getting-started.html#install). This may be done for your local Python installation using `pip`. ```bash @@ -14,9 +14,9 @@ pip install nikola ## Resources - - [git](https://git-scm.com/) - - [Nikola documentation](https://getnikola.com/documentation.html) - - [Markdown guide](https://www.markdownguide.org/) +- [git](https://git-scm.com/) +- [Nikola documentation](https://getnikola.com/documentation.html) +- [Markdown guide](https://www.markdownguide.org/) ## Getting started @@ -25,7 +25,7 @@ contribution of code or content to PlasmaPy's website. 1. [Create a fork](https://help.github.com/en/github/getting-started-with-github/fork-a-repo) of the [PlasmaPy/plasmapy.github.io repository](https://github.com/PlasmaPy/plasmapy.github.io) on GitHub. -2. [Clone your fork](https://help.github.com/en/github/getting-started-with-github/fork-a-repo#step-2-create-a-local-clone-of-your-fork) using [git](https://git-scm.com/), and enter the directory. +1. [Clone your fork](https://help.github.com/en/github/getting-started-with-github/fork-a-repo#step-2-create-a-local-clone-of-your-fork) using [git](https://git-scm.com/), and enter the directory. ```bash git clone https://github.com/username/plasmapy.github.io.git @@ -52,11 +52,11 @@ Nikola's source files are located on the `main` git branch, and the built HTML f 1. Fetch the most recent updates to the repository. - ```bash - git fetch --all - ``` + ```bash + git fetch --all + ``` -2. Create and check out a branch based off of the +1. Create and check out a branch based off of the [`main`](https://github.com/PlasmaPy/plasmapy.github.io/tree/main) branch of the upstream repository, and connect it to a new branch in your fork on GitHub. @@ -66,7 +66,7 @@ Nikola's source files are located on the `main` git branch, and the built HTML f git push --set-upstream origin new-branch-name ``` -3. Make and commit changes in the `pages/` directory. Most of the pages +1. Make and commit changes in the `pages/` directory. Most of the pages are in `pages/` while blog posts are in `web/posts/`. ```bash @@ -76,15 +76,17 @@ Nikola's source files are located on the `main` git branch, and the built HTML f Pages and posts are written in [Markdown](https://www.markdownguide.org/). -4. Build and preview the website using +1. Build and preview the website using ```bash nikola auto --browser -6. [Create a pull request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) + ``` + +1. [Create a pull request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) to the `main` branch. -7. The website will be rebuilt automatically after the pull request is merged. +1. The website will be rebuilt automatically after the pull request is merged. After five to ten minutes, check that the website is functioning nominally. ## Getting help diff --git a/LICENSE.md b/LICENSE.md index ef37d2ab..8f0ac1c3 100644 --- a/LICENSE.md +++ b/LICENSE.md @@ -2,7 +2,7 @@ Source code files and code snippets included in this project are licensed under a [BSD 3-clause license with a patent -grant](#bsd-3-clause-license-with-patent-grant). All other content in +grant](#bsd-3-clause-license-with-patent-grant). All other content in this project, including content produced directly from unmodified source code and code snippets, is licensed under a [Creative Commons Attribution 4.0 International (CC BY 4.0) @@ -16,14 +16,14 @@ Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: -* Redistributions of source code must retain the above copyright +- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. -* Redistributions in binary form must reproduce the above copyright +- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. -* Neither the name of PlasmaPy nor the names of its contributors may +- Neither the name of PlasmaPy nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. diff --git a/pages/about.md b/pages/about.md index a227bfe2..3fdb613b 100644 --- a/pages/about.md +++ b/pages/about.md @@ -4,13 +4,13 @@ hidetitle: False # About PlasmaPy -[Astropy]: https://www.astropy.org -[PlasmaPy core package]: https://docs.plasmapy.org - The mission of the PlasmaPy Project is to foster the creation of a fully open source software ecosystem for plasma research and -education. The [PlasmaPy core package] intends to be for plasma +education. The [PlasmaPy core package] intends to be for plasma science what [Astropy] is for astronomy — a collection of functionality commonly used and shared between plasma physicists and researchers globally, running within and leveraging the open source scientific Python ecosystem. + +[astropy]: https://www.astropy.org +[plasmapy core package]: https://docs.plasmapy.org diff --git a/pages/affiliates/index.md b/pages/affiliates/index.md index 00c76b79..697b9ab5 100644 --- a/pages/affiliates/index.md +++ b/pages/affiliates/index.md @@ -5,8 +5,8 @@ author: Erik T. Everson PlasmaPy's charter includes promoting open source software for all of the plasma community, and not just PlasmaPy. The entire community benefits when there are multiple efforts trying to build functionality for all -aspects of the plasma field. As such, we want to promote any ongoing effort. This -page displays projects that have requested to be shown. If you want your +aspects of the plasma field. As such, we want to promote any ongoing effort. This +page displays projects that have requested to be shown. If you want your project include, and increase its visibility, then please submit a request to . @@ -15,6 +15,6 @@ All projects/packages are considered **Community Packages** PlasmaPy interoperability are marked as **Affiliated Packages** {{% affiliated_shield %}}. ----- +______________________________________________________________________ {{% build_affiliated_pkg_list %}} diff --git a/pages/index.md b/pages/index.md index 3101b340..4d2ebab8 100644 --- a/pages/index.md +++ b/pages/index.md @@ -1,25 +1,8 @@ title: The PlasmaPy Project hidetitle: True -[conda]: https://docs.conda.io/en/latest -[pip]: https://pip.pypa.io/en/stable -[code contribution workflow]: https://docs.plasmapy.org/en/latest/contributing/workflow.html -[coding guidelines]: https://docs.plasmapy.org/en/latest/contributing/coding_guide.html -[community meeting]: https://www.plasmapy.org/meetings/weekly/ -[**contributor guide**]: https://docs.plasmapy.org/en/latest/contributing/index.html -[feature requests]: https://github.com/PlasmaPy/PlasmaPy/issues/new?assignees=&labels=feature+request&projects=&template=feature_request.yml -[gallery of example notebooks]: https://docs.plasmapy.org/en/stable/examples.html -[getting ready to contribute]: https://docs.plasmapy.org/en/latest/contributing/getting_ready.html -[GitHub Discussions]: https://github.com/PlasmaPy/PlasmaPy/discussions -[installation instructions]: https://docs.plasmapy.org/en/latest/install.html -[many ways to contribute]: https://docs.plasmapy.org/en/latest/contributing/many_ways.html -[PlasmaPy's documentation]: https://docs.plasmapy.org/en/stable -[Python]: https://www.python.org -[submitting bug reports]: https://github.com/PlasmaPy/PlasmaPy/issues/new?assignees=&labels=Bug&projects=&template=bug_report.yml -[writing documentation]: https://docs.plasmapy.org/en/latest/contributing/doc_guide.html -[writing tests]: https://docs.plasmapy.org/en/latest/contributing/testing_guide.html - +