|
|
> This tutorial gives a short overview how to create your own Nomad Beaker Notebooks and comply to the current cooperate design and branding of the Nomad Laboratory group.
|
|
|
> This tutorial gives a short overview on how to create your own Nomad Beaker Notebooks and on how to comply to the current cooperate design and branding of the Nomad Laboratory group.
|
|
|
|
|
|
## Setup
|
|
|
|
|
|
Start your project in a separate [nomad-lab](https://gitlab.rzg.mpg.de/nomad-lab/) repository prefixed by the string "**notebook-**". Please choose a meaningful lower-cased name and concatenate separated words with a hyphen. You may use a slugify generator (https://blog.tersmitten.nl/slugify) to comply to the format. A good repository name for example is "*notebook-periodic-table*" and a bad one is "*notebook-pt*".
|
|
|
Start your project in a separate [nomad-lab](https://gitlab.rzg.mpg.de/nomad-lab/) repository prefixed by the string "**notebook-**". Please choose a meaningful lowercase name and concatenate separated words with a hyphen. You may use a slugify generator (https://blog.tersmitten.nl/slugify) to comply to the format. A good repository name is "*notebook-periodic-table*" and a bad one is "*notebook-pt*".
|
|
|
|
|
|
## Structure
|
|
|
|
... | ... | @@ -19,9 +19,11 @@ notebook-nomad-template |
|
|
└── requirements.txt
|
|
|
```
|
|
|
|
|
|
For your project, there already exists a default Nomad Beaker Notebook Template ([download](/uploads/c89f94f35492ce3ba318a1a80726797c/notebook-nomad-template.bkr)), which will be updated regularly. Thus, you don't have to start from scratch and you can start coding. You only have to replace all the place-holders given in the notebook and that's it.
|
|
|
For your convenience, there already exists some files you can directly use for your own projects.
|
|
|
|
|
|
There, also exists a pre-made `LICENSE` file ([download](/uploads/7809c0a85d943b7361a2e10126b7594b/LICENSE)) you can directly copy into your project. By default, we use the **Apache License 2.0** license. A nice overview of the licence conditions gives https://choosealicense.com/licenses/apache-2.0/ .
|
|
|
1. a default Nomad Beaker Notebook Template ([download](/uploads/c89f94f35492ce3ba318a1a80726797c/notebook-nomad-template.bkr)) that will be updated regularly. Thus, you don't have to start from scratch and you can start coding. You only have to replace all the place-holders given in the notebook and that's it.
|
|
|
|
|
|
2. a pre-made `LICENSE` file ([download](/uploads/7809c0a85d943b7361a2e10126b7594b/LICENSE)) that can directly be copied into your project. By default, we use the **Apache License 2.0** license. A nice overview of the licence conditions gives https://choosealicense.com/licenses/apache-2.0/ .
|
|
|
|
|
|
The `requirements.txt` file is there if you need special python libraries for your notebook, i.e., `numpy`, that can be installed via pip (https://pypi.python.org/pypi). Please list the needed libraries as a plain text file with one library name per line.
|
|
|
|
... | ... | @@ -29,6 +31,13 @@ If you need additional files, please store them in the `example-data/notebook-no |
|
|
|
|
|
## Release
|
|
|
|
|
|
Once you have finished your notebook and it was reviewed by your supervisor(s) or group members, you are ready to put all your files into the [Nomad Analytics Toolkit Tutorials repository] (https://gitlab.rzg.mpg.de/nomad-lab/analytics-toolkit-tutorials). Just copy your `example-data/notebook-nomad-template` folder into the repository's [`example-data` folder](https://gitlab.rzg.mpg.de/nomad-lab/analytics-toolkit-tutorials/tree/master/example-data) and your notebook into the repository's [`beaker-notebook` folder](https://gitlab.rzg.mpg.de/nomad-lab/analytics-toolkit-tutorials/tree/master/beaker-notebooks). You may adjust your paths in your notebook and do a commit.
|
|
|
Once you have finished your notebook and it was reviewed by your supervisor(s) or group members, you are ready to put all your files into the [Nomad Analytics Toolkit Tutorials repository] (https://gitlab.rzg.mpg.de/nomad-lab/analytics-toolkit-tutorials). In this case, copy the `example-data/notebook-nomad-template` folder into the repository's [`example-data` folder](https://gitlab.rzg.mpg.de/nomad-lab/analytics-toolkit-tutorials/tree/master/example-data) and your notebook into the repository's [`beaker-notebook` folder](https://gitlab.rzg.mpg.de/nomad-lab/analytics-toolkit-tutorials/tree/master/beaker-notebooks). You may adjust your paths in your notebook and do a commit.
|
|
|
|
|
|
<br />
|
|
|
Have fun :sunny:
|
|
|
|
|
|
<br/>
|
|
|
##### Attachments
|
|
|
|
|
|
Have fun! :sunny: |
|
|
\ No newline at end of file |
|
|
- [notebook-nomad-template.bkr](/uploads/c89f94f35492ce3ba318a1a80726797c/notebook-nomad-template.bkr)
|
|
|
- [LICENSE](/uploads/7809c0a85d943b7361a2e10126b7594b/LICENSE) |
|
|
\ No newline at end of file |