From 591d68115ded5672750b7426fd31f006c162a7ea Mon Sep 17 00:00:00 2001 From: Nicholas Landry Date: Thu, 4 May 2023 11:41:18 -0400 Subject: [PATCH] Update sphinx (#350) * update sphinx theme * update docs requirements * update * updated the landing page for GH, PyPI, and RTD * redundant * change back to sphinx_rtd_theme * change sphinx-rtd-theme version --- README.md | 56 ++++++++++++------------------- docs/source/conf.py | 6 ++-- docs/source/index.rst | 60 +++++++++++++++++++++------------- long_description.rst | 37 +++++++++++++++------ requirements/documentation.txt | 4 +-- 5 files changed, 89 insertions(+), 74 deletions(-) diff --git a/README.md b/README.md index 99c73a2d7..d4a67a1df 100644 --- a/README.md +++ b/README.md @@ -16,15 +16,14 @@ Sign up for our [mailing list](http://eepurl.com/igE6ez) and follow XGI on [Twit ## Table of Contents: - [Installation](#installation) - [Getting Started](#getting-started) - - [Documentation](#documentation) + - [How to Contribute](#contributing) - [Corresponding Data](#corresponding-data) - - [Contributing](#contributing) - [How to Cite](#how-to-cite) - - [Code of Conduct](#code-of-conduct) - [License](#license) - [Funding](#funding) - [Other Resources](#other-resources) + ## Installation XGI runs on Python 3.8 or higher. @@ -45,35 +44,31 @@ pip install -e .["all"] pip install -e .\[all\] ```` -## Getting Started +## Getting Started To get started, take a look at the [tutorials](/tutorials/) illustrating the library's basic functionality. -## Documentation - -For more documentation, see our [Read The Docs](https://xgi.readthedocs.io/en/latest/) page. ## Corresponding Data - A number of higher-order datasets are available in the [XGI-DATA repository](https://gitlab.com/complexgroupinteractions/xgi-data) and can be easily accessed with the `load_xgi_data()` function. -## Contributing + +## How to Contribute If you want to contribute to this project, please make sure to read the -[code of conduct](CODE_OF_CONDUCT.md) -and the [contributing guidelines](CONTRIBUTING.md). +[contributing guidelines](CONTRIBUTING.md). We expect respectful and kind interactions by all contributors and users as laid out in our [code of conduct](CODE_OF_CONDUCT.md). -The best way to contribute to XGI is by submitting a bug or request a new feature by -opening a [new issue](https://github.com/xgi-org/xgi/issues/new). +The XGI community always welcomes contributions, no matter how small. We're happy to help troubleshoot XGI issues you run into, assist you if you would like to add functionality or fixes to the codebase, or answer any questions you may have. -To get more actively involved, you are invited to browse the [issues page](../../issues) and choose one that you can -work on. The core developers will be happy to help you understand the codebase and any -other doubts you may have while working on your contribution. +Some concrete ways that you can get involved: -If you are interested in the daily goings-on of XGI, you are invited to join our [Zulip -channel](https://xgi.zulipchat.com/join/7agfwo7dh7jo56ppnk5kc23r/). +* **Get XGI updates** by following the XGI [Twitter](https://twitter.com/xginets) account, signing up for our [mailing list](http://eepurl.com/igE6ez), or starring this repository. +* **Spread the word** when you use XGI by sharing with your colleagues and friends. +* **Request a new feature or report a bug** by raising a [new issue](https://github.com/xgi-org/xgi/issues/new). +* **Create a Pull Request (PR)** to address an [open issue](../../issues) or add a feature. +* **Join our [Zulip channel](https://xgi.zulipchat.com/join/7agfwo7dh7jo56ppnk5kc23r/)** to be a part of the daily goings-on of XGI. -## How to Cite +## How to Cite We acknowledge the importance of good software to support research, and we note that research becomes more valuable when it is communicated effectively. To demonstrate the value of XGI, we ask that you cite XGI in your work. @@ -82,28 +77,19 @@ Currently, the best way to cite XGI is to go to our click the "cite this repository" button on the right sidebar. This will generate a citation in your preferred format, and will also integrate well with citation managers. -## Code of Conduct - -Our full code of conduct, and how we enforce it, can be read in [our repository](CODE_OF_CONDUCT.md). ## License Released under the 3-Clause BSD license (see [`LICENSE.md`](LICENSE.md)) Copyright (C) 2021-2023 XGI Developers -Nicholas Landry - -Leo Torres - -Iacopo Iacopini - -Maxime Lucas - -Giovanni Petri - -Alice Patania - -Alice Schwarze +* Nicholas Landry +* Leo Torres +* Iacopo Iacopini +* Maxime Lucas +* Giovanni Petri +* Alice Patania +* Alice Schwarze The XGI library has copied or modified code from the HyperNetX and NetworkX libraries, the licenses of which can be found in our [license file](LICENSE.md) diff --git a/docs/source/conf.py b/docs/source/conf.py index d769cef66..d80044bcb 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -43,7 +43,7 @@ # # This is also used if you do content translation via gettext catalogs. # Usually you set "language" from the command line for these cases. -language = None +language = "en" # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. @@ -105,7 +105,7 @@ # # This is also used if you do content translation via gettext catalogs. # Usually you set "language" from the command line for these cases. -language = None +language = "en" # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: @@ -150,9 +150,7 @@ # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. -# html_theme = 'nature' html_theme = "sphinx_rtd_theme" -# html_theme = 'pyramid' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the diff --git a/docs/source/index.rst b/docs/source/index.rst index 2fa0e611a..f5800c944 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -64,8 +64,8 @@ designed and developed by network scientists with the needs of network scientist mind. - Repository: https://github.com/xgi-org/xgi -- PyPI: https://pypi.org/project/xgi/ -- Documentation: https://xgi.readthedocs.io/ +- PyPI: `latest release `_ +- Twitter: `@xginets `_ Sign up for our `mailing list `_ and follow XGI on `Twitter `_ or `Mastodon `_! @@ -93,12 +93,44 @@ If that command does not work, you may try the following instead XGI was developed and tested for Python 3.8-3.11 on Mac OS, Windows, and Ubuntu. + Corresponding Data ================== A number of higher-order datasets are available in the `XGI-DATA repository `_ and can be easily accessed with the ``load_xgi_data()`` function. +Contributing +============ + +If you want to contribute to this project, please make sure to read the +`contributing guidelines `_. +We expect respectful and kind interactions by all contributors and users +as laid out in our `code of conduct `_. + +The XGI community always welcomes contributions, no matter how small. +We're happy to help troubleshoot XGI issues you run into, +assist you if you would like to add functionality or fixes to the codebase, +or answer any questions you may have. + +Some concrete ways that you can get involved: + +* **Get XGI updates** by following the XGI `Twitter `_ account, signing up for our `mailing list `_, or starring this repository. +* **Spread the word** when you use XGI by sharing with your colleagues and friends. +* **Request a new feature or report a bug** by raising a `new issue `_. +* **Create a Pull Request (PR)** to address an `open issue <../../issues>`_ or add a feature. +* **Join our Zulip channel** to be a part of the `daily goings-on of XGI `_. + +How to Cite +=========== +We acknowledge the importance of good software to support research, and we note +that research becomes more valuable when it is communicated effectively. To +demonstrate the value of XGI, we ask that you cite XGI in your work. +Currently, the best way to cite XGI is to go to our +`repository page `_ and +click the "cite this repository" button on the right sidebar. This will generate +a citation in your preferred format, and will also integrate well with citation managers. + Academic References =================== @@ -119,27 +151,6 @@ Academic References Rosvall, and Ingo Scholtes. -Contributing -============ - -If you want to contribute to this project, please make sure to read the -`code of conduct -`_ -and the `contributing guidelines -`_. - -The best way to contribute to XGI is by submitting a bug or request a new feature by -opening a `new issue `_. - -To get more actively involved, you are invited to browse the `issues page -`_ and choose one that you can -work on. The core developers will be happy to help you understand the codebase and any -other doubts you may have while working on your contribution. - -If you are interested in the daily goings-on of XGI, you are invited to join our `Zulip -channel `_. - - Contributors ============ @@ -159,6 +170,9 @@ Other contributors: * Tim LaRock * Sabina Adhikari * Marco Nurisso +* Alexis Arnaudon +* Thomas Robiglio +* Gonzalo Contreras Aso Funding ======= diff --git a/long_description.rst b/long_description.rst index 95dd898b8..2e63b2d2a 100644 --- a/long_description.rst +++ b/long_description.rst @@ -4,8 +4,12 @@ XGI .. image:: https://github.com/xgi-org/xgi/raw/main/logo/logo.svg :width: 200 -CompleX Group Interactions (XGI) is a Python package for the representation, manipulation, -and study of the structure, dynamics, and functions of complex systems with group (higher-order) interactions. +XGI is a Python package for higher-order networks. + +Comple**X** **G**roup **Interactions** (XGI) provides an ecosystem for the +representation, manipulation, and study of the +structure, dynamics, and functions of +complex systems with group (higher-order) interactions. Installation ------------ @@ -29,12 +33,29 @@ Getting Started To get started, take a look at the `tutorials `_ illustrating the library's basic functionality. +Corresponding Data +------------------ +A number of higher-order datasets are available in the `XGI-DATA repository `_ and can be easily accessed with the ``load_xgi_data()`` function. + Contributing ------------ -Contributions are always welcome. Please report any bugs that you find `here `_. -Or, even better, fork the repository on `GitHub `_ and create a pull request (PR). -We welcome all changes, big or small, and we will help you make the PR if you are new to `git` -(just ask on the issue and/or see our `contributing guidelines `_. +If you want to contribute to this project, please make sure to read the +`contributing guidelines `_. +We expect respectful and kind interactions by all contributors and users +as laid out in our `code of conduct `_. + +The XGI community always welcomes contributions, no matter how small. +We're happy to help troubleshoot XGI issues you run into, +assist you if you would like to add functionality or fixes to the codebase, +or answer any questions you may have. + +Some concrete ways that you can get involved: + +* **Get XGI updates** by following the XGI `Twitter `_ account, signing up for our `mailing list `_, or starring this repository. +* **Spread the word** when you use XGI by sharing with your colleagues and friends. +* **Request a new feature or report a bug** by raising a `new issue `_. +* **Create a Pull Request (PR)** to address an `open issue <../../issues>`_ or add a feature. +* **Join our Zulip channel** to be a part of the `daily goings-on of XGI `_. How to Cite ----------- @@ -46,10 +67,6 @@ Currently, the best way to cite XGI is to go to our click the "cite this repository" button on the right sidebar. This will generate a citation in your preferred format, and will also integrate well with citation managers. -Code of Conduct ---------------- -Our full code of conduct, and how we enforce it, can be read in `our repository `_. - License ------- Released under the 3-Clause BSD license (see the `license file `_) diff --git a/requirements/documentation.txt b/requirements/documentation.txt index acd17e769..c6437acfd 100644 --- a/requirements/documentation.txt +++ b/requirements/documentation.txt @@ -1,6 +1,6 @@ -sphinx~=4.0 +sphinx~=6.0 sphinx_copybutton -sphinx-rtd-theme>=0.4.2 +sphinx-rtd-theme>=1.2 numpydoc>=1.1 pillow>=8.2 matplotlib>=3.3 \ No newline at end of file