https://github.com/alan-turing-institute/binderhub-custom-files

Template repository for customising a Binder homepage

https://github.com/alan-turing-institute/binderhub-custom-files

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.5%) to scientific vocabulary

Keywords

hut23
Last synced: 10 months ago · JSON representation

Repository

Template repository for customising a Binder homepage

Basic Info
  • Host: GitHub
  • Owner: alan-turing-institute
  • License: mit
  • Language: HTML
  • Default Branch: master
  • Size: 3.91 KB
Statistics
  • Stars: 1
  • Watchers: 2
  • Forks: 11
  • Open Issues: 0
  • Releases: 0
Topics
hut23
Created about 7 years ago · Last pushed about 7 years ago
Metadata Files
Readme License

README.md

BinderHub Custom Files

This repository holds a template for customising a Binder homepage.

See the BinderHub Customisation documentation for more details.

How to change the logo on your Binder homepage

1. Fork this repo.

2. Upload your custom logo image into the static folder in your fork.

This can be any valid image type, for example PNG, JPEG, SVG...

3. Edit page.html in the templates folder in your fork.

Change <custom-logo-file> on line 3 of page.html to the name of your custom logo file.

4. Edit your config.yaml file

Add the following to your config.yaml file.

``` config: BinderHub: templatepath: /etc/binderhub/custom/templates extrastaticpath: /etc/binderhub/custom/static extrastaticurlprefix: /extrastatic/ templatevariables: EXTRASTATICURLPREFIX: "/extrastatic/"

initContainers: - name: git-clone-templates image: alpine/git args: - clone - --single-branch - --branch=master - --depth=1 - -- - https://github.com//binderhub-custom-files - /etc/binderhub/custom securityContext: runAsUser: 0 volumeMounts: - name: custom-templates mountPath: /etc/binderhub/custom extraVolumes: - name: custom-templates emptyDir: {} extraVolumeMounts: - name: custom-templates mountPath: /etc/binderhub/custom ```

NOTES: * Remember to replace <your-github-username> in the repo URL * If you have commited the changes in steps 2 or 3 to any other branch of your fork, you either need to merge to master or change the --branch= argument to match the name of your branch.

5. Upgrade your BinderHub and visit the Binder page

Upgrade your BinderHub with the following command.

helm upgrade <hub-name> jupyterhub/binderhub --version=0.2.0-<commit-hash> -f path/to/secret.yaml -f path/to/config.yaml

where <hub-name> is the nam/namespace you gave to your BinderHub when you deployed it, and <commit-hash> is the version of the BinderHub Helm Chart you deployed. Other Helm Chart commit hashes are available here.

Now visit your Binder page to see your new logo! To get the IP address, run the following command and copy the output of EXTERNAL-IP into a browser.

kubectl get svc binder --namespace <hub-name>

Owner

  • Name: The Alan Turing Institute
  • Login: alan-turing-institute
  • Kind: organization
  • Email: info@turing.ac.uk

The UK's national institute for data science and artificial intelligence.

GitHub Events

Total
  • Issues event: 1
Last Year
  • Issues event: 1

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 1
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • mhauru (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels