nebari-jupyterhub-theme


Namenebari-jupyterhub-theme JSON
Version 2023.4.1 PyPI version JSON
download
home_page
SummaryNebari JupyterHub theme
upload_time2023-04-10 21:32:55
maintainerNebari development team
docs_urlNone
author
requires_python>=3.8
license
keywords jupyterhub theme
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
<picture>
  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/nebari-dev/nebari-design/main/logo-mark/horizontal/Nebari-Logo-Horizontal-Lockup.svg">
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nebari-dev/nebari-design/main/logo-mark/horizontal/Nebari-Logo-Horizontal-Lockup-White-text.svg">
  <img alt="Nebari logo mark - text will be black in light color mode and white in dark color mode." src="https://raw.githubusercontent.com/nebari-dev/nebari-design/main/logo-mark/horizontal/Nebari-Logo-Horizontal-Lockup-White-text.svg" width="50%"/>
</picture>
</p>

| Information | Links                                                                                                                                                                                                                                                                                                                                                                                                                   |
| :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Project     | [![License](https://img.shields.io/badge/License-BSD%203--Clause-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://opensource.org/licenses/BSD-3-Clause) [![Nebari documentation](https://img.shields.io/badge/%F0%9F%93%96%20Read-the%20docs-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://nebari.dev) [![PyPI package version](https://img.shields.io/pypi/v/nebari-jupyterhub-theme.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://pypi.org/project/nebari-jupyterhub-theme/) |
| Community   | [![GH discussions](https://img.shields.io/badge/%F0%9F%92%AC%20-Participate%20in%20discussions-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://github.com/nebari-dev/nebari/discussions) [![Open an issue](https://img.shields.io/badge/%F0%9F%93%9D%20Open-an%20issue-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://github.com/nebari-dev/nebari-jupyterhub-theme/issues/new/choose) [![Nebari documentation - Community guidelines](https://img.shields.io/badge/๐Ÿค%20-Community%20guidelines-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://www.nebari.dev/community/)                                                                                  |

---

# Custom Nebari JupyterHub template

This repository contains a custom JupyterHub template for Nebari.
This template overrides the default JupyterHub templates in <https://github.com/jupyterhub/jupyterhub/tree/main/share/jupyterhub/templates>.

For more details on JupyterHub templates and how they can be used check the official [JupyterHub documentation](https://jupyterhub.readthedocs.io/en/stable/reference/templates.html).

- [Custom Nebari JupyterHub template](#custom-nebari-jupyterhub-template)
  - [Development ๐Ÿ‘ฉ๐Ÿปโ€๐Ÿ’ป](#development-)
    - [Prerequisites](#prerequisites)
    - [Setting your development environment](#setting-your-development-environment)
  - [Using `nebari_jupyterhub_theme` on your JupyterHub instance ๐Ÿ“ฆ](#using-nebari_jupyterhub_theme-on-your-jupyterhub-instance-)
  - [Architecture ๐Ÿ—](#architecture-)
  - [Contributing to `nebari-nebari_jupyterhub_theme`๐Ÿ‘ฉโ€๐Ÿ’ป](#contributing-to-nebari-nebari_jupyterhub_theme)
  - [Code of Conduct ๐Ÿ“–](#code-of-conduct-)
  - [License ๐Ÿ“„](#license-)

## Development ๐Ÿ‘ฉ๐Ÿปโ€๐Ÿ’ป

### Prerequisites

- Python >= 3.8

- We use [Hatch](https://hatch.pypa.io) for development and publishing of the Nebari JupyterHub theme.

  We recommend you install hatch through [pipx](https://hatch.pypa.io/latest/install/#pipx)
  as it modifies the Python environment in which this is installed (for more details, see the [Hatch documentation](https://hatch.pypa.io/latest/install/))

  ```bash
  pipx install hatch
  ```

- [hatch-conda plugin](https://github.com/OldGrumpyViking/hatch-conda). To install:

  ```bash
  pipx install hatch-conda
  ```

### Setting your development environment

1. Make a fork of [the Nebari JupyterHub theme repository][theme-repo] on your personal GitHub account.

1. Clone this repository to your local computer:

   ```bash
   git clone https://github.com/<your-username>/nebari-jupyterhub-theme.git
   ```

1. From the root of the project, create a new development environment with hatch:

   ```bash
   hatch env create
   ```

   This will create a new development environment with all the dependencies needed for development.
   It will also install `nebari_jupyterhub_theme` in development mode.
   You can verify that your development environment is correctly set up by running the following command:

   ```shell
   $ hatch env show
                          Standalone
   โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
   โ”ƒ Name    โ”ƒ Type    โ”ƒ Dependencies            โ”ƒ Scripts โ”ƒ
   โ”กโ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‡โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‡โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‡โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ฉ
   โ”‚ default โ”‚ virtual โ”‚                         โ”‚         โ”‚
   โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
   โ”‚ dev     โ”‚ virtual โ”‚ configurable-http-proxy โ”‚ render  โ”‚
   โ”‚         โ”‚         โ”‚ jupyterhub              โ”‚         โ”‚
   โ”‚         โ”‚         โ”‚ jupyterlab              โ”‚         โ”‚
   โ”‚         โ”‚         โ”‚ nodejs                  โ”‚         โ”‚
   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
   ```

1. Initialize a new shell within the development environment:

   ```bash
   hatch --env dev shell
   ```

   To leave the environment you can type `exit` on your terminal.

1. Initialize a JupyterHub instance for development:

   ```bash
   hatch run dev:render
   ```

   This command will start JupyterHub with the `--config` option pointing to [`test_jupyterhub_config.py`](test_jupyterhub_config.py).
   You should be able to head to <http://127.0.0.1:8081> on your web browser and see the JupyterHub instance running.

   ![Login page of a local JupyterHub instance with the Nebari JupyterHub theme - the main text reads "welcome to Nebari your open source data science platform". The subheading reads "Running in dev mode". In the middle of the page there is the JupyterHub authentication form with a "username" and "password" fields.](images/Nebari-JupyterHub-login.png)

   > **Note**
   > From here you can log in with any username and the password set in the `c.DummyAuthenticator.password` configuration option in [`test_jupyterhub_config.py`](test_jupyterhub_config.py). Also note not all the extensions and integrations are available in this `dev` mode.

1. You can now modify the templates and the `style.css` file and see the changes reflected in the JupyterHub instance without having to restart the server.

> **Note**
> The values specified in `c.JupyterHub.template_vars` will overwrite the default values set in `nebari_jupyterhub_theme/templates`

The release process for this package is documented in [`RELEASE.md`](RELEASE.md).

## Using `nebari_jupyterhub_theme` on your JupyterHub instance ๐Ÿ“ฆ

1. Install `nebari_jupyterhub_theme`:

   ```bash
   pip install nebari_jupyterhub_theme
   ```

   > **Note**
   > If you already have a JupyterHub configuration file you can jump to the next step. Otherwise, follow the instructions in the [JupyterHub documentation](https://jupyterhub.readthedocs.io/en/stable/getting-started/config-basics.html) to generate a configuration file first.

2. Add the following to you JupyterHub configuration file to pick up the new `jinja2` templates directory and static files:

   ```python
   from nebari_jupyterhub_theme import theme_extra_handlers, theme_template_paths

   c.JupyterHub.extra_handlers = theme_extra_handlers

   c.JupyterHub.template_paths = theme_template_paths
   ```

3. **Optional** - if you need to further customize the UI you can modify the `template_vars` within your JupyterHub config file by adding the following lines to it:

   ```python
   # minimal configuration example overwriting the default values in the nebari_jupyterhub_theme
   c.JupyterHub.template_vars = {
    "hub_title": "Welcome to Nebari",
    "logo": "/hub/custom/images/Nebari-logo-square.svg",
    "primary_color": "#cb39ed",
    "secondary_color": "#2bd1c5",
   ```

The available configuration variables are:

- `hub_title`: The title of the JupyterHub instance. This will be displayed in the header of the login page. (H1 heading, `default: Welcome to Nebari`)
- `hub_subtitle`: Subtitle shown under the main instance Title. (H2 heading, `default: ""`)
- `welcome`: Welcome message on the login page (`default:  Welcome to Nebari. For more information about Nebari, visit <a href="https://nebari.dev/">https://nebari.dev</a>`)
- `logo`: Logo displayed on the navbar (`default: Nebari logomark`)
- `primary_color`: Primary color (`default:` `#9e17b7`)
- `secondary_color`: Secondary color (`default:` `#2bd1c5`)
- `accent_color`: Accent color (`default:` `#eda61d`)
- `text_color`: Text color (`default:` `#1c1d26`)
- `h1_color`: H1 color, main Title in login page (`default:` `#0f1015`)
- `h2_color`: H2 color, subtitle in login page (`default:` `#0f1015`)
- `navbar_text_color`: Navigation bar links and text color (`default:` `#1c1d26`)
- `navbar_hover_color`: Hover color for navigation bar links (`default:` `#00a3b0`)
- `display_version`: Display the JupyterHub version in the footer (`default: False`)

> **Note**
> The default colors, typefaces and logos are chosen based on the Nebari branding. You can find more about this on the [Nebari design repository](https://github.com/nebari-dev/nebari-design).

:computer: You can see an example of these variables and the configuration in [`test_jupyterhub_config.py`](test_jupyterhub_config.py).

Nebari internal options:
- `cdsdashboards_enabled`: This requires [cdsdashboards](https://github.com/ideonate/cdsdashboards) to be present in the JupyterHub environment (`default: False`)
- `cdsdashboards_restricted`: This requires [cdsdashboards](https://github.com/ideonate/cdsdashboards) to be present in the JupyterHub environment (`default: False`)
- `nebari_theme_extra_js_urls`

## Architecture ๐Ÿ—

This repository is structured as follows:

- [.github](.github): GitHub Actions configuration files and repository templates
- [images](images/): Images used in this README
- [nebari_jupyterhub_theme](nebari_jupyterhub_theme/): Python package containing the `jinja2` templates and static files
- [pyproject.toml](pyproject.toml): Python project configuration file
- [test_jupyterhub_config.py](test_jupyterhub_config.py): Example JupyterHub configuration file - used by `hatch run dev:render` to start a local JupyterHub instance for local development.
- [RELEASE.md](RELEASE.md): Release process documentation
- [.pre-commit-config.yaml](.pre-commit-config.yaml): Configuration file for the [pre-commit](https://pre-commit.com/) tool (note we use pre-commit CI to automatically run pre-commit on all PRs and update the hooks)

## Contributing to `nebari-nebari_jupyterhub_theme`๐Ÿ‘ฉโ€๐Ÿ’ป

Thinking about contributing? Check out our [Contribution Guidelines](CONTRIBUTING.md) to get started.

## Code of Conduct ๐Ÿ“–

To guarantee a welcoming and friendly community, we require all community members to follow our [Code of Conduct](https://github.com/Quansight/.github/blob/master/CODE_OF_CONDUCT.md).

## License ๐Ÿ“„

`nebari-nebari_jupyterhub_theme` is licensed under the [BSD-3 OSI licenses](https://github.com/nebari-dev/nebari-docs/blob/main/LICENSE).

<!-- links -->
[theme-repo]: https://github.com/nebari-dev/nebari-jupyterhub-theme

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "nebari-jupyterhub-theme",
    "maintainer": "Nebari development team",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "jupyterhub,theme",
    "author": "",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/6a/f8/b5885f253318a259227288f66464735d42ee7bfbae9634cf3c21f0939002/nebari_jupyterhub_theme-2023.4.1.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n<picture>\n  <source media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/nebari-dev/nebari-design/main/logo-mark/horizontal/Nebari-Logo-Horizontal-Lockup.svg\">\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/nebari-dev/nebari-design/main/logo-mark/horizontal/Nebari-Logo-Horizontal-Lockup-White-text.svg\">\n  <img alt=\"Nebari logo mark - text will be black in light color mode and white in dark color mode.\" src=\"https://raw.githubusercontent.com/nebari-dev/nebari-design/main/logo-mark/horizontal/Nebari-Logo-Horizontal-Lockup-White-text.svg\" width=\"50%\"/>\n</picture>\n</p>\n\n| Information | Links                                                                                                                                                                                                                                                                                                                                                                                                                   |\n| :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Project     | [![License](https://img.shields.io/badge/License-BSD%203--Clause-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://opensource.org/licenses/BSD-3-Clause) [![Nebari documentation](https://img.shields.io/badge/%F0%9F%93%96%20Read-the%20docs-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://nebari.dev) [![PyPI package version](https://img.shields.io/pypi/v/nebari-jupyterhub-theme.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://pypi.org/project/nebari-jupyterhub-theme/) |\n| Community   | [![GH discussions](https://img.shields.io/badge/%F0%9F%92%AC%20-Participate%20in%20discussions-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://github.com/nebari-dev/nebari/discussions) [![Open an issue](https://img.shields.io/badge/%F0%9F%93%9D%20Open-an%20issue-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://github.com/nebari-dev/nebari-jupyterhub-theme/issues/new/choose) [![Nebari documentation - Community guidelines](https://img.shields.io/badge/\ud83e\udd1d%20-Community%20guidelines-gray.svg?colorA=2D2A56&colorB=5936D9&style=flat.svg)](https://www.nebari.dev/community/)                                                                                  |\n\n---\n\n# Custom Nebari JupyterHub template\n\nThis repository contains a custom JupyterHub template for Nebari.\nThis template overrides the default JupyterHub templates in <https://github.com/jupyterhub/jupyterhub/tree/main/share/jupyterhub/templates>.\n\nFor more details on JupyterHub templates and how they can be used check the official [JupyterHub documentation](https://jupyterhub.readthedocs.io/en/stable/reference/templates.html).\n\n- [Custom Nebari JupyterHub template](#custom-nebari-jupyterhub-template)\n  - [Development \ud83d\udc69\ud83c\udffb\u200d\ud83d\udcbb](#development-)\n    - [Prerequisites](#prerequisites)\n    - [Setting your development environment](#setting-your-development-environment)\n  - [Using `nebari_jupyterhub_theme` on your JupyterHub instance \ud83d\udce6](#using-nebari_jupyterhub_theme-on-your-jupyterhub-instance-)\n  - [Architecture \ud83c\udfd7](#architecture-)\n  - [Contributing to `nebari-nebari_jupyterhub_theme`\ud83d\udc69\u200d\ud83d\udcbb](#contributing-to-nebari-nebari_jupyterhub_theme)\n  - [Code of Conduct \ud83d\udcd6](#code-of-conduct-)\n  - [License \ud83d\udcc4](#license-)\n\n## Development \ud83d\udc69\ud83c\udffb\u200d\ud83d\udcbb\n\n### Prerequisites\n\n- Python >= 3.8\n\n- We use [Hatch](https://hatch.pypa.io) for development and publishing of the Nebari JupyterHub theme.\n\n  We recommend you install hatch through [pipx](https://hatch.pypa.io/latest/install/#pipx)\n  as it modifies the Python environment in which this is installed (for more details, see the [Hatch documentation](https://hatch.pypa.io/latest/install/))\n\n  ```bash\n  pipx install hatch\n  ```\n\n- [hatch-conda plugin](https://github.com/OldGrumpyViking/hatch-conda). To install:\n\n  ```bash\n  pipx install hatch-conda\n  ```\n\n### Setting your development environment\n\n1. Make a fork of [the Nebari JupyterHub theme repository][theme-repo] on your personal GitHub account.\n\n1. Clone this repository to your local computer:\n\n   ```bash\n   git clone https://github.com/<your-username>/nebari-jupyterhub-theme.git\n   ```\n\n1. From the root of the project, create a new development environment with hatch:\n\n   ```bash\n   hatch env create\n   ```\n\n   This will create a new development environment with all the dependencies needed for development.\n   It will also install `nebari_jupyterhub_theme` in development mode.\n   You can verify that your development environment is correctly set up by running the following command:\n\n   ```shell\n   $ hatch env show\n                          Standalone\n   \u250f\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2513\n   \u2503 Name    \u2503 Type    \u2503 Dependencies            \u2503 Scripts \u2503\n   \u2521\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2529\n   \u2502 default \u2502 virtual \u2502                         \u2502         \u2502\n   \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n   \u2502 dev     \u2502 virtual \u2502 configurable-http-proxy \u2502 render  \u2502\n   \u2502         \u2502         \u2502 jupyterhub              \u2502         \u2502\n   \u2502         \u2502         \u2502 jupyterlab              \u2502         \u2502\n   \u2502         \u2502         \u2502 nodejs                  \u2502         \u2502\n   \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n   ```\n\n1. Initialize a new shell within the development environment:\n\n   ```bash\n   hatch --env dev shell\n   ```\n\n   To leave the environment you can type `exit` on your terminal.\n\n1. Initialize a JupyterHub instance for development:\n\n   ```bash\n   hatch run dev:render\n   ```\n\n   This command will start JupyterHub with the `--config` option pointing to [`test_jupyterhub_config.py`](test_jupyterhub_config.py).\n   You should be able to head to <http://127.0.0.1:8081> on your web browser and see the JupyterHub instance running.\n\n   ![Login page of a local JupyterHub instance with the Nebari JupyterHub theme - the main text reads \"welcome to Nebari your open source data science platform\". The subheading reads \"Running in dev mode\". In the middle of the page there is the JupyterHub authentication form with a \"username\" and \"password\" fields.](images/Nebari-JupyterHub-login.png)\n\n   > **Note**\n   > From here you can log in with any username and the password set in the `c.DummyAuthenticator.password` configuration option in [`test_jupyterhub_config.py`](test_jupyterhub_config.py). Also note not all the extensions and integrations are available in this `dev` mode.\n\n1. You can now modify the templates and the `style.css` file and see the changes reflected in the JupyterHub instance without having to restart the server.\n\n> **Note**\n> The values specified in `c.JupyterHub.template_vars` will overwrite the default values set in `nebari_jupyterhub_theme/templates`\n\nThe release process for this package is documented in [`RELEASE.md`](RELEASE.md).\n\n## Using `nebari_jupyterhub_theme` on your JupyterHub instance \ud83d\udce6\n\n1. Install `nebari_jupyterhub_theme`:\n\n   ```bash\n   pip install nebari_jupyterhub_theme\n   ```\n\n   > **Note**\n   > If you already have a JupyterHub configuration file you can jump to the next step. Otherwise, follow the instructions in the [JupyterHub documentation](https://jupyterhub.readthedocs.io/en/stable/getting-started/config-basics.html) to generate a configuration file first.\n\n2. Add the following to you JupyterHub configuration file to pick up the new `jinja2` templates directory and static files:\n\n   ```python\n   from nebari_jupyterhub_theme import theme_extra_handlers, theme_template_paths\n\n   c.JupyterHub.extra_handlers = theme_extra_handlers\n\n   c.JupyterHub.template_paths = theme_template_paths\n   ```\n\n3. **Optional** - if you need to further customize the UI you can modify the `template_vars` within your JupyterHub config file by adding the following lines to it:\n\n   ```python\n   # minimal configuration example overwriting the default values in the nebari_jupyterhub_theme\n   c.JupyterHub.template_vars = {\n    \"hub_title\": \"Welcome to Nebari\",\n    \"logo\": \"/hub/custom/images/Nebari-logo-square.svg\",\n    \"primary_color\": \"#cb39ed\",\n    \"secondary_color\": \"#2bd1c5\",\n   ```\n\nThe available configuration variables are:\n\n- `hub_title`: The title of the JupyterHub instance. This will be displayed in the header of the login page. (H1 heading, `default: Welcome to Nebari`)\n- `hub_subtitle`: Subtitle shown under the main instance Title. (H2 heading, `default: \"\"`)\n- `welcome`: Welcome message on the login page (`default:  Welcome to Nebari. For more information about Nebari, visit <a href=\"https://nebari.dev/\">https://nebari.dev</a>`)\n- `logo`: Logo displayed on the navbar (`default: Nebari logomark`)\n- `primary_color`: Primary color (`default:` `#9e17b7`)\n- `secondary_color`: Secondary color (`default:` `#2bd1c5`)\n- `accent_color`: Accent color (`default:` `#eda61d`)\n- `text_color`: Text color (`default:` `#1c1d26`)\n- `h1_color`: H1 color, main Title in login page (`default:` `#0f1015`)\n- `h2_color`: H2 color, subtitle in login page (`default:` `#0f1015`)\n- `navbar_text_color`: Navigation bar links and text color (`default:` `#1c1d26`)\n- `navbar_hover_color`: Hover color for navigation bar links (`default:` `#00a3b0`)\n- `display_version`: Display the JupyterHub version in the footer (`default: False`)\n\n> **Note**\n> The default colors, typefaces and logos are chosen based on the Nebari branding. You can find more about this on the [Nebari design repository](https://github.com/nebari-dev/nebari-design).\n\n:computer: You can see an example of these variables and the configuration in [`test_jupyterhub_config.py`](test_jupyterhub_config.py).\n\nNebari internal options:\n- `cdsdashboards_enabled`: This requires [cdsdashboards](https://github.com/ideonate/cdsdashboards) to be present in the JupyterHub environment (`default: False`)\n- `cdsdashboards_restricted`: This requires [cdsdashboards](https://github.com/ideonate/cdsdashboards) to be present in the JupyterHub environment (`default: False`)\n- `nebari_theme_extra_js_urls`\n\n## Architecture \ud83c\udfd7\n\nThis repository is structured as follows:\n\n- [.github](.github): GitHub Actions configuration files and repository templates\n- [images](images/): Images used in this README\n- [nebari_jupyterhub_theme](nebari_jupyterhub_theme/): Python package containing the `jinja2` templates and static files\n- [pyproject.toml](pyproject.toml): Python project configuration file\n- [test_jupyterhub_config.py](test_jupyterhub_config.py): Example JupyterHub configuration file - used by `hatch run dev:render` to start a local JupyterHub instance for local development.\n- [RELEASE.md](RELEASE.md): Release process documentation\n- [.pre-commit-config.yaml](.pre-commit-config.yaml): Configuration file for the [pre-commit](https://pre-commit.com/) tool (note we use pre-commit CI to automatically run pre-commit on all PRs and update the hooks)\n\n## Contributing to `nebari-nebari_jupyterhub_theme`\ud83d\udc69\u200d\ud83d\udcbb\n\nThinking about contributing? Check out our [Contribution Guidelines](CONTRIBUTING.md) to get started.\n\n## Code of Conduct \ud83d\udcd6\n\nTo guarantee a welcoming and friendly community, we require all community members to follow our [Code of Conduct](https://github.com/Quansight/.github/blob/master/CODE_OF_CONDUCT.md).\n\n## License \ud83d\udcc4\n\n`nebari-nebari_jupyterhub_theme` is licensed under the [BSD-3 OSI licenses](https://github.com/nebari-dev/nebari-docs/blob/main/LICENSE).\n\n<!-- links -->\n[theme-repo]: https://github.com/nebari-dev/nebari-jupyterhub-theme\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Nebari JupyterHub theme",
    "version": "2023.4.1",
    "split_keywords": [
        "jupyterhub",
        "theme"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4ce5da9472a0e29e684cc15b695e6b4860f6577fe88edafd164f03df21932e77",
                "md5": "065805df9692e3112d94e193f0ea5afb",
                "sha256": "50385d264f282eadfe8ff5ab0378a720ab28e9dbcf19a14ba2b7f028ac6ce9e3"
            },
            "downloads": -1,
            "filename": "nebari_jupyterhub_theme-2023.4.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "065805df9692e3112d94e193f0ea5afb",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 214424,
            "upload_time": "2023-04-10T21:32:53",
            "upload_time_iso_8601": "2023-04-10T21:32:53.193599Z",
            "url": "https://files.pythonhosted.org/packages/4c/e5/da9472a0e29e684cc15b695e6b4860f6577fe88edafd164f03df21932e77/nebari_jupyterhub_theme-2023.4.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6af8b5885f253318a259227288f66464735d42ee7bfbae9634cf3c21f0939002",
                "md5": "1440b33dd2c2b499c56c5329aca4ec05",
                "sha256": "d3b04f4e2e445c7d2886a6e53527b002b00b3bd8ddf5c4fb35a110388f388668"
            },
            "downloads": -1,
            "filename": "nebari_jupyterhub_theme-2023.4.1.tar.gz",
            "has_sig": false,
            "md5_digest": "1440b33dd2c2b499c56c5329aca4ec05",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 212330,
            "upload_time": "2023-04-10T21:32:55",
            "upload_time_iso_8601": "2023-04-10T21:32:55.151519Z",
            "url": "https://files.pythonhosted.org/packages/6a/f8/b5885f253318a259227288f66464735d42ee7bfbae9634cf3c21f0939002/nebari_jupyterhub_theme-2023.4.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-04-10 21:32:55",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "nebari-jupyterhub-theme"
}
        
Elapsed time: 0.05290s