Skip to content
Snippets Groups Projects
Commit a4dc767c authored by Michele Nottoli's avatar Michele Nottoli
Browse files

Merge branch 'localization' into 'main'

Moved the developer README to src.

See merge request !7
parents 20c68aa6 0635ddd2
Branches
No related tags found
1 merge request!7Moved the developer README to src.
...@@ -150,34 +150,3 @@ Now, one should find a new kernel related to the current Julia version, named `j ...@@ -150,34 +150,3 @@ Now, one should find a new kernel related to the current Julia version, named `j
If you are facing issues, check out If you are facing issues, check out
the [great troubleshooting section](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/) the [great troubleshooting section](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/)
from the WorkshopWizard package by Carsten Bauer (which is being used by `install.jl`). from the WorkshopWizard package by Carsten Bauer (which is being used by `install.jl`).
## For developers: setting up `pre-commit`
[`pre-commit`](https://pre-commit.com/) is a framework that helps to manage and maintain pre-commit hooks to ensure that your code adheres to a consistent style, prevents errors, and adheres to other quality assurance checks.
1. **Install `pre-commit`:**
To ensure smooth development, install `pre-commit` using pip by running the following command:
```bash
pip install pre-commit
```
For more information and installation options, visit the [`pre-commit`](https://pre-commit.com/) website.
2. **Navigate to the project directory:**
Change into the project directory, i.e., `julia-seminar` by running:
```bash
cd julia-seminar
```
3. **Install hooks:**
Install the git hooks by executing:
```bash
pre-commit install
```
This command installs the pre-commit script alongside existing git hooks.
Once the pre-commit hook is installed, it will automatically check your code for any issues before each commit. If the checks do not pass, you will be prompted to fix them before proceeding.
# For developers
## Setting up `pre-commit`
[`pre-commit`](https://pre-commit.com/) is a framework that helps to manage and maintain pre-commit hooks to ensure that your code adheres to a consistent style, prevents errors, and adheres to other quality assurance checks.
1. **Install `pre-commit`:**
To ensure smooth development, install `pre-commit` using pip by running the following command:
```bash
pip install pre-commit
```
For more information and installation options, visit the [`pre-commit`](https://pre-commit.com/) website.
2. **Navigate to the project directory:**
Change into the project directory, i.e., `julia-seminar` by running:
```bash
cd julia-seminar
```
3. **Install hooks:**
Install the git hooks by executing:
```bash
pre-commit install
```
This command installs the pre-commit script alongside existing git hooks.
Once the pre-commit hook is installed, it will automatically check your code for any issues before each commit. If the checks do not pass, you will be prompted to fix them before proceeding.
## Localizing the notebooks
1. Make sure the bilingual version of the notebook is in the folder `src/`. This is for clarity reasons.
2. Run `./localize.py bilingual_notebook.ipynb`. The script will ask for your help whenever it is unclear.
You should help it to set the language of the cell to one among `en`, `de` and `eq`.
The kind `eq` is for everything that is not a spoken language (figures, schemes, equations and similar).
3. You will get two versions in the `src/` folder. Move them to the root directory, add them to git and commit.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment