From 1c334cca26092b96c34745b6a8726013819663a2 Mon Sep 17 00:00:00 2001 From: mdtanker Date: Fri, 16 Feb 2024 15:08:42 -0700 Subject: [PATCH] docs: add new docs link warning --- docs/conf.py | 19 +++++-- docs/index.md | 153 +------------------------------------------------- 2 files changed, 16 insertions(+), 156 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 10f545c8..0dee8743 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -114,10 +114,17 @@ "use_repository_button": True, "use_download_button": True, "home_page_in_toc": False, - "logo": { - # "link": "https://github.com/mdtanker/polartoolkit", - "alt_text": "PolarToolkit Logo - Homepage", - "image_light": "logo_light.png", - "image_dark": "logo_dark.png", - }, + # "logo": { + # # "link": "https://github.com/mdtanker/polartoolkit", + # "alt_text": "PolarToolkit Logo - Homepage", + # "image_light": "logo_light.png", + # "image_dark": "logo_dark.png", + # }, + # Announcement banner defined as a string of arbitrary HTML, temporarily + # displayed at the top of each page until the user begins scrolling. + "announcement": ( + "

" + "⚠ī¸ Antarctic-Plots has been renamed to PolarToolkit, please use the updated docs here ⚠ī¸" # noqa: E501 + "

" + ), } diff --git a/docs/index.md b/docs/index.md index 24bbe20c..15612484 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,150 +1,3 @@ -# PolarToolkit - -Helpful tools for polar researchers - -```{include} ../README.md -:start-after: -:end-before: -``` - -```{image} cover_fig.png -:alt: cover figure -:width: 400px -:align: center -``` - -```{admonition} Early-stages of development -:class: seealso - -This package is in early stages of development! This means that we are still adding a lot of new features and sometimes we make changes to the ones we already have while we try to improve the software based on users' experience, test new ideas, make better design decisions, etc. Some of these changes could be **backwards incompatible**. Keep that in mind before you update polartoolkit to a newer version. -``` - - -```{include} ../README.md -:start-after: -:end-before: -``` - - -```{admonition} How to contribute -:class: seealso - -I really welcome all forms of contribution! If you have any questions, comments or suggestions, please open a [discussion]() or [issue (feature request)]() on the [GitHub page](https://github.com/mdtanker/polartoolkit/)! - -Also, please feel free to share how you're using PolarToolkit, I'd love to know. - -Please, read our [Contributor Guide](https://github.com/mdtanker/polartoolkit/blob/main/.github/CONTRIBUTING.md) to learn -how you can contribute to the project. -``` - -```{note} -*Many parts of this documentation was adapted from the* [Fatiando project](https://www.fatiando.org/). -``` - -```{toctree} -:maxdepth: 1 -:hidden: -overview -install -gallery/index.md -tutorial/index.md -``` - - - - - -```{toctree} -:maxdepth: 1 -:hidden: -:caption: Tips -tips.ipynb -``` - -```{toctree} -:maxdepth: 2 -:hidden: -:caption: 📖 Reference documentation -api/polartoolkit -citing.md -changelog.md -references.rst -``` - -```{toctree} -:maxdepth: 1 -:hidden: -:caption: ℹī¸ Other resources -contributing.md -Source code on GitHub -``` - - -::::{grid} 2 -:::{grid-item-card} {octicon}`rocket` Getting started? -:text-align: center -New to PolarToolkit? Start here! -```{button-ref} overview - :click-parent: - :color: primary - :outline: - :expand: -``` -::: - -:::{grid-item-card} {octicon}`comment-discussion` Need help? -:text-align: center -Start a discussion on GitHub! -```{button-link} https://github.com/mdtanker/polartoolkit/discussions - :click-parent: - :color: primary - :outline: - :expand: - Discussions -``` -::: - -:::{grid-item-card} {octicon}`file-badge` Reference documentation -:text-align: center -A list of modules and functions -```{button-ref} api/polartoolkit - :click-parent: - :color: primary - :outline: - :expand: -``` -::: - -:::{grid-item-card} {octicon}`bookmark` Using PolarToolkit for research? -:text-align: center -Citations help support our work -```{button-ref} citing - :click-parent: - :color: primary - :outline: - :expand: -``` -::: -:::: \ No newline at end of file +```{danger} +Antarctic-Plots has been renamed to PolarToolkit, please use the updated docs here +``` \ No newline at end of file