From 327d09661d9b795981218eb2eccc526816950ecd Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Sat, 26 Oct 2024 21:58:13 +0200 Subject: [PATCH 01/21] update user type 3 --- book/installation-and-setup/user_types.md | 3 +- book/workflows/edit_book.md | 39 ++++++++++++++-------- book/workflows/figures/Online_VS0.PNG | Bin 0 -> 12945 bytes 3 files changed, 27 insertions(+), 15 deletions(-) create mode 100644 book/workflows/figures/Online_VS0.PNG diff --git a/book/installation-and-setup/user_types.md b/book/installation-and-setup/user_types.md index 9f99f01..df278be 100644 --- a/book/installation-and-setup/user_types.md +++ b/book/installation-and-setup/user_types.md @@ -17,8 +17,9 @@ Different types of users will interact with the website or the Jupyter Books dif 5. **Colleague making text and code (especially Python) adjustments to multiple files at the same time locally**.
Example Image
This user has more knowledge in GitLab/GitHub than the previous user and can basically take care of branching and merging by themselves. They know how to work with software for editing .md and .ipynb files. They can use the draft book online to view their changed in the book, or build the book locally. +
```{Note} -At this point, you might already be trying to see which user type fits you the best. We are aware that the lines between user types can be a bit blurry, especially between type 3, 4 and 5. If case you're (1) a user type 3 and want to dabble in git or (2) a user type 4/5 and want to make some quick edits with only a few clicks, then you might consider using a more advanced online editor in GitHub (GitHub Dev) as explained [further on in Collaborative book-editing - Edit - User type 3 - GitHub](../workflows/edit_book.md). +At this point, you might already be trying to see which user type fits you the best. We are aware that the lines between user types can be a bit blurry, especially between type 3, 4 and 5. In case you're (1) a user type 3 and want to dabble in git or (2) a user type 4/5 and want to make some quick edits with only a few clicks, then you might consider using a more advanced online editor in GitHub (GitHub Dev) as explained further on in [Collaborative book-editing > Edit](../workflows/edit_book.md) > User type 3 > GitHub > Using VS Code in your browser. ``` \ No newline at end of file diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index 904c1ea..eda2308 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -4,7 +4,7 @@ Suppose we are writing a new chapter, or are updating an existing chapter for ou **Edit files as ...** `````````{tab-set} -````````{tab-item} ... user type 3 ... +````````{tab-item} ... user type 3 ... **... by directly adding changes on a single file to the Git-timeline (committing) in ...** @@ -47,9 +47,12 @@ In GitLab, you can directly make changes in the files on the remote repository. You can edit it and commit the changes in the same manner as with markdown (.md) files. `````` -``````{tab-item} ... GitHub +``````{tab-item} ... GitHub -How to make an edit and make a commit is demonstrated in the figure below, all steps are elaborated on in the following step-by-step tutorial. +`````{tab-set} +````{tab-item} ... using 'Edit in place' + +How to make an edit and make a commit is demonstrated in the gif below. Don't worry if the steps are too fast, all steps are elaborated on in the following step-by-step tutorial. ```{figure} figures/user3-collaboration.gif --- @@ -74,9 +77,6 @@ In GitHub, you can directly make changes in the files on the remote repository. Example Image -`````{tab-set} -````{tab-item} ... using 'Edit in place' - 4. In case you want to make changes to an existing file, navigate to the file in your remote repository. Then click the downward pointing arrow on the very left in the top bar. Select the option `Edit in place`.
@@ -100,11 +100,23 @@ You can edit it and commit the changes in the same manner as with markdown (.md) ```` ````{tab-item} ... using 'VS Code in your browser' -Using this feature, you can open VS Code in your browser and edit the files in your repository. By doing this, you completely by-pass the need to open (and install) VS Code and GitHub Desktop on your laptop making it the optimal way to quickly fix something. +Using this feature, you can open VS Code in your browser and edit the files in your repository. By doing this, you completely by-pass the need to open (and install) VS Code and GitHub Desktop on your laptop making it the optimal way to quickly fix something. You can make changes to the files already in the repository but you can also upload new files! -1. Navigate to your main page (`code`) of your repository in GitHub -2. Press the dot key on your keyboard `.` This will open VS Code -3. Navigate to a file and make some changes +1. Navigate to the repository you want to work in and make sure you're in the correct branch +2. Navigate to your main page (`code`) of your repository in GitHub +3. Press the dot key on your keyboard `.` This will open VS Code + +4. In case you want to add a new file, navigate to the explorer file (the page icon) and click on the `New File` icon. This will create a new file in the folder that you are in. give it the right extension! + +```{figure} ./figures/Online_VS0.PNG +:name: New File +:width: 60% +:align: center + +New File +``` + +5. In case you want to make changes to an existing file, navigate to a file and make some changes ```{figure} ./figures/Online_VS1.PNG :name: VS Code in Browser @@ -115,8 +127,8 @@ VS Code in Browser ``` In the bottom left you can see the branch you are working in. -4. This feature requires you to use git in VS Code. You can do that in the Source Control tab in the activity bar on the left side of the window (it looks like a branching icon). Write your commit message and click on commit & push. -5. Now let's see the result. Go back to your GitHub repo. In the top bar, go to actions. +6. Once all the changes are made it's time to commit and push. GitHub Dev requires you to use git in VS Code. You can do that in the Source Control tab in the activity bar on the left side of the window (it looks like a branching icon). Write your commit message and click on commit & push. +7. Now let's see the result. Go back to your GitHub repo. In the top bar, go to actions. ```{figure} ./figures/Online_VS2.PNG :name: GitHub Actions @@ -138,7 +150,6 @@ Click on the link and admire your changes:) ```` ````` - `````` ``````` ```````` @@ -656,4 +667,4 @@ Alternatively, you can also click on `Push origin` in the top bar. `````` ``````` ```````` -````````` \ No newline at end of file +````````` diff --git a/book/workflows/figures/Online_VS0.PNG b/book/workflows/figures/Online_VS0.PNG new file mode 100644 index 0000000000000000000000000000000000000000..6c3fc611c13ff2f70bdf9e4f81c603503653d63e GIT binary patch literal 12945 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 TMq Date: Mon, 28 Oct 2024 09:54:44 +0100 Subject: [PATCH 02/21] edits --- book/workflows/edit_book.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index eda2308..b3bb50c 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -47,7 +47,7 @@ In GitLab, you can directly make changes in the files on the remote repository. You can edit it and commit the changes in the same manner as with markdown (.md) files. `````` -``````{tab-item} ... GitHub +``````{tab-item} ... GitHub... `````{tab-set} ````{tab-item} ... using 'Edit in place' @@ -110,7 +110,7 @@ Using this feature, you can open VS Code in your browser and edit the files in y ```{figure} ./figures/Online_VS0.PNG :name: New File -:width: 60% +:width: 50% :align: center New File From eaf56b09c6588b87de8a4d2b8776493b9683efc5 Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 28 Oct 2024 11:14:47 +0100 Subject: [PATCH 03/21] user 4 and 5 --- book/workflows/edit_book.md | 100 ++++++++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index b3bb50c..871b400 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -344,6 +344,56 @@ Alternatively, you can also click on `Push origin` in the top bar. Example Image
+```` +````{tab-item} ... using 'VS Code in your browser' + +Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for quick fixes when you dont want to launch GitHub Dekstop or VS Code. + +1. Navigate to the repository you want to work in and make sure you're in the correct branch. +2. Navigate to your main page (`code`) of your repository in GitHub. +3. Press the dot key on your keyboard `.` This will open VS Code. +4. In case you want to add a new file, navigate to the explorer file (the page icon) and click on the `New File` icon. This will create a new file in the folder that you are in. Give it the right extension! + +```{figure} ./figures/Online_VS0.PNG +:name: New File +:width: 50% +:align: center + +New File +``` + +5. In case you want to make changes to an existing file, navigate to a file and make some changes. + +```{figure} ./figures/Online_VS1.PNG +:name: VS Code in Browser +:width: 70% +:align: center + +VS Code in Browser +``` +In the bottom left you can see the branch you are working in. + +6. Once all the changes are made it's time to commit and push. GitHub Dev requires you to use git in VS Code. You can do that in the Source Control tab in the activity bar on the left side of the window (it looks like a branching icon). Write your commit message and click on commit & push. +7. Now let's see the result. Go back to your GitHub repo. In the top bar, go to actions. + +```{figure} ./figures/Online_VS2.PNG +:name: GitHub Actions +:width: 70% +:align: center + +GitHub Actions +``` +You will see the latest commit you just did (in this case text). After the pipeline has run, the yellow icon will turn green. Click on the commit and scroll until you see the title Deployed Branches. + +```{figure} ./figures/Online_VS3.PNG +:name: Deployed Branches +:width: 60% +:align: center + +Deployed Branches +``` +Click on the link and admire your changes:) + ```` ````` `````` @@ -662,6 +712,56 @@ Alternatively, you can also click on `Push origin` in the top bar.
Example Image
+```` +````{tab-item} ... using 'VS Code in your browser' + +Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for quick fixes when you dont want to launch GitHub Dekstop or VS Code. + +1. Navigate to the repository you want to work in and make sure you're in the correct branch. +2. Navigate to your main page (`code`) of your repository in GitHub. +3. Press the dot key on your keyboard `.` This will open VS Code. +4. In case you want to add a new file, navigate to the explorer file (the page icon) and click on the `New File` icon. This will create a new file in the folder that you are in. Give it the right extension! + +```{figure} ./figures/Online_VS0.PNG +:name: New File +:width: 50% +:align: center + +New File +``` + +5. In case you want to make changes to an existing file, navigate to a file and make some changes. + +```{figure} ./figures/Online_VS1.PNG +:name: VS Code in Browser +:width: 70% +:align: center + +VS Code in Browser +``` +In the bottom left you can see the branch you are working in. + +6. Once all the changes are made it's time to commit and push. GitHub Dev requires you to use git in VS Code. You can do that in the Source Control tab in the activity bar on the left side of the window (it looks like a branching icon). Write your commit message and click on commit & push. +7. Now let's see the result. Go back to your GitHub repo. In the top bar, go to actions. + +```{figure} ./figures/Online_VS2.PNG +:name: GitHub Actions +:width: 70% +:align: center + +GitHub Actions +``` +You will see the latest commit you just did (in this case text). After the pipeline has run, the yellow icon will turn green. Click on the commit and scroll until you see the title Deployed Branches. + +```{figure} ./figures/Online_VS3.PNG +:name: Deployed Branches +:width: 60% +:align: center + +Deployed Branches +``` +Click on the link and admire your changes:) + ```` ````` `````` From cdd9c8c82ff683d18253d0f009fc4a94d06aeb0d Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 28 Oct 2024 11:22:43 +0100 Subject: [PATCH 04/21] edit --- book/workflows/edit_book.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index 871b400..152ac9b 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -347,7 +347,7 @@ Alternatively, you can also click on `Push origin` in the top bar. ```` ````{tab-item} ... using 'VS Code in your browser' -Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for quick fixes when you dont want to launch GitHub Dekstop or VS Code. +Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for **quick fixes** when you dont want to launch GitHub Dekstop or VS Code. However, we would recommend to limit the use of this feature to quick changes as the other workflows allow for more complex tasks. 1. Navigate to the repository you want to work in and make sure you're in the correct branch. 2. Navigate to your main page (`code`) of your repository in GitHub. @@ -715,7 +715,7 @@ Alternatively, you can also click on `Push origin` in the top bar. ```` ````{tab-item} ... using 'VS Code in your browser' -Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for quick fixes when you dont want to launch GitHub Dekstop or VS Code. +Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for **quick fixes** when you dont want to launch GitHub Dekstop or VS Code. However, we would recommend to limit the use of this feature to quick changes as the other workflows allow for more complex tasks. 1. Navigate to the repository you want to work in and make sure you're in the correct branch. 2. Navigate to your main page (`code`) of your repository in GitHub. From c71e7b4c1381c730aca1e4468c6ef0125ca55731 Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 4 Nov 2024 12:24:22 +0100 Subject: [PATCH 05/21] does it work now --- book/workflows/edit_book.md | 1 + 1 file changed, 1 insertion(+) diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index 152ac9b..cb320c6 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -762,6 +762,7 @@ Deployed Branches ``` Click on the link and admire your changes:) + ```` ````` `````` From 93090ee2d69a65cd43e910fe1904a77cc1da3947 Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 4 Nov 2024 14:39:16 +0100 Subject: [PATCH 06/21] branches --- book/workflows/branches.md | 179 ++++++++-------------------- book/workflows/new_branch_github.md | 39 ++++++ book/workflows/new_branch_gitlab.md | 22 ++++ 3 files changed, 109 insertions(+), 131 deletions(-) create mode 100644 book/workflows/new_branch_github.md create mode 100644 book/workflows/new_branch_gitlab.md diff --git a/book/workflows/branches.md b/book/workflows/branches.md index 904f05d..11acdf2 100644 --- a/book/workflows/branches.md +++ b/book/workflows/branches.md @@ -21,66 +21,15 @@ The act of making a new branch from an existing one is called *branching*. Usual ``````{tab-item} ... GitLab -1. Navigate to the repository of your project. Under the project description, you should see a menu button with a "+" in it (see {numref}`new-branch-button`). Click this button, then click on "New branch". - -```{figure} ../images/gitlab-branch.png -:name: new-branch-button - -Click the highlighted button to make a new branch. +```{include} new_branch_gitlab.md ``` -2. A new page opens ({numref}`new-branch-menu`), on which you can specify the name of your branch and the source branch. Try to think of a good name for your branch. For example, `chapter-2` is a suitable name if we're going to be working on Chapter 2 of our book. After you've made sure that the selected source branch is correct, click "Create branch". - -```{figure} ../images/gitlab-branch-name.png -:name: new-branch-menu - -We're making a new branch called `chapter-2` from the `main` branch. -``` - -3. You should be sent back to an overview page of your repository. In the branch selection menu (see {numref}`new-branch-repo`), it should now say `chapter-2` instead of `main`. Here you can also select another existing branch which is what we previously called `selecting an existing version`. - -```{figure} ../images/gitlab-new-branch-repo.png -:name: new-branch-repo - -The circled menu is the branch selection menu. -``` `````` - ``````{tab-item} ... GitHub -How to branch is demonstrated in the figure below, all steps are elaborated on in the following step-by-step tutorial. - -```{figure} figures/branching-github-ezgif.com-optimize.gif ---- -name: branching_demo ---- -Demonstration, video available [here](https://youtu.be/3ceMSLQpD70) +```{include} new_branch_github.md ``` -1. Open the repository in which you want to work in. In the top bar you will see your current branch `main` and next to that there is a tab called `Branches`. - -
- Example Image -
- -2. Clicking on `Branches` will bring you to an overview of all the branches in the repository. Click on the green `Create Branch` button. - -
- Example Image -
- -3. Finally, give your branch a name and specifiy the source branch.
-Tip: It makes sense to give the branch a name related to the content you will be creating or altering. - -
- Example Image -
- -4. You will find your new branch in the drop down menu as seen on the figure below. You can then select your new branch and start working in it (new version) but you can also work in any other branch if you are helping out a colleague with their chapter for example (existing version). - -
- Example Image -
`````` ``````` `````````` @@ -103,11 +52,13 @@ If your repository is already cloned on your computer, you are almost ready to s ``````{tab-item} ... GitLab -1. Navigate to the repository of your book. Click on the blue button that says "Clone" ({numref}`gitlab-clone`), and copy the link under "Clone with SSH". +1. Navigate to the repository of your book. Click on the blue button that says "Clone", and copy the link under "Clone with SSH". + ```{figure} ../images/gitlab-clone.png -:name: gitlab-clone - +--- +name: gitlab-clone +--- The cloning menu. ``` `````` @@ -116,36 +67,50 @@ The cloning menu. 1. Open the repository that you would like to clone. In the top bar on the right, you will a green button called `<> Code`. -
- Example Image -
+```{figure} figures/NewBranch_GitHub.PNG +--- +name: NewBranch_GitHub1 +--- +Overview +``` 2. Clicking on the button will display the following screen. Make sure the option `SSH` is selected and copy the link. -
- Example Image -
-`````` +```{figure} figures/Clone_GitHub.PNG +--- +name: Clone_GitHub +--- +Clone using SSH +``` ``````{tab-item} ... GitHub through GitHub Desktop 1. Open the repository that you would like to clone. In the top bar on the right, you will a green button called `<> Code`. -
- Example Image -
+```{figure} figures/NewBranch_GitHub.PNG +--- +name: NewBranch_GitHub2 +--- +Overview +``` 2. Clicking on the button will display the following screen. Click on `Open with GitHub Desktop`. -
- Example Image -
+```{figure} figures/Clone_GitHub.PNG +--- +name: Clone_GitHub1 +--- +Clone using SSH +``` 3. The Browser should then automatically open GitHub Desktop. Customize the path to the location where you would like to save to files locally. Finally, click on `Clone`. -
- Example Image -
+```{figure} figures/CloneRepo_TroughGithubdesk.PNG +--- +name: CloneRepo_TroughGithubdesk.PNG +--- +Clone through GitHub Desktop +``` You have now directly cloned the repository, so you can skip the next step! `````` @@ -154,9 +119,10 @@ You have now directly cloned the repository, so you can skip the next step! **(b) ... and opening (cloning) the local repository with ...** ```````{tab-set} + ``````{tab-item} ... VS Code -1. Open a new VS Code window. You should be greeted with a welcome page ({numref}`vscode-welcome`). On this page, click "Clone Git Repository". Alternatively, open the Source Control menu from the left side bar, and click on "Clone Repository". +1. Open a new VS Code window. You should be greeted with a welcome page. On this page, click "Clone Git Repository". Alternatively, open the Source Control menu from the left side bar, and click on "Clone Repository". ```{figure} ../images/vscode-welcome.png :name: vscode-welcome @@ -197,71 +163,20 @@ Have a look at the other section!** **(a) by creating my own version (branching) or select an existing version (checkout branch) ...** -Although it is possible to create new branches in VS Code directly, creating new branches on the remote repository (on GitLab or GitHub) is better for collaborating because the new branch becomes immediately visible to everyone working in the repository as opposed to becoming visible after being pushed to the remote repository. +Although it is possible to create new branches in VS Code or GitHub Desktop directly, creating new branches on the remote repository (on GitLab or GitHub) is better for collaborating because the new branch becomes immediately visible to everyone working in the repository as opposed to becoming visible after being pushed/published to the remote repository. `````{tab-set} ````{tab-item} ... in GitLab -1. Navigate to the repository of your project. Under the project description, you should see a menu button with a "+" in it (see {numref}`new-branch-button`). Click this button, then click on "New branch". - -```{figure} ../images/gitlab-branch.png -:name: new-branch-button - -Click the highlighted button to make a new branch. +```{include} new_branch_gitlab.md ``` -2. A new page opens ({numref}`new-branch-menu`), on which you can specify the name of your branch and the source branch. Try to think of a good name for your branch. For example, `chapter-2` is a suitable name if we're going to be working on Chapter 2 of our book. After you've made sure that the selected source branch is correct, click "Create branch". - -```{figure} ../images/gitlab-branch-name.png -:name: new-branch-menu - -We're making a new branch called `chapter-2` from the `main` branch. -``` - -3. You should be sent back to an overview page of your repository. In the branch selection menu (see {numref}`new-branch-repo`), it should now say `chapter-2` instead of `main`. - -```{figure} ../images/gitlab-new-branch-repo.png -:name: new-branch-repo - -The circled menu is the branch selection menu. -``` ```` ````{tab-item} ... GitHub -How to branch is demonstrated in the figure below, followed by a step-by-step tutorial. - -```{figure} figures/branching-github-ezgif.com-optimize.gif ---- -name: branching_demo ---- -Demonstration, video available [here](https://youtu.be/3ceMSLQpD70) +```{include} new_branch_github.md ``` -1. Open the repository in which you want to work in. In the top bar you will see your current branch `main` and next to that there is a tab called `Branches`. - -
- Example Image -
- -2. Clicking on `Branches` will bring you to an overview of all the branches in the repository. Click on the green `Create Branch` button. - -
- Example Image -
- -3. Finally, give your branch a name and specifiy the source branch.
-Tip: It makes sense to give the branch a name related to the content you will be creating or altering. - -
- Example Image -
- -4. You will find your new branch in the drop down menu as seen on the figure below. You can then select your new branch and start working in it (new version). - -
- Example Image -
- ```` ````` @@ -279,14 +194,16 @@ In VS Code, open the branch menu from the bottom left (see {numref}`git-branch-m Check out the branch by simply clicking on it. Check that the branch is indeed checked out by looking at the branch menu button in the bottom left again; it should now say the name of your branch instead of `main` (in our case `chapter-2`). ```{figure} ../images/git-branch-menu-main.png -:name: git-branch-menu-main - +--- +name: git-branch-menu-main +--- Location of the branch menu. ``` ```{figure} ../images/git-branch-selection-menu.png -:name: git-branch-selection-menu - +--- +name: git-branch-selection-menu +--- The branch selection menu, where our new branch has shown up. From this menu you can also select (checkout in git terms) another existing branch. ``` diff --git a/book/workflows/new_branch_github.md b/book/workflows/new_branch_github.md new file mode 100644 index 0000000..1aef3ca --- /dev/null +++ b/book/workflows/new_branch_github.md @@ -0,0 +1,39 @@ +How to branch is demonstrated in the figure below, all steps are elaborated on in the following step-by-step tutorial. + +```{figure} figures/branching-github-ezgif.com-optimize.gif +--- +name: branching_demo +--- +Demonstration, video available [here](https://youtu.be/3ceMSLQpD70) +``` + +1. Open the repository in which you want to work in. In the top bar you will see your current branch `main` and next to that there is a tab called `Branches`. + +```{figure} figures/NewBranch_GitHub.PNG + +Overview +``` + +2. Clicking on `Branches` will bring you to an overview of all the branches in the repository. Click on the green `Create Branch` button. + +```{figure} figures/NewBranch_GitHub2.PNG + +Overview Branches +``` + +3. Finally, give your branch a name and specifiy the source branch.
+Tip: It makes sense to give the branch a name related to the content you will be creating or altering. + +```{figure} figures/NewBranch_GitHub3.PNG +--- +width: 60% +--- +New Branch +``` + +4. You will find your new branch in the drop down menu as seen on the figure below. You can then select your new branch and start working in it (new version) but you can also work in any other branch if you are helping out a colleague with their chapter for example (existing version). + +```{figure} figures/NewBranch_GitHub4.PNG + +Select New Branch +``` \ No newline at end of file diff --git a/book/workflows/new_branch_gitlab.md b/book/workflows/new_branch_gitlab.md new file mode 100644 index 0000000..154718d --- /dev/null +++ b/book/workflows/new_branch_gitlab.md @@ -0,0 +1,22 @@ +1. Navigate to the repository of your project. Under the project description, you should see a menu button with a "+" in it. Click this button, then click on "New branch". + +```{figure} ../images/gitlab-branch.png + +Click the highlighted button to make a new branch. +``` + +2. A new page opens, on which you can specify the name of your branch and the source branch. Try to think of a good name for your branch. For example, `chapter-2` is a suitable name if we're going to be working on Chapter 2 of our book. After you've made sure that the selected source branch is correct, click "Create branch". + +```{figure} ../images/gitlab-branch-name.png +--- +width: 80% +--- +We're making a new branch called `chapter-2` from the `main` branch. +``` + +3. You should be sent back to an overview page of your repository. In the branch selection menu, it should now say `chapter-2` instead of `main`. + +```{figure} ../images/gitlab-new-branch-repo.png + +The circled menu is the branch selection menu. +``` From b122d776d3d38b8f793e4ba6567b84fdda5be70c Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 4 Nov 2024 20:53:28 +0100 Subject: [PATCH 07/21] fix errors 1 --- book/workflows/edit_book.md | 188 ++++++++++++----------------------- book/workflows/github_dev.md | 44 ++++++++ 2 files changed, 107 insertions(+), 125 deletions(-) create mode 100644 book/workflows/github_dev.md diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index e41a26a..105f091 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -17,42 +17,52 @@ In GitLab, you can directly make changes in the files on the remote repository. 2. Create a new file by clicking on the plus button in the top bar. You can either create an entirely new file by clicking `New File` or if you already have created a file you can upload it by clicking `Upload File`. -
- Example Image -
+```{figure} figures/User3_NewFile.PNG +width: 60% +align: center + +Create new file +``` 3. In the new window, you can start typing your content. Give your file a name and make sure to use the markdown extension: `Chapter1.md`. Once you are done, commit the new file to the repository by clicking the blue button `Commit changes`. -
- Example Image -
+```{figure} figures/User3_NewFile2.PNG +align: center + +Edit new file +``` 4. In case you want to make changes to an existing file, navigate to the file in your remote repository. Then click the blue button called `Edit` and select the option `Edit single file`. -
- Example Image -
+```{figure} figures/User3_EditFile.PNG +align: center + +Web Editor +``` 5. Make your changes in the text editor and when you are ready, commit your changes to the remote repository by clicking on the blue `Commit changes` button. -
- Example Image -
+```{figure} figures/User3_NewFile2.PNG +align: center -6. In case you added a new file, you also need to include it table of contents of your book! The table of contents is specified in a file called `toc.yml` and it is already included in your repository if you used the teachbooks template. +Commit changes +``` -
- Example Image -
+6. In case you added a new file, you also need to include it table of contents of your book! The table of contents is specified in a file called `toc.yml` and it is already included in your repository if you used the teachbooks template. You can edit it and commit the changes in the same manner as you did with markdown `file.md` files. -You can edit it and commit the changes in the same manner as with markdown (.md) files. +```{figure} figures/User3_toc.PNG +align: center + +Table of contents (TOC) +``` `````` + ``````{tab-item} ... GitHub... `````{tab-set} ````{tab-item} ... using 'Edit in place' -How to make an edit and make a commit is demonstrated in the gif below. Don't worry if the steps are too fast, all steps are elaborated on in the following step-by-step tutorial. +How to make an edit and make a commit is demonstrated in the gif below.
Don't worry if the steps are too fast, all steps are elaborated on in the following step-by-step tutorial. ```{figure} figures/user3-collaboration.gif --- @@ -67,92 +77,63 @@ In GitHub, you can directly make changes in the files on the remote repository. 2. Create a new file by clicking on the button called `Add file` in the top bar. You can either create an entirely new file by clicking `Create new File` or if you already have created a file you can upload it by clicking `Upload files`. -
- Example Image -
+```{figure} figures/HubUser3_NewFile.PNG +width: 80% +align: center -3. In the new window, you can start typing your content. Give your file a name and make sure to use the markdown extension: `Chapter1.md`. Once you are done, commit the new file to the repository by clicking the green button `Commit changes`. +Create new file +``` -
- Example Image -
+3. In the new window, you can start typing your content. Give your file a name and make sure to use the markdown extension: `file_name.md`. Once you are done, commit the new file to the repository by clicking the green button `Commit changes`. + +```{figure} figures/HubUser3_NewFile2.PNG +width: 80% +align: center + +Edit new file +``` 4. In case you want to make changes to an existing file, navigate to the file in your remote repository. Then click the downward pointing arrow on the very left in the top bar. Select the option `Edit in place`. -
- Example Image -
+```{figure} figures/HubUser3_EditFile.PNG +width: 80% +align: center + +Edit in place +``` 5. Make your changes in the text editor and when you are ready, commit your changes to the remote repository by clicking on the green `Commit changes` button. -
- Example Image -
+```{figure} figures/HubUser3_EditFile2.PNG +width: 80% +align: center -6. In case you added a new file, you also need to include it table of contents of your book! The table of contents is specified in a file called `toc.yml` and it is already included in your repository if you used the teachbooks template. +Commit changes +``` -
- Example Image -
+6. In case you added a new file, you also need to include it table of contents of your book! The table of contents is specified in a file called `toc.yml` and it is already included in your repository if you used the teachbooks template. You can edit it and commit the changes in the same manner as with markdown `(file.md)` files. -You can edit it and commit the changes in the same manner as with markdown (.md) files. +```{figure} figures/HubUser3_toc.PNG +width: 80% +align: center +Table of contents +``` ```` + ````{tab-item} ... using 'VS Code in your browser' Using this feature, you can open VS Code in your browser and edit the files in your repository. By doing this, you completely by-pass the need to open (and install) VS Code and GitHub Desktop on your laptop making it the optimal way to quickly fix something. You can make changes to the files already in the repository but you can also upload new files! -1. Navigate to the repository you want to work in and make sure you're in the correct branch -2. Navigate to your main page (`code`) of your repository in GitHub -3. Press the dot key on your keyboard `.` This will open VS Code - -4. In case you want to add a new file, navigate to the explorer file (the page icon) and click on the `New File` icon. This will create a new file in the folder that you are in. give it the right extension! - -```{figure} ./figures/Online_VS0.PNG -:name: New File -:width: 50% -:align: center - -New File +```{include} github_dev.md ``` -5. In case you want to make changes to an existing file, navigate to a file and make some changes - -```{figure} ./figures/Online_VS1.PNG -:name: VS Code in Browser -:width: 70% -:align: center - -VS Code in Browser -``` -In the bottom left you can see the branch you are working in. - -6. Once all the changes are made it's time to commit and push. GitHub Dev requires you to use git in VS Code. You can do that in the Source Control tab in the activity bar on the left side of the window (it looks like a branching icon). Write your commit message and click on commit & push. -7. Now let's see the result. Go back to your GitHub repo. In the top bar, go to actions. - -```{figure} ./figures/Online_VS2.PNG -:name: GitHub Actions -:width: 70% -:align: center - -GitHub Actions -``` -You will see the latest commit you just did (in this case text). After the pipeline has run, the yellow icon will turn green. Click on the commit and scroll until you see the title Deployed Branches. - -```{figure} ./figures/Online_VS3.PNG -:name: Deployed Branches -:width: 60% -:align: center - -Deployed Branches -``` -Click on the link and admire your changes:) - ```` ````` `````` ``````` ```````` + ````````{tab-item} ... user type 4 ... ```````{tab-set} @@ -176,7 +157,7 @@ Demonstration, video available [here](https://youtu.be/bThimdDRXTc) 1. Make some changes to a file in for example VS Code and save them. -2. Select the files ready to be added to Git-timeline (staging) +2. Select the files ready to be added to Git-timeline (staging) For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: @@ -760,52 +741,9 @@ Alternatively, you can also click on `Push origin` in the top bar. Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for **quick fixes** when you dont want to launch GitHub Dekstop or VS Code. However, we would recommend to limit the use of this feature to quick changes as the other workflows allow for more complex tasks. -1. Navigate to the repository you want to work in and make sure you're in the correct branch. -2. Navigate to your main page (`code`) of your repository in GitHub. -3. Press the dot key on your keyboard `.` This will open VS Code. -4. In case you want to add a new file, navigate to the explorer file (the page icon) and click on the `New File` icon. This will create a new file in the folder that you are in. Give it the right extension! - -```{figure} ./figures/Online_VS0.PNG -:name: New File -:width: 50% -:align: center - -New File +```{include} githu_dev.md ``` -5. In case you want to make changes to an existing file, navigate to a file and make some changes. - -```{figure} ./figures/Online_VS1.PNG -:name: VS Code in Browser -:width: 70% -:align: center - -VS Code in Browser -``` -In the bottom left you can see the branch you are working in. - -6. Once all the changes are made it's time to commit and push. GitHub Dev requires you to use git in VS Code. You can do that in the Source Control tab in the activity bar on the left side of the window (it looks like a branching icon). Write your commit message and click on commit & push. -7. Now let's see the result. Go back to your GitHub repo. In the top bar, go to actions. - -```{figure} ./figures/Online_VS2.PNG -:name: GitHub Actions -:width: 70% -:align: center - -GitHub Actions -``` -You will see the latest commit you just did (in this case text). After the pipeline has run, the yellow icon will turn green. Click on the commit and scroll until you see the title Deployed Branches. - -```{figure} ./figures/Online_VS3.PNG -:name: Deployed Branches -:width: 60% -:align: center - -Deployed Branches -``` -Click on the link and admire your changes:) - - ```` ````` `````` diff --git a/book/workflows/github_dev.md b/book/workflows/github_dev.md new file mode 100644 index 0000000..9c5b815 --- /dev/null +++ b/book/workflows/github_dev.md @@ -0,0 +1,44 @@ +1. Navigate to the repository you want to work in and make sure you're in the correct branch. +2. Navigate to your main page (`code`) of your repository in GitHub. +3. Press the dot key on your keyboard `.` This will open VS Code. +4. In case you want to add a new file, navigate to the explorer file (the page icon) and click on the `New File` icon. This will create a new file in the folder that you are in. Give it the right extension! + +```{figure} figures/Online_VS0.PNG +name: New File +width: 50% +align: center + +New File +``` + +5. In case you want to make changes to an existing file, navigate to a file and make some changes. + +```{figure} figures/Online_VS1.PNG +name: VS Code in Browser +width: 70% +align: center + +VS Code in Browser +``` +In the bottom left you can see the branch you are working in. + +6. Once all the changes are made it's time to commit and push. GitHub Dev requires you to use git in VS Code. You can do that in the Source Control tab in the activity bar on the left side of the window (it looks like a branching icon). Write your commit message and click on commit & push. +7. Now let's see the result. Go back to your GitHub repo. In the top bar, go to actions. + +```{figure} figures/Online_VS2.PNG +name: GitHub Actions +width: 70% +align: center + +GitHub Actions +``` +You will see the latest commit you just did (in this case text). After the pipeline has run, the yellow icon will turn green. Click on the commit and scroll until you see the title Deployed Branches. + +```{figure} figures/Online_VS3.PNG +name: Deployed Branches +width: 60% +align: center + +Deployed Branches +``` +Click on the link and admire your changes:) \ No newline at end of file From 0193f8c0499090fb2e515ba96553a84e65af2e4e Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 4 Nov 2024 21:32:58 +0100 Subject: [PATCH 08/21] changes2 --- book/workflows/edit_book.md | 153 +++++++++---------------- book/workflows/user45_check_changes.md | 44 +++++++ 2 files changed, 101 insertions(+), 96 deletions(-) create mode 100644 book/workflows/user45_check_changes.md diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index 105f091..404fb72 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -154,22 +154,20 @@ How to make an edit and make a commit using VS Code is demonstrated in the figur name: user4_clone_edit_demo --- Demonstration, video available [here](https://youtu.be/bThimdDRXTc) +``` 1. Make some changes to a file in for example VS Code and save them. -2. Select the files ready to be added to Git-timeline (staging) - +2. Select the files ready to be added to Git-timeline (staging)
For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: ```{figure} ../images/git-new-file.png The new file appears in the Source Control menu. ``` - Notice that there is a green letter U placed besides the file, meaning that our file is untracked. To add a file to the *staging area*, click on the + that appears when you hover over the file. -3. Adding changes to the Git-timeline (committing) - +3. Adding changes to the Git-timeline (committing)
Next, in the field that says "Message", write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, the menu should now look something like this: ```{figure} ../images/git-file-added.png @@ -183,7 +181,7 @@ Now, we are ready to add the changes to the repository. This is done by *committ ```{figure} ../images/git-push.png After committing, click the 🔄 button to push our changes to the remote repository. - +``` ```` ````{tab-item} ... GitHub Desktop @@ -248,7 +246,7 @@ Choose one of the options to resolve the merge conflict. You now have updated yo 3. Make some further changes to a file in for example VS Code and save them. -4. Select the files ready to be added to Git-timeline (staging) +4. Select the files ready to be added to Git-timeline (staging) For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: @@ -330,51 +328,9 @@ Alternatively, you can also click on `Push origin` in the top bar. Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for **quick fixes** when you dont want to launch GitHub Dekstop or VS Code. However, we would recommend to limit the use of this feature to quick changes as the other workflows allow for more complex tasks. -1. Navigate to the repository you want to work in and make sure you're in the correct branch. -2. Navigate to your main page (`code`) of your repository in GitHub. -3. Press the dot key on your keyboard `.` This will open VS Code. -4. In case you want to add a new file, navigate to the explorer file (the page icon) and click on the `New File` icon. This will create a new file in the folder that you are in. Give it the right extension! - -```{figure} ./figures/Online_VS0.PNG -:name: New File -:width: 50% -:align: center - -New File +```{include} githu_dev.md ``` -5. In case you want to make changes to an existing file, navigate to a file and make some changes. - -```{figure} ./figures/Online_VS1.PNG -:name: VS Code in Browser -:width: 70% -:align: center - -VS Code in Browser -``` -In the bottom left you can see the branch you are working in. - -6. Once all the changes are made it's time to commit and push. GitHub Dev requires you to use git in VS Code. You can do that in the Source Control tab in the activity bar on the left side of the window (it looks like a branching icon). Write your commit message and click on commit & push. -7. Now let's see the result. Go back to your GitHub repo. In the top bar, go to actions. - -```{figure} ./figures/Online_VS2.PNG -:name: GitHub Actions -:width: 70% -:align: center - -GitHub Actions -``` -You will see the latest commit you just did (in this case text). After the pipeline has run, the yellow icon will turn green. Click on the commit and scroll until you see the title Deployed Branches. - -```{figure} ./figures/Online_VS3.PNG -:name: Deployed Branches -:width: 60% -:align: center - -Deployed Branches -``` -Click on the link and admire your changes:) - ```` ````` `````` @@ -387,7 +343,7 @@ Click on the link and admire your changes:) ``````{tab-item} ... for brand new version (branch) **... by (a) making changes on a single or multiple file(s)
- (b) checking changes locally,
+ (b) checking changes locally
(c) selecting changes to be added to the Git-timeline (staging)
(d) adding changes to the Git-timeline (committing) and
(e) adding changes to GitLab/GitHub (pushing) with ...** @@ -406,37 +362,40 @@ Demonstration, video available [here](https://youtu.be/2ttjBevkEP8) 1. Make some changes to a file in for example VS Code and save them. -2. Once all the changes are made, it can be useful to check the changes locally on your device in order to see how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy! +2. Once all the changes are made, it can be useful to check the changes locally on your device.
+ + By doing that you can preview how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy. -Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. + Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. + You will firstly need to activate the right environment. Type the following command: -You will firstly need to activate the right environment. Type the following command: +``` +conda activate jupyter-book-env +``` -`conda activate jupyter-book-env` - -(or the environment in which you have installed the TeachBooks package) - -Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: + (or the environment in which you have installed the `teachbooks` package!) + + Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: ``` teachbooks build ``` -Alternatively: + Alternatively: ``` jupyter-book build --all ``` -Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. + Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. -Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: + Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: ```{figure} ../figures/buildbook.PNG Output ``` -Paste the last line into your browser to see the updated changes. + Paste the last line into your browser to see the updated changes. ```{Note} @@ -446,32 +405,32 @@ Sometimes there are problems building the book. It could be that the building re ``` -If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] + If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] 3. If you are satisfied with your changes, you can select the files ready to be added to Git-timeline (staging) -For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: + For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: ```{figure} ../images/git-new-file.png The new file appears in the Source Control menu. ``` -Notice that there is a green letter U placed besides the file, meaning that our file is untracked. To add a file to the *staging area*, click on the + that appears when you hover over the file. + Notice that there is a green letter U placed besides the file, meaning that our file is untracked. To add a file to the *staging area*, click on the + that appears when you hover over the file. 4. Adding changes to the Git-timeline (committing) -Next, in the field that says "Message", write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, the menu should now look something like this: + Next, in the field that says "Message", write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, the menu should now look something like this: ```{figure} ../images/git-file-added.png The new file has been staged, and we've written a Commit Message. ``` -Now, we are ready to add the changes to the repository. This is done by *committing* the staged changes. To do this, simply press the big, blue "Commit" button in the Source Control menu. + Now, we are ready to add the changes to the repository. This is done by *committing* the staged changes. To do this, simply press the big, blue "Commit" button in the Source Control menu. 5. Adding changes to GitLab/GitHub (pushing) -In the bottom left corner, next to the branch name, click the "Synchronize Changes" button (the one that looks like this: 🔄, highlighted in the image below) to push the changes to GitLab/GitHub. + In the bottom left corner, next to the branch name, click the "Synchronize Changes" button (the one that looks like this: 🔄, highlighted in the image below) to push the changes to GitLab/GitHub. ```{figure} ../images/git-push.png @@ -480,39 +439,42 @@ After committing, click the 🔄 button to push our changes to the remote reposi ````{tab-item} ... GitHub Desktop -1.. Make some changes to a file in for example VS Code and save them. +1. Make some changes to a file in for example VS Code and save them. -2. Once all the changes are made, it can be useful to check the changes locally on your device in order to see how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy! +2. Once all the changes are made, it can be useful to check the changes locally on your device.
+ + By doing that you can preview how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy. -Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. + Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. + You will firstly need to activate the right environment. Type the following command: -You will firstly need to activate the right environment. Type the following command: +``` +conda activate jupyter-book-env +``` -`conda activate jupyter-book-env` - -(or the environment in which you have installed the TeachBooks package) - -Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: + (or the environment in which you have installed the `teachbooks` package!) + + Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: ``` teachbooks build ``` -Alternatively: + Alternatively: ``` jupyter-book build --all ``` -Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. + Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. -Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: + Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: ```{figure} ../figures/buildbook.PNG Output ``` -Paste the last line into your browser to see the updated changes. + Paste the last line into your browser to see the updated changes. ```{Note} @@ -522,29 +484,28 @@ Sometimes there are problems building the book. It could be that the building re ``` -If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] + If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] 3. If you are satisfied with your changes, you can select the files ready to be added to Git-timeline (staging) -The staging GitHub Desktop assumes you want to stage all files. These files will show up on the left side bar when you open GitHub Desktop. You can unselect some of them (unstaging them) by clicking on the *check*. + The staging GitHub Desktop assumes you want to stage all files. These files will show up on the left side bar when you open GitHub Desktop. You can unselect some of them (unstaging them) by clicking on the *check*. -
- Example Image -
+```{figure} figures/Stage_GitHubDekstop.PNG +width: 50% -4. Add changes to Git-timeline locally (committing). In the field that says `Summary(Required)`, write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, click the blue button `Commit to repository`. +Staging +``` -5. Now we need to add changes to GitHub/GitLab. This is called pushing to the local repository. After committing, the following screen will pop up. Click on `Push Origin`. +4. Add changes to Git-timeline locally (committing). In the field that says `Summary (Required)`, write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, click the blue button `Commit to repository`. -
- Example Image -
+5. Now we need to add changes to GitHub/GitLab. This is called pushing to the local repository. After committing, click on `Push Origin` in the top bar. -Alternatively, you can also click on `Push origin` in the top bar. +```{figure} figures/Push_GitHubDekstop.PNG +width: 100% + +Push origin +``` -
- Example Image -
```` ````` diff --git a/book/workflows/user45_check_changes.md b/book/workflows/user45_check_changes.md new file mode 100644 index 0000000..c4d3f0f --- /dev/null +++ b/book/workflows/user45_check_changes.md @@ -0,0 +1,44 @@ + Once all the changes are made, it can be useful to check the changes locally on your device. + + By doing that you can preview how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy. + + Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. + You will firstly need to activate the right environment. Type the following command: + +``` +conda activate jupyter-book-env +``` + + (or the environment in which you have installed the `teachbooks` package!) + + Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: + +``` +teachbooks build +``` + + Alternatively: + +``` +jupyter-book build --all +``` + + Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. + + Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: + +```{figure} ../figures/buildbook.PNG + +Output +``` + Paste the last line into your browser to see the updated changes. + +```{Note} + +Sometimes there are problems building the book. It could be that the building requires extensions that are not present in your environment. To prevent issues, make sure to update your environment by routinely updating your packages. You can do this by executing the following line in your environment in the command line. + +`pip install -r requirements.txt --upgrade` + +``` + + If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] \ No newline at end of file From 82606d0c5b5c21148effab759a98b4a6f271bead Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 4 Nov 2024 21:37:14 +0100 Subject: [PATCH 09/21] changes3 --- book/workflows/edit_book.md | 12 +++++------- book/workflows/figures/Push_GitHubDesktop.PNG | Bin 10375 -> 12858 bytes 2 files changed, 5 insertions(+), 7 deletions(-) diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index 404fb72..a53b5b4 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -328,7 +328,7 @@ Alternatively, you can also click on `Push origin` in the top bar. Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for **quick fixes** when you dont want to launch GitHub Dekstop or VS Code. However, we would recommend to limit the use of this feature to quick changes as the other workflows allow for more complex tasks. -```{include} githu_dev.md +```{include} github_dev.md ``` ```` @@ -391,7 +391,7 @@ jupyter-book build --all Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: -```{figure} ../figures/buildbook.PNG +```{figure} figures/buildbook.PNG Output ``` @@ -470,7 +470,7 @@ jupyter-book build --all Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: -```{figure} ../figures/buildbook.PNG +```{figure} figures/buildbook.PNG Output ``` @@ -505,8 +505,6 @@ width: 100% Push origin ``` - - ```` ````` `````` @@ -574,7 +572,7 @@ Note: use `--all` for the jupyter-book whenever building a book to make sure the Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: -```{figure} ../figures/buildbook.PNG +```{figure} figures/buildbook.PNG Output ``` @@ -662,7 +660,7 @@ Note: use `--all` for the jupyter-book whenever building a book to make sure the Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: -```{figure} ../figures/buildbook.PNG +```{figure} figures/buildbook.PNG Output ``` diff --git a/book/workflows/figures/Push_GitHubDesktop.PNG b/book/workflows/figures/Push_GitHubDesktop.PNG index 49d499ddaf27af8007d1ae6cf9477f3ccb9d5742..70c3275e72ec29ecadf844593d5bdab311450dc8 100644 GIT binary patch literal 12858 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 From 2bf5f39ead1ce2e832bdda8fa3e1b596f042e793 Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 4 Nov 2024 22:05:56 +0100 Subject: [PATCH 10/21] equation error --- book/basic-features/equations.md | 8 +++++--- book/workflows/edit_book.md | 14 ++++++++------ book/workflows/figures/Push_GitHubDesktop2.PNG | Bin 22088 -> 0 bytes 3 files changed, 13 insertions(+), 9 deletions(-) delete mode 100644 book/workflows/figures/Push_GitHubDesktop2.PNG diff --git a/book/basic-features/equations.md b/book/basic-features/equations.md index 1aa80d1..e1684bd 100644 --- a/book/basic-features/equations.md +++ b/book/basic-features/equations.md @@ -1,6 +1,8 @@ # Equations -Equations can be included in two ways: inline or display mode. To make an inline equation, just put the LaTeX equation between \$-signs. For example, `$F = m \cdot a$` produces: $F = m \cdot a$. +Equations can be included in two ways: inline or display mode. + +To make an inline equation, just put the LaTeX equation between \$-signs. For example, `$F = m \cdot a$` produces: $F = m \cdot a$. Display mode equations (the ones that take up a whole line), can be inserted using double \$-signs, like this: @@ -35,9 +37,9 @@ Resulting in: $$ F = m \cdot a -$$ (newtons_second_law) +$$ (newtons_second_law_2) -Equation {eq}`newtons_second_law` can now be referred to. +Equation {eq}`newtons_second_law_2` can now be referred to. > **Note** > diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index a53b5b4..89d391a 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -158,23 +158,25 @@ Demonstration, video available [here](https://youtu.be/bThimdDRXTc) 1. Make some changes to a file in for example VS Code and save them. -2. Select the files ready to be added to Git-timeline (staging)
-For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: +2. Select the files ready to be added to Git-timeline (staging). + + For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: ```{figure} ../images/git-new-file.png The new file appears in the Source Control menu. ``` -Notice that there is a green letter U placed besides the file, meaning that our file is untracked. To add a file to the *staging area*, click on the + that appears when you hover over the file. + Notice that there is a green letter U placed besides the file, meaning that our file is untracked. To add a file to the *staging area*, click on the + that appears when you hover over the file. -3. Adding changes to the Git-timeline (committing)
-Next, in the field that says "Message", write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, the menu should now look something like this: +3. Adding changes to the Git-timeline (committing) + + Next, in the field that says "Message", write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, the menu should now look something like this: ```{figure} ../images/git-file-added.png The new file has been staged, and we've written a Commit Message. ``` -Now, we are ready to add the changes to the repository. This is done by *committing* the staged changes. To do this, simply press the big, blue "Commit" button in the Source Control menu. + Now, we are ready to add the changes to the repository. This is done by *committing* the staged changes. To do this, simply press the big, blue "Commit" button in the Source Control menu. 4. In the bottom left corner, next to the branch name, click the "Synchronize Changes" button (the one that looks like this: 🔄, highlighted in the image below) to push the changes to GitLab. diff --git a/book/workflows/figures/Push_GitHubDesktop2.PNG b/book/workflows/figures/Push_GitHubDesktop2.PNG deleted file mode 100644 index ff74fb973c484bc03e23fd77fe4e37ebbf67f2ae..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22088 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 A>;M1& From 71ee9610a605a56c9faa6bea3e5a6e5fd8d4a1f4 Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Mon, 4 Nov 2024 22:28:40 +0100 Subject: [PATCH 11/21] some more fixes --- book/basic-features/References.md | 5 +++-- book/examples/h5p_examples.md | 3 ++- book/workflows/edit_book.md | 2 +- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/book/basic-features/References.md b/book/basic-features/References.md index 1a8c1ee..c2e5a27 100644 --- a/book/basic-features/References.md +++ b/book/basic-features/References.md @@ -8,7 +8,8 @@ To make references to figures, equations et cetera, use the following syntax: **Examples** -Using ``{numref}`Figure {number} ` `` produces the output: {numref}`Figure {number} `. +- Using ``{numref}`Figure {number} ` `` produces the output: {numref}`Figure {number} `. + ```{figure} ../images/git-push.png --- width: 50% @@ -17,7 +18,7 @@ name: fig-gitpush Some caption here ``` -Or, the derivation results in equation {eq}``. +- Using ``{eq}`` `` to refer to Newton's second law {eq}`eq:Newton`. $$ F = m\cdot a $$(eq:Newton) diff --git a/book/examples/h5p_examples.md b/book/examples/h5p_examples.md index 85ea397..bce73d9 100644 --- a/book/examples/h5p_examples.md +++ b/book/examples/h5p_examples.md @@ -5,7 +5,8 @@ This page will show some examples of H5p quizzes built into a variety of TeachBo ## Getting started with H5p Some best-practices on the use of H5p: - - To startup your H5p-account, first login to H5p via Brightspace (follow instructions as under [https://www.tudelft.nl/teaching-support/educational-tools/h5p](https://www.tudelft.nl/teaching-support/educational-tools/h5p)). After that, direct login is possible via [tudelft.h5p.com](tudelft.h5p.com) + - To startup your H5p-account, first login to H5p via Brightspace. You can follow instructions as under [https://www.tudelft.nl/teaching-support/educational-tools/h5p](https://www.tudelft.nl/teaching-support/educational-tools/h5p). + - After that, direct login is possible via [tudelft.h5p.com](https://tudelft.h5p.com) - Place your H5p-elements in a shared folder in H5p. - Disable the display options "Toolbar Below Content" and "Display author's name to public (anonymous users) (only relevant when content's status is set to Public )" for each diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index 89d391a..7dd100a 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -702,7 +702,7 @@ Alternatively, you can also click on `Push origin` in the top bar. Using this feature, you can open VS Code in your browser and edit the files in your repository. This can be really useful for **quick fixes** when you dont want to launch GitHub Dekstop or VS Code. However, we would recommend to limit the use of this feature to quick changes as the other workflows allow for more complex tasks. -```{include} githu_dev.md +```{include} github_dev.md ``` ```` From a5159e02801eefd835a5c807bae5c6edd15693df Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Tue, 5 Nov 2024 19:31:07 +0100 Subject: [PATCH 12/21] fixes --- .../figures/Merge_Request_GitLab.PNG | Bin 0 -> 49757 bytes book/workflows/merge_request.md | 20 +++++++++--------- 2 files changed, 10 insertions(+), 10 deletions(-) create mode 100644 book/workflows/figures/Merge_Request_GitLab.PNG diff --git a/book/workflows/figures/Merge_Request_GitLab.PNG b/book/workflows/figures/Merge_Request_GitLab.PNG new file mode 100644 index 0000000000000000000000000000000000000000..b7bfaa351c32043b3475c82c83a9d7537bddcf72 GIT binary patch literal 49757 zcmdqJcT|&2_cm$+E23f}G?6A77XEfg~qBKELmM&syh?bI$kAS!dP)?lSj%&)&0V&$X}F!>8xkDs-0smrk8JMW?3v zRPWTOa}uXcow~1_=Zi0MovR&FTFflll40J`qjpx1CF5Df z*>|TdzPomT{oRLaPy7hS#YLdy8P7fise_s5e2p3W==$&sC|^5W*1&r>5LjE(hhm_% z?@xIxehzf@@8PMT8=7?g9;#|Qq{{kFxhL3y`SgDEEDXCpy>Ng$@zbKDY-BjjlL-*&7=8r{eklsu)rjleYr<9gzPppD##| z;^3M-<$!|>qDtBRQ)y=)Kr=#v$9DOvNbF$c2QNIFUB(l}uVS(-FvWo-h=T?hUtP10qmN(NFKZ{@X*3(rKu$T}!{%`>QGp(tSo#^HO{Q;#Y2h4U2j zgc~R&N`J(jM=z`l*Bop{XtzW2lPuzT-i*geaGKK6`DwAx$LeOX?4AE!8sV90W7h5@ zx-x%1^_4zB|51|BOL`_%>-|#0?p?R{3s;Ru$uYJ>jKlAH!~KXW860vD=bB_m=chhB z&kvY*>lgoN_$k*E{5P}Mw^0@8%`BG3(5&In5Ig6DwROoSa%MDUKFb)Ots5&9OQdNvHvFjjdR9FWjHVpw)5;qRW0Dl8@L#^n?BwBQp z;OcJFQM#xWjmNOhSSxMxH#eQ6u6#EXpD=1+G&St%yM>6Nqhl%UQ>I9RJUac=xSG#$ zZ@!{0qyS1kz9R(|=@atk5|W_%@yiW+u}SCqW1BeGkK`e6{5REcdzqs2N}D<2rOb=Q zNT)Y8doZnvB$irUmkx~TiGq)pbN3U*8J(aHAAIEpnBe93{%IsL&1uO zlS?$p(y9xEj#UCDMI^V<9>_|L0}r@XXDUB5mCHYbW;--jIxkj((brQs6XX_KOIQiJ z*-@Rt0Wum}*E3J+W*pb>I{9s>$uwGh^+HkDa*w~pso|`b#gUrr^@?3wGO@);1M>Hy z9IPT{AKR$YBidArw4u~6iLYI-|1ST z@wAzHS19V)qCT!Wo7t_4To;4adm;2kZ=%?kFw=(8ozX)JY$V?PYr1>I*-e?oj1ZLeYJ9H55jXPUut^zShW z^ZTrlr+N5i{0&(8V>j9T&8s_o>wJnecNy;lt0&rY^OFp~sllHjKNa6HwM7eHXBfOt zEKw45fi8?EeNRz{i`}}}OAB_s;bR^>zTWAF-1-uplnh04p-KBD_UT3>pW9W#pyRb4 z@A8zx{yNE&fr`9#EEqj(C)r-h#p7&v`2L9SQHBx~n@zbzoJ?A9A|4`e*YIDX(nFeE z-yR_L#y2?q>|lO-d&}AF=onv?)|_doWl_qPCy`LjRcOh|Tz&g1!(15+y+ERlubTE3 zMHG1E&?$ZY{2-iXk*({jB#z^<^LJ*)xbq9G(O`ISvC|XEV6nl&eP~|E(O>mL6wv>Gb*uAywvOk#Q~1rOKivmTTDO zX#_39L;6hiVdaSUPkjA77df~7i%i=`=fPR(<^wc zvT-7=nBCJ@vO#AJihXq?dCEVo5EJ7#7BkS62W9&pdYB8=O1jJmsammePH9*4`lBnk z1Ho^I#F0TaTm8|~gu$6_p4-?H5)%$nFfEO>hWJekc*?s+=A-hYT_jZ#Ze27%uq93D z76C<_fyLh?<&>&-3KH~|08Aoz%4yKvWDesRT)N1umCT9+QS~I39qD=dXaF$dQM1|N zpf|IEipMA-hHI-XtWva;96ZC58ObE9Q3D-{ERCMMNJMfqw`zm66X>?{rp=H!&8=7u ztP|u)e~hlu39jui8ypyYwE?+zFy(^hl@V24{6uQ*D?~B7+rPC{>$|C-Y^U01xp(lA zc&`5tBo3uOSfbzKHN`63E-hVA?ZP;G`s;V@n2cZ^05~=^Pf@~4zNrOAs`lYz9#e+9 zv9nlQmj-yaqqd6)n$E0S`CZF1iei>w0TB$>IJP}xk=>+U$i>O3l@)&3QBd?m#V2LP zSKh&V%GtW^1Ti!D&5++DH{D#qWjqo~x3f>FYggS(QAu-(zaQE|>r`|yoxD=Q zK)<({2R!C!C~-r7E6vyy4()VlXv(MbCXMo&+j&-6H(Ywf?X2#~_+#%0ytwxbFWL68 zZMSk!mTi%9`KLaC*D(Y~xMzvXZn*^>sBLI8e(qTd^Q~(tc5muhM(hV)9|pt-Fn=9V zM#Oa5He5aXGGy*ox!cjFizW7*xBIWWjZ3|Qj*YNF@r~kYm1!<7R+r&BV^3USlNwD7 zOD1`EblxvqE}+f@8HMg@l9~f9n>9gxOwFRtY0@+9micsF0besl8q(wy;iUXv&xMaQ zE3nlJQj@~q*t~Xr>yb{hDrJlq@oL>j(BB$c4#=M|zV~I`H5mZx`!W}Mb3rI}3OT!E z@FVytWL?0&ep0St?nS3eapK|C)aA1N^F1yV9Lq zwSiMwWz6G^-@_RZtGp6L{d*HCTc&0wh z%f5EcW+%1buyl5(E*(JSll9JH`oo@(kA>SiV7RsLMf?})B!?o_d!BSwttfPNdoJcu z%7!;fE{}ezqbON>IB)HoUz^fd*j6!^7{xueN^Gb#_h3jrJ;$@b))eW}{mqAHq0{-q zjfk!%fP(s=iUkL3eZ3JP5>JBB^o!ptied#du1;DfO=yYg(&P=-NPmbdoISc_cwI`+ z0dlx@11QJ^vPLny&@zKfkxk5jR;0POtFDdv@momR&R;S3PN#tW_ZIWEdxOzUrzM1I zNXo*Wn@Kh#bvUC~BX<*BrH zWb%}cXDeEhwv0UEfJ!vnG2ovJmiF>~q%-GXmJ@55bfmDYx6J4bM3-L6a2C6a=w>BS z?^egJ3+qW)+N``uaa-GkK?GepomIuHu;jqUf7IIK2GspLoy6Hh$K$%YNH!+<=SB4jL~j?xg@eZGHJDBGE%g1STbUC~XzuVqdP~%?`Z%t?Mf@+s_W`JCtVZ ztgr11Yk1~1mJN?u+-SVZ6?zCt)#-}YZrH%1>(1yjG@dM=N2*VLo)E{~-a3D*)Ng`J z@`&!tmqu<|o=J3%U3P6|Y`LiEIU>D&%_OtXsy;wXn{|S}I7u1`Y!bCI_c9Lqpr2Q& z5--PX^&CT;NqByTv&&?+#7jL%kW%XZ@v4he+#WHGU{{vd4;yjFQ%>xezU9G|JCSwW z)JV`4nhniAJn;J%>jBK15F94%#N?VHq?5g}!!}K1 zcAck@+2+?d1a2{*-eoe8X~Ri-n0&ohevxF+Irht=n1EJB|Aao{@Bb zzS216Td&(s-nxzS+IQb*EI?Jm0Y*-I3(pH-(?M81m!-q?`B;aLmN+OX`j-FkLNd?h zScUHm+Go8ul>3?fyFVs>CzQWI8bTz|(g|BBMs|*Gd{GRoT!nnaA8EfvSV2BkMydA| zeV@5lZJ$$ezv0s+c5PlyZ;36H9AtWene6Y_SF_ln9cLK>TDNs(48gSdkFT!VK6Wc2 z17^pwu+Q9Dg$*;7leUuP#6-c)HZW|ccHL)(fECJCXFclqIzEwQ03 z;A#_$)qh9zK8Wfd-sXj-MJ&0E+J^Ul#dSru+$Cwf4+b9kbypudI7|_$rbtRZ3J$#A zd|2+%p@a#|BNoR8J#D)N`Uog*IBeqC?U73S6Ah%$H$$5H#9rEvcG!K>s|Koj^_OI- z78w|&UeK^M_udy)BZmw4b8$43ks#yT@B%5)j;c5?ZO)79$Mpa$;+v_o+@n!RF6ph`eK>BSzes zSLBc9!#XtddUO;uvq`HErXy?IvO81C4Z3!-&9R7?bV$42&qELU>kEyjx(~SGV2~0^ zD%b6CQP0Xs;Vx{-e1%nPaB(}PQ-Fiv*H!%v+a=|ga(H0|(D~C75~)dxyHGL6f68q! z%b(6Om)T58!(x3zrQPkqQbbX1bL(JjLQf19y0>vjA=N6P#|wA+CVVW8%DylPRfc2ge6C~a81%V8f>4rB=0{K}^TnfDi=hZN^Cg+nPVv=Bkpp5k*OleY+ zLTrV6Y}Z3_dZ@V9yE%`XX&M~h1$%Bs5JotVd^g0170 zRaSYSWVu%>VzuB>{U8q{Gz4=K9V;>;Qqr-cE^~9aWA7cwtj@$k6e<%`vKMwbHV!H+ zk1)^({(vxaPJnZq^k>REiP*V>XY1wc{aE4M9Nf#?ta@o=U7j}u0Puxft<2Ym)HH?a ztD7iM0^+HC5c`(`nQ&yu3;m#xz?0h~ia|S^N?ItH8U8xhr4f7CzSjcaa~!F>JlCf2 zh4OoE)!`Gf_FU=Rh7!Za>6MWRv!+kVEJTlrOgHJ1j20o^TwT+rNvvz^h0O*8m%AoW zCR!Bk_c(_-lhTQj2C}4>e=MVvRM%dyHrt31n_OrdW2)NT4%$P;qe}E7O{Fw1YEwFD zJnX)0nYzo@8rOU6Re*1gE^WBKOI*QmCRpICsLtT^Qa%^Z0f%PIDY?s%^Cjhvyp&a%$S*3#6%WVm4AxKXJs)7SATDQNXQ>= zO)U<*4lG+LFD@K1?>RQ+P zq;R9pW=v6$n8)f+ZmJ>iXxDRV9CQzhz2kftqhktT6ReHc72|PoUa7&jOz62_qJ#g? zT~y;w%pRm7)8eM97bb5I{r7~A(F3<9RkAaUfl$$v8fQ9}c=iAFwZR8@p)XYjpX%|M2~PL^}(br&aBEjjVT!l$7-< zP+jVS^PII{5};Q&EErrrOWUpDxvb&7ZI#OJ|6lKNw1$*eAWb|xJQlvcIV+jF=otB0 zLDkq89?m4C9eRZ^w&J#snS+L-VoF6snOXgPd{pKG78Eqft8U)4zOofbsLaoh@EG2O z@n|Ot7$GdGjkvfIWdEAhqwbj7dF>z_1uob=7-qCZM!_DS4xkhZMdAtvH1D)oqkxK} zVDz?IRO~EXFj}iaXp*6DIQ}&B?)pe+9OaOWlI?Z4&(^6>Bxt6vJB?6Vjs)-I((EO{ z_Mrq}3PHFghgcs-%o0fbI-ycMxL|vJ@rMNT>uGTVri6IrgiIi|?d}~$M6(bL&2a>J z_A3xSX><><+b!;&K{htxRWO0{kLdhIf!WwpKt~i?66^p^PIpcrvcw3JjcMhNy^lV? z4$ng+pOqzaHnARPe27fX(O7!GI8YsT$xp7Ezgv6kO5vdXX{bDT4@@x#4!~um`22Pp zPWNzL%52MnV%E1QLg{k8HC%1WKZv@7R~?Ou8L&-$mSEY(`rMpM7VI%2tW$0-v;jI|r7@shASy zJK5P{WX|@^-|DG=i}nz+Nug|fqbX~!XQkOUH4m#w8*e?w?1PDS7>Cc206DuRcu=|P zCT(hLa<$WFs#AMZswHSH?mrgmu$R}qzd32G8DZ*L--=4+?8SZcN?Dk>#yJ`ox4c#*C4SyNS+_@1pVTuGuFi z3U-;{U)<~_;};l3{R--R4z?5|xzheKdQ^%fCCb1kp@S*UsFUA~6p0&YQhs^utBXU& zk&RsZ+=fU2eldLF)sWGN`31*~*GR?SW#3?xVA2eZ7=8&6*-PFT@G?RR0LR4|;=KF< z-uxVsqZwW(m&=HOXD|w(hsIoX+kZ**hKGfmrysxhf#XAzs*4LIVvxF0ltiL=zcleQ zRQ12?$RHJPmi9_CWw}3Cr>~@e<3?Ik;5Mx5k3lO<<7+G2aEhs77b69ug?#0OcOu8F z=~HK#<>Zrf9$BB?*!yB%T+)4{QFwTWc;aod#&)C`o>f)2y^!#4jvJC|6N`5|M$>Upp-J6a=11)%euYNh)cZ?+ra!Y?rsuoW)0vc9t&2SW z8JB|)tq2_;NuR0*a(YSnp$kJi828(p_we`aqc9-ZoZ(mF+Q63(eSOYyc4dXU_88;- zssPYDj&ckWuD5Q!Wo=jo35NsRwIZCHxQY{!0rXR&Y8m*EVOE)&w{CSu1^@mQ&b(cw zb$#bZ1sM1wiCd|jsVLM7eEtES+%QjnVlL?>dR>1wRh7xSm-_@lUY zP)M>*r&m!JXHz~t@jT$SPgMKW zv2`WX#6E&TL@f4}p^>DVbtTwr>fqOePRv6wLs^};v-{FNh_yMbEJ3#8j?lC-5!1>f zqFv{~*3la(8E7}$-n)b?6=Lg6XWMBos#NJVKj)X#j1#_v%E!z$y_%<$xfH_I6FK{jw_&O5Q{a@34!ybRmZEuQp904Xq(p z)`;HVELQy>sB-w`0V)>C@!3DDV|r*2+3T_3m5?T6!QTp-_?F9)LRBEc7bz7|KjjG6 zJxZCQ2p^o_fZ_q)T44!a;ou~G|Ju|V>EGMHPCTUp7elXj_}wDm(w#J^7B7H6*d^`G z)nOi+$tg|$!^l3-Kv2)u_#B4~Nj`o#S3A>izhjovxmPRCW4zWUT9a>^1bjlH<9IfW zKWtcW^i=aij^ZZ&tKC&15_7$n0TaayR5u%GkZpWuZTUyuMFPfL`&aSaqtS~Mn{O51 z_aj)o@wAp(cPy0F&cw1Sg;EzpYJDHTJCD&6)8aBF=zL@>h zSECG~mX2p<79ozGB~ujEIY6}$OfRJ*rfX}zH#O{aCGbnOS&!pp&tY2>CH15icM@UNJ)AH6(-n|%Uu#gAh%Euaio#BQzxfb!?C?`*`KX0NkFM154I2;R2>*{0?a;D< zoDj+>LbbTyM#0h}htIDSZZ+>$BhYiTETC)$U1%laN+gTi#`wr%P<6}ZsC(}?YH6to27S0?jedV20?H?Op`rvc2rO;ki_XlI__BV7f0FUaAN``mq z)fno0&BeiYYd9Z`Vf=wR|8B`2T{$xzwuNNr-|sIPCf$SsW5)OAb8^C zvBR#|y1fqVbYkh32))(+!T&PUz~>MC-oCl(M+D% z8%~^1>2~2D^$^G79@pl&4ktpgLwEWA`j;x^2s?;_*Y6@&!e}?$F8P8~v83zN%V6{< z)HdgdsUw>pDV%5=Cn0X;mAY1gbzwGi1r>cE{mGD_7D1)#6u{rZQ>S`q^8Ui+Q>Svc zlKgu`w9a2twth$q>@MbATSBp9f z89dhXbIqCq+w%TL8>Ww-rzaQ&W*&JCQe!Y5Yp=zBm6Nsk75Qc{*N zT@$fSTct9;9ddx{;z2?i0KxEowX3SKCMFKJ!69WE7+&~g0QB;0grar7XuT)#GC^e=SYjj_ z)yLFi5tjSlZ*!ux-?ep^NC7yc3<9T?wCIrjYOf-qeUiuvo9C6}9%#zCC3ECldM;!Fk-!Sr+=B#|xf(#wE z&8KZl2k4J5yQ@@rrkQ&6v6_~x?S_at_bH;2K@TeT4b;*VZq4?np|PW(4tT~?o*%bl z47~L71Tc%6NxY`~3n$*tE{&cb{#>DCM2((g=oH9lep^E_u3JI|hC$*L{q0-TWUz@A z(F^2=i5JY1us>1_6kQC9ss?Zw`8;YsA3$|Py?0>*kR#~-*1sOY+nB8i<2VQ zwrtyZ#+ckbz>j5%EhcOIVLD##-rEr5iD2Z&zsbgU2k6&rqMU)>L7GQev3W{ZT=Qo2U1?8U#;ha zh#c(oVWjaXLT(G)@j+|N%Y3#iH=(%e=X19y?`og?&D$G_{dV}GxZHXnXMUd3aX3%; zRcUkvE5pe3!UxWb>O)Q+rYwKKU5B1g4xsZt<&3k1Y7sK9Mp@kWx#H8H`JP~7ai5R7 zc&rhTKG;an%ycQ0Y+mp48E*B^-6dDwEminzBiW30X`%s}fadddar55%US7QT!aTQx zWcjfR_)LHQ!Dvyg<+e2A7y_}oCG}KU+ccjr;mMAH>KHUyJK1-2wiK0EtXWv!(Rkc* z!v+VWc&#y>1JwqC@?M@so8|9_jj3Z~|EG)Q}4GJi+SBcyw()^p_=XKi}#Yx*&-}AkAUlbhwWYi!+=OPb&`Ho#<%;bw| zXqQtopK>2WIY}k(lrYx{i{)w z4>^3kTVH-K;xJ6bc$FW5B8q*T=+@sooEFLbkcRYn%(t4Ox$}wI4wMV7` z&ff&y>3{2FE$Fs$%AhrTh{8@9XSfFDPo!tNyfEAV{a6xl@ioib3u#CdtAfP_xJ;+2^D5(d`oNXQ8%r2Q0zQucB}9 zPW$TH2@1v=H->%^YcbZeNJGt8xIn9udlUQA^t4BZ(dNzE90K2b+5Vp(H^h|P$l z?je&@J7Y18{0^ySBX-i8<8u6Rc{*}BVUn+=O}uAF8Mv9puD-zH?Nz`9Z>JAWyXr_= zY+ai;A4ObYGg}|-t*o)!*#4pm%R(RCI~t#SvesD54Kd+l1<(4+0_{*7e}R(YvxkZ! zkk5BzRu84sCaMa{H!+If`L)pjKPF(tR?7a@w8jO2I@CVayM7P3;@xn?4Q@hIRJ$%B zF`~BEl$qLJYwzOTXMUm?u_niCL> z<44}PqhV{CYaDuQJb%8NS1&7x%d9vtJ$tHY@O7PKNq}O4k9|AjxcgQ5O)Ve7vo*$h zGYZqjJj9G=`{(D@3?v@~K$}y{Q#pvj%=Rf%e1| zm@kc;+c5?vYMX!PtO$`rZ{`!<)_nB;RS(Y5k>9-4Z=>op-G&{S+=$q&)0B5$`rQL@ z(k7WHii*+eJ(P%-jheZiP*l(`*ETd+Q|>gzi3NYr?|xg(mlY*|tmD++@sFB+4&oDr zD@giu%Bh&ybICHyC2Agnjb;=cPQh;v(|5%Wz6oqW3Kn(SBnwuO#uSFygcKYpkIUVJ z={q!aFU^daTGTtuZNz2uFQ(kD?YRJhjADN8+vfyvkcLTfX3+ z{@T@dvc@Cbyv4^arF6;z$M!xDo+5ZFjQdO6DT#seNfn(EXbdi12zOk+o6*!Jq8Q5v z&RBev&Vx^qoxWl}f_@HSV|Aa7y<3aG)q7Js-7dbWJ8^84&H z)By}Ik~A^|%s*NmV_r^~#Ce?ARsD@~tCsP3{&?`f%Xr3^{j=(?dD@?R-z3GPf(1BG zA7`=&D}nZfJ)7e<_Ty&{ZW?2ClCatV!n^SXg=g+FhZNJT)K)z>Fpj;&o9~x|_e%BHaBxD!zTonm zL!lybkeGz1Z354TZ-}$Kp_T{fR;2l*8yA;!y5yAR&mV-Qh%(A+rk*ujY`Hb_Rv5jX zaJ-OP-nfuUm*7Dr+$xk~nTF1fL~S%8%t13v4i@F!jO9s6RCA1IaMM!tkFbPHNli2=<_`6Zc^r#U$}VrVIBcy{&+BIRBml+@5eqs|81@3~jr|Ryl%NC%>7rTurTUfuoH)>kVc5q2^nu+ZC5Q(p5peBmH;i z_7+DkiAhw&{&0d6yk5%A_xkk(_Qo3)RNb!h@S!&%EI#-X&GXM3e3vj5`DaVQ z(C2T`HH9x1+TXze8KHFArH;Vz)U+ZQCxQiKjlVuiwvTkuGiTM@RQ4k=Q=A$#{UEhf z4lf+_iMt)#8MM6D;PcVbeDuhpXQvqQbUFQ%yv1+ez&R;k{K5VhXRDB0wLIjK^icy^ zMMY^#*O-NlsPGO4qCwlqv>`>kT+%8qo~)@>2)Z7^$DDiz2q%~#Tc}v~%&?b{gv|No7QvkR)~0@GOju!%WL_8eOJ)JC_!H{!p-Y>i(Qq=l!AQoQP0c#GIy=e zbECJ$mWLk~bUc^dZ?oqf^G@s)Pb`eFfxZ9LB*6(-kV}Qph6KOw82Bis)M_vJluecZ zz;^b0W)SU3e^V|-ydB#Rbex;sC*^>0#w@)H!a6UEEq+Wtn(h1kTu?E%4rI~3#m^nq z(tAflhq|!AD~mI9l*$$-UWuUt`Jzjt-NM`_C#CZG5Q*e==WoZh@#D>Fhh_GKM!Uzq zk^xvfoAA#^8Sc7*VZpO#&*m2+Lg~C5%l<^d$;;KUZl8|FqVvTb<&|FimLHY(SN;Wp z{6F^p=@SJBK>3fBY4dqxS>E(tcti<1 zwM#NTH8vJn+ExpsCi15D+}wk1(!SlMqjfpuC0cnmO)7XQ9~U~X?Y`=~Kk@tA&obRt zlgOcGG+M>_mKdB6wr+T9@;c|1LO;xIbgwo^n^DZxcq@?cC_IQGgsD!&?!tq@GO7Dnx#_{L+Sjy=H1X!wmXObx6WdhlY+9=%4);xMnvr)Wc+fikmLvlMV_cHP( zc1pFj-B{(wbt^vJ8%F#(DNo;<6%m+AxpJ`#^ronheZiO2V~sdCxmF)hkJY-(IQ)HD zI5*vk_&#XQdFmKTOHi*x7fHQ^$pL*=kp53o_A?5emRf!U5<^D1PR38>ml=a`5bU& z3a|MT7w2`)@97HO2rsr{cu5yYb7tM~_z|z2PDExCKigsvipF|VkHOc>Zy)3L1V-Pq z_>?FL-(K_&>#Bu0TL@2rBR=81nnp!9{+A=H%@ltY-ZQB~?RG2tERsr3d|~xT4% zc!|Y7Ty+XrbmStj&Rhd2HGiwTwNdp-$>E-fpj1!79SQqKkyi55c zc_uzMR?{-_t&dMx1tVal=U3CJP57)6*`zVPI=o;(rJ!S@s-)xHhG2aE?i&T6 z<{gZt@nWCJ?|9>SdC->U0ps)2Bb~xN5+&qOK3jv4`9ULF2+f3U?cP$Yc{aN=v}JBJ z`k2>H*5|&bh5PY?jvnsFgW^%l0Ov4R zajxm;XA=agQJDVby2{KV`)ILk?@)oRWqh^9%s7kLh`W}y%QO%DnwI)>;8~wejdcv0 zMQZDFPd&TdF|OKxZqU(gXjb#+&#qfCRYDNIpMpBNzE!FLen~Ub-V@?~k~r-5vFcy} zOPCeg^0@Bupo!l}p;E30|S`Adtak}gT>OaG*~-YdQEhd+^1)|UOlpSVEGkiimpZ|paWxnYDFm{`0` z4r1^R+c0$CsJP2?ov+vAIKIyC&e)xn%KT8CGVek;#OTO}&D?=gLWXkdyX%D&^#f?pD^!ijod$ERf+*6o@f=^}`px+}}8iOqe z#10xW&yEppEH!d_W6=vBvytOhX5k_VKQ5%G&TO-W4deQndH0?#?}CEne;lz=WwL2c zVr3{K_x@oaUmHGq5m{_8OHmi?*i;$Rk!DQUaP7qAwsISz3l$U$ao~iaGMHw4a28yZo8*S zN$di$zL{H8XWw*7i7=AYX<`I4n3)F`FP{kc<9YG=Ud4?t-muRu8HVTbXs4Y2lE{yo z?pXwucxQ`vfZ94-W-tRkP33ZOr@4@(#ldtD!KkuCa>?*qZ{I8InA7`|lm;sGCh1#U zqF02ExGflIP9AXX76iPNvjq#Yl&h%?4y@lR{UmT!tt#i-ANninQ=u?53Udgb(%%-z z3tjwuR51|hR^a9T=O(qRD$BM}=}A^V@%%&aznAW%|3fiyyw146;6|r=e|3Gx1^sW5 z(WATn(30=6q=Y}!t~<%Eo;a5C{>vUdimlqGQj^)NR356jvWl`{HSPle|NJsU!FI@+ zXS!`1Z2X(IRK;!LL}euZ-}C0L7paMI9!ov`GC@QEy&;z`lYfP+{zJxRNyErb94w>y zQfmJBf&&#IpL&$4(yx5s@{+E8&)6R^UyoeKqkZ(*th5mVlu*<%-q&i|E7l7tGbwTc z=x=2|{G;%9iphuH*(m!MB)X#5lvolr-#+%NzO3maUFs#a2Mh5Ca`rkiL zC5MkLB(#Jrw4<&XDdy7vo_IHS-YZrlAjkqei9aZJdnH7E{&Z?j&>K``^udjoj+k&afMeUZfqo;lEba947Z zlAf8_SFfoQw)`9nvuPLgiTPeh2K3TXtFI4}wTCkdR@~eh^aGayu2Kztq z#{QAFs!${_RFjFEqB+I<0%bw?WV2_qocA*YV8nmPwmY#@o&374#u?!(SgIHLrz>w;Q*%u7s2RWa?XMzFE1ll z;T_HINOc=4T;I@M$aML#87SMYRsf#NkvmWf~<2l z1}ZNqBerSIb7|<`lM2dr-ll1}Z(A=D3y%?$0WEb_iHxs#MlMWbe(NoHH#pB}|5_1f zpxA5lX*5b>>*FY=XQwn=(kXP|N?&Z62wx`OWNx!)NOD$Sk2ItBJr!Kag0Su2@Cj3+$)aa>-Pw9d74`dx`PV0VTD zlv5-hSRtv1(!*QiT0_P*D#m@{phfdHlvOUNT6{u&4{@w47qgkTc6^duxo``=lZ1%h z2p0QU_?aP4CpCj3#M!(;%wh-2rE5;=U!z~@t>-O@n!yC+B7(Fm7-!+Ov02V+c{2?9 z=9OGdJy-J0z1S95YZ<*zD?Ut|;|<^qs=Jwf^z8?uRO=pcsq^RTngygs`k;aHNK9Xj zZe-7ELI8xV>;W+4OESTk2)1;rdIOW7^O2d6pm)drL3C~N zdbe+B!eY0l?NJ@MD2+^LCOcPYeMb6gz&Khn4nH*!%Nt968d&Bj7s`cjWL-+Yzo*(6 z(#750@@dt}Wcl4gKVvo@ZQhSZ&2=!jKpfq9N>72G^-94)Z^}L6HMtB4!#&&(vM4{K z4p;5ocPJ5bLf!E-h+^1_d_%g-3F?3C8JUKvUJGWBYOr1?5McbFd7WxNuf5KJvL&pv zBH|33sCFl9yx9O4y=+@{>BaIE-MJQSoazzAS~^~!E77REMC|dKiw|gfq6H=TWVEnF z?rW@>&(3JOcm&Ft(R907#%A^0Yfx+^+@$f;&r+~0=J|%>WH9(9;)^0WXWCBO)_LCO zUUcbUtdzu>AlRx5e4B2hxTZ8l{`hhUu=8_U8a~o@%crMq7_LdE2yn{+n=!O09wc_w$?!2LPV(~f3f#`0 z8I+XckTWceyJ7CyMD{t`!`ZGBovbKs>vvW^rWkss;FNEXvq;4JZXAC6EOlV#>);d7 z{XU6(Q54N!!cU!^42EgkBxmlHzcr*uNaH^A`9|VF=6+vV0fjh+9gbiWEusjA%MgmF zz4)SLQeN2(A1P#q3+qGPRtk8ZlG8h#)VaXV^X| zmi_e+cQK(sI~-Wd`EfPOMl0f-b%7#?y@tLQC+f?n_f^EQkGd`97{*4!Mi=XD&2zZU z%J}C$B%F%Y{^N_yKuR>prrbzwV~t4VVcf~n-JfUNu5Fx4&n)~^KH<;sZe-?JtnJy$ z49^R)q|~byBDN_Fh18uzbecC37&#s8Nu&I(#==eIM>FL({282)d%}67<&PQSH)e?= z$(D-Eg)v!y@8MX{S8oNz^*DLXx^;ZK`0;G=&dm6=l#2eZEh)mUJl7;VlVm=AE<6rzy>^*GH3mfTbigiu+M8YPgl`CITFJ3I_ z_$lh`zazmYzRxi3QSbvbo-L^@y40Dd%96l0ihg<^6L**X@k`=BvRIMMTkp>&gsrOL z(Sl1iZhvPQo{J%i)()`VS!ZNO&+R{nUGc~1(RJ9YYzb|vdLfIGJ?07meMxyCij*hz zN9Yx;*=2rpo1;`cx(`~gJwT)tDi?Nd#<yzKTY zoZ%au%013i_j{fO);l}WXrSUVibvU-ln;p0^E2{HokH2vD!X$7db^!Cr{v~JA zjDb9;Re)(5B|2gcN#0qL?GI+5?sG!j*!MQB6An-u!ANsW<~IqXubU>$>0ZO(lB0tQ z@W)GRN;Bmw%BpMuf84<%-9|O;BKcyNn1LwJGjw;V2&i;-Ne&1|_aLIw07JtNg9t;149pBE=Rtkncdh?9AI>^!o#F$FHBZdV z-goWmzV@|$5pEP&i|-`?_#68Qn&^qf=M@CWWYaB zV6Jpqct)i@MpZi<1IW9>q`r4j zq%7j1jt97BT~$eE!)^RjA2TS_Bfet2LkG&`(POvEU_v(lnA?P^T7e81q+Hgxrplx9 z(n_`Tc#}Ors>^}@h@kOUHTtXd2`^R`!DpAKO%>W{H>F3|QguuB3?*fFZ>Mo;X4SiA zX~Nip5sd94JIRWFsog47wxx+0)HVipwROtlBm84xiL-xAmH>1m>e4F?wW-g3?ES+i zq#ahwmn3mafcI)HEj*TOl6_QRG37dd7zu|7Qwv3!u|I9^jQ zv_J+TvmsM+Cuvre{gL5$G2kqv3sM(IwJdqyTk2NB@Z9jyj#}8>@Az!}>V>Nh;Y~=& z(eq7fl{~`+weI!Lk1RC~wIcJN`K721EoL&0l*>^W^*R`d0DH;}HUWh+XufbZ=L=pf zew}%NdhPexMQeoJ0vQ zrjhJM6+wtkt+vz5bU?&44Yf=sEo1ZDDnZ*eW2O9ed?3005<^do-Q^%A%RX;tYnxkbs?J zrlrZIlOUsngrcRahRId!T$_MRO)x8Qgcue+zAgB$XF={=x6I2IV3|c!S5p24-*X9v zB8e#tunb$suT4y?{FYo+?CJAkmAQM3)e1SBhTl`<&gaSp`Aw0!{gjB&q;$Yu~$!hr-3)yN~w? zAC}x&>5ajnI_$8~k8~!>9(Zuid8%01vu@B5kahE7ciPP%9N&JCUQmx-dIH1==0$te zdhP2%-=dV4QB8bL96w%(s`500MNe5dwbxuM!ItXVR&en2OwwFcbm5 z$0*Psr`y}4wy}947x`pm8&O%JI(D(YTMEEQTp!vmZ{HTYe!;Np?^jFf7qI-xSj%(D zZ@;unWb2aGY^x2HDVV2}7<^up`}E)0XtQy+D;W;q;mQS>{~}Ue8od1fh8g~snVZqh z_S!nx@d*i9Z0w>@ztir3U-?3hx3Af%=ZV;9g9|=xy#Y+fmdayV&Gy%f!}o?wUgECS z2@e}x5Fh6$jsJzm*|uI7(8lrNm+dR8*<3z@?_K?rlftc&lGp|4EC%4o_4I~?|X}9$^IB8;X0TB#0$EU2ccbic$T8q z_~CBhtV$#8pR0_wiskIh?8ie<^gq;1jT~&~-(1^ag$+cJPI&*hBThVx8VabZU24~R zW1@TeUQ@y0s1xw^hsM((A9R_2H5mC1uqTB0dZcP1kh1)2RYo`A4o=(`55FwF_UF4_ zLPvPb?WJ4tAXcQN!79HX;R4?0rr3p(g?WeN;`Q^G7j7z*7;pNEhiol)L0SwID$yRR zL-3O&7KL*?estG*?XoY@EueT^VSfC{ z0AyBrbjb#wDf9)T#MKRlqtmF9b8X-r^ZxxF5+(4#j)}EYjLB3^LUrjJU5~pnmUVrk zqH18;f!rWNK+J0Kjcm5dRPORg>C$Vpq?P%&r>*@d%e`BexBs~(G zLvvCjvFL8nfXL+}?hxnEQ*(@KChzVQV_<{;;ZzBUqbMP}r6vM4d9>Mz1REnE-?5JnV&_JW9_i z0P^L5e#$P?(5SNaUE2``HhZs(C&+1~;Tv|p=44DHe$~Y1@r=bP%!qNfBa=y@1()(_ zSIrxn{Is`Lv*{qp?xoi(l*XyMm*+nFIjgx;+4!EG9PRfSVXz z1Kb`QWCH5RNMuo0N`>U4emT27u-8yAi$=B5$L-GV6YMuXDzvZ{Z?07{)?`sGDP5Yl zKVGs~6J-5xLARZ*Lk&mQ!RYB@7B;YyCKXAk7*U@fUMP1MRR zX;T~8bOcTCb6Ti9VeW_8Q+S%dEc*K=@HCq24xR_TXDwM}H(G^E@2ydC*|tQL#K2y+X3pX{cwWn~KTC&&X1k1%;^X?e7L9JwjkJU9O-b9lCox=DT}EePm+Df^~S)yoa znukei`Tj240{|a42T`MVRSMqLr^h1`31=4S>mxlTV(xJ_mjn7g%NDKhH`4JHE2D4r zjp7GAa6V63Se26(4Eg0Y{MAzMgjgL!5;`3n_gva}V=bM^%`Kv>YBNPdZiO3>$V8sC z+TULRxs|Y4gxNITK+Ov+_8rTB~2RjW$&$N>y*sEa}<5qrIOa8DoI=h zg@5`xA<=_oWUXXEz)p+l&Iu}(QA&zBu22b6ESJB$VG32(Ly|sIPh(>Bl21ivaDjYx6_cvfNX=epTtpgN@$5U2InA6_+8LQ!xA!yJJ331PO+=d7Lv_L3>W$rKQ z`H*ccfwIDJhZkw>Qm4i6>|$plg7tLLc2MtBAo}D$y3{ zvn3@5I+sfpEppllLQxBEZjywI5fAw>_*c&o$L<}AZOJKykVV#KYD`%@iNS1>Ss zkp<>7Gb3X>RQO?Kl4%FDa?og*=<~b-mh;Z)H1ed&r6ucyU@wyRtC1dC>-~0~-Bo{h z1LDc7q@|1ssmCeoyi=|Ifgjm{@x`k9SG z3L%qr$421S(A(0PcW1ud0K`zaszn~a=4wC|zNg=RMF1Jf!^QC%kNHA|276Qy+KegEC4gbW(x;Q9nh)*8Y0PYaC4bdA6x zmk;AN{H_VsIld>6s2C53;$VWY>D2M!(c|HlokJW_Ju4x_-=au|NTOXxQI7)PuSp-T z7#RQF{YqPoQC55DBi$?w=5WFb@f5k}nQ>N8)!Z>ZPgL|^ z?72;0oY}z#rEN1IFIDXV69hn81MfGdigw(kMTes}6*c*byFti9DBi!QDCXVwftR1q zI@-tktX#uxhN|@>LOpw`q$0tii7UNn)KfhDcZHqu1zMjYx_#Y!vO{zMxT6w|;(3oQ zI;!5_pInJ7NK%d7Warg6n_K!uvOe2W4r6{9&8>ffnpm?TR&PDtnt1PuvDeuq`@$jZ zkU4Nx=;QfL>FO#9mQE>#{rJxD2up>f9j^VStyXF1V~V2=-lS^(Op;KN#J4kc>3?x&DDF-sMr*l#bumpllMt_^dA*fm zKRYa(+2t3sQestwlg!=7oG8$4v7Dp4lR>SB;-LZ;RL}5!?xh&2DgOZ; z!t?ds|29#xZyPOv@%V04(d>QDAJ_Ri9nv*)&erklM7(p;8k2EvY*RSZuJO$dlvT=4<{L7E}|bw#?d`GNW(o#W1n&VPwIl_t8vXJ?M7xtU{I)4~(AJ-e-fle-EyCYZ^gEuH#;b;F*( z2g*W{qx8v4kjQ@~RvBgJTjA;rvr|O|8$((9ZDkY2!R~VRk^=aRJD3B6eIdSI`9Mi6 z%R0*II;;GlFmJG%Bki_>5q2QP=k= z4@*~$i&_ifZk;$cvrP`x$-cd1HQ|-Rm~Fetr(hR|K=LjLk_`yE zD=XYy)ST5t>7z~cO83_qi%)F_Bx|ewEI;6v(0FP)bNdHky3FK~X`JmQTMRs~pIXn4 zUz7+>I9FsagFs(~XpU5)J+(d3srQI-uU*3a!$14OX7wjjxqEu}5A1-irfzoUvVUO& zJ5JtWuZXXt7p+b7L@|`;d;i`~s9wK_^uqwHGc$WZ6+pO4fkqG{=-(ZVdU6nA^TZN= zu5*6Yxz_H!TPpEeZ$u8AlHT^)z^X*Q5go?75!LAG>%ht+YqK;syf5dC?2QU~v^pxI z3bCI?lMtmE8O2AcRxdBvbaU_V(zrJ~#idSVwDbQ)a{?VwPscvZU%c8y{5SGyO9sF) z1OOXNEvv#I5Wt8_*;N0e#lFm>P>CM@JYE_Bo=8P^U`<#;kod^q&$QoCodxFq3ySpe zy8Ld6)OJ0$psV~|(SL_SF@Bdml0E8n$W)E1gwU^9Q?SDR$8c7H^z~K$$yX+7`S^Fz zz>5?bDZ>B2W6~RD_JxH1hCv0{|Bs}Z7iL2>wY1nTKuP)EZU9&~_eM}JaW^tT0hzI~ zvY}omI2m{2@3oo7Gc?0=PdzS_wTb~i6Dlqs^sh_zW{8J#Ug8KdBIQ6J!I|ihF_nX3 zsy`BB02W$LYR3a0nzl_qO8IZk0M89S_z!IP|78OG=vuLy&IA=38(Z>+4_*I)xc{+d z7`?!CGZFzy0O@K_`jVlU%mx_65M(96wH<9`a245OBqWceS{(q>$0GMl+o?d0|#8Qz~qf5!SvpxsNK~HJW zMKA4q!!o-Pu^ITcL#%%plU&a|AmC59WHQLgLdd`#PAaVyQCz%|Fam>d85|p z_IcSskNd$ZZ>^DCeUT2cjM^!=UN1_TKQA0M=p0vw)^)N^V`8}s{;{=nt8nYxuHs(f zuRIgl5ZqI!{=WVI)__y?Prtn2gv#018GvP6cBtlLmImH5X6sWuVwOuI3pt5Jf5F6} ze-tBv&};7C8S%OwdCNht$&una&1M%V@PWY^YO~9e{pf^kHDls3N2Mnv#95FTU3X-$ zAYI>NzPV8fgJD(+ed#AfsB8Xnq4gFgHch7a8#?ZJ?`C*NN>pihe{nme?iq_IMu_dC zknwOU?i|ky@*hJXR-bFghpLar98($UhZadS4Ij@^&-ncQ7wt&?w3y*AgIz2C23zpp9l1*RPco(f}G?AkCAo#X7sPrQMq4 z_R5_4F*AK_jmPpaVKd&jku zk7tVB%1*NNF>>||bg^y%T&uL@M)0?yOOrV;)febwP3!}&Qj6}W;Jy1==!)H?b~lxlOebIYuE}HIXpgDwM#r*aS~lL9Ch^{ zbENu(V@+>{DsgWaJnk|*E+RRf3N6Wz*Fr@im)MIEUhvYFhHJ%K;jspfug|shiO<%vBZYikgL45|SWYcdesOnL zXr}dS^&zQ;Mfygr#87P-L>)l;TlMZi8+d~bP*;%4919?jlFCAiFd}cKn#rm!+9m6& z9T?=U7D(q5X%-TePOX-ymYDoV*(|GC_(jWHNwX7m4o=`&(MaHWLU7+FeXvo#Gn(aIAcyyQub)EzPBoV%6xD zAhDp8&|tV?nr8facK(n@dP-zR0LH0!b86hzqnR^6^Ll@_)qzmJP2_9onv0R2%dzJX*%R!Y(W_`*Q3lUZ-(ZsW;#1idnW0{AW--b4FvL__w`$dYo zEsb+idvY)<&4&IwSW21=Bv4f)z%ger9nmY{GsiQ(8epSdx@t73XB;p^J{s^zsDTg; z_D@%ty5|0sn&v6s)ZbcuLzw>2pZb)0s?o$7M-%Pi^+WA)eH>B~+hsEnqu#IdSpj-J z`;wCjm5bu8yf)PWE(ecEb`(9SfvrT!m<-O*QzFyzg2#A{Y5pdooy)z?=N*`z-9#0FcJV?n8pm z8z+piKsGgJ$^G-uz+kg+?^UC1d#XHym-ef|GcOTpZMvks^Rif-xJ*bv6P$^E?CN(Q z(fZC@c_2YbG9am?;kM$w@R4{w zi;iIBU=+6Dmy?=q67u6UbqL-o;iHZkX2LX>LUf(DIxo-C7kcT4`+(ba*R1sk|I#JGJH zutAo(oF=CnnbeU$*{I(!bg^nCb!TJFRpA>ICj31sQHYU~4s>hr;cN(}sd4)ThaRAI zAP%tEIpcSZYlZl{@nAmqnNSvz|9JBda)^S-WjABAK;?z zPx_yxJK9kDLc&;$$eHelr}U}_cq~y-b#VE|j`gHGQMTRzUv6t2R$tCZFOTm0UIVEk zS84HzmkO>)I+ zE~wf^F=96O)#pQub#vC6{Cq`Q`@1TMJqO*@*Kkjgq`$lHAy95f0%|I`WeqddYO>Wq z5_48H2&%QJhiaKHCOA$-fH1j3V(GSp{nch~eeSFmkE;%Iih{vQpWm<)c16N1QH2(x z#xgwvIey(Pls(wM5x{k%I2J z!%3%w_=S(Z=8E4R0TO2-*(Ffh*~G#FVsihIZT)@X+Nv<#wZN>FL>MmqTHrEnM!4d+Dk+PpslF%Y zGF=JJn_o5b%_Zsjx6!>HA%R{1a=0?P8Ca|I!Rbd~tJlq=YbY7POCcuV9d=UZn}Q<$ zq$|b`)Iwj*?Ucl$XNh|fQH2*d^!Kvfe`nAK7t}_f?&6|!evpv&__{)dzjm?ViKyBu zz9P?y5?dmCoK#pJ6^HAKe&{}&g`+-{#PE>6Oe!oz_61cH!f8O5$K z40&ZG;nmT+v-qTAs}&!Z2Zl7uPjD%BczrQh0*OAxp4%0Zn3mBC+MBJ_^?BUybv+Tf zwUEg-CkkEN`h~laF8mD!l__ctR~+z=N8MdQatfwH#7B9LL{T(n z+bpTsjRA95<@C0S{wTznGhvCLzUb${KH7wJ99oOTu@O zb?cT1x4h>Wk6vE`QA^gEV~$y~bEaHWqsB8Ed&e=SqT@x6)#ig>R<)oFK9I_ZIC9qe6~*#G*60hKB)Rg{6%>t=ywLi1u1z#+!7CJ_XZqqM=J8c*XYsVor3do$(7j z#|-S%X0A>P2!rVwo;HpIA>eCmYgHIG06h(p7=jVTdg=QAlISaE<-1&p7}qeGu9Y?! zse*g%j#MXlQq}9K^&Ewv+99dU0oG%sECVJ)D=qTcuKHU?6Q^HnsLrY;w|wmz9*o#c zl`*;`1*1#b<S?IAB@f*rW3xPs(%%>0K>RdiY}e?@C^#+ke&%2FCznyX?EDFJ>|EsU|j$SXR1o;=7< zl@l1_Wrzm6IHKspdEG!D5jft>hs++hb}N0YD}BLHU|c(}7VO9VgqtU|_rtGA%CU_k zHn`GcM$Mm0;k=3wZ5wI7BgKN155U4{YTW!ofIez6kU4^YCY+feC^{$J?Qb-Z5es+k zY)zG}F(QUlbk&x~DbxiWy++l3e>UoJ_*Nqz|Ebp);;z2ZKM@MqTW&Inr;ZJh*m>5l z#@xcM))T>sb+XSKGnqFc;Sibw1yV}? zM5wO6@wtl0@!={*QrNYN_!2#ux|v|`{=@zn74^*U@RT2X1U-pYn%3V{j zOGqrN{0&(%2>~q2w!S!=xv4Rnqdn<4;`6YJ;7FA{*JQ155->LwBkaDUWZ5#cr^<0G zx_^6$JUBAw1JCHrktqL-uJdF8nf{9?*_QkM_ALS}6SF^ax1L^AM%!@*fD~Q_ z4n~ULf8mFVe9A((a$%6*UR1PpSpHv7r-BM-i2^ZL#xmu@Rot|K!A6Uxq5EIt!|B$= zMH+w>D2yiw;7|%0JsPtBYy2^S?f%6J4brK(0he0Xn5;EsrnL*qQ9anW`0mYp(ce5P z;IyaZH<)SnZ|%j+YyTUIe*Oz=`JX5!%E+Zk`ft4JQN>E0rfPJ#UM0i7J}ZqT1{3@h z<^SiI9h=I3?k+0g1^tUP_$Vpm%eeHvz$6U=AOZXT&O_0hNaMLE^z&1&Sj-%u&C%e#rO0HNS$TFlNMRCK>$Or+p_QNMqnb1j?uJ zLiv3i>sF-H$|#$u9f00MsO5|v1ua)QgRQ5IrZ+Wo$a|_Mm zVh|Pa%gNy>dbB!QH?-R4K)ag~LCBf%njoU+AWDrVv01$wM_t2~;4*cRUDRbvl@KuM z;dDjkVhGQym?oh-Idw9Zxl9Uz z-2IEHL&K_bUYUAd%jYNhux4%V)JByPyKi-igM}VI!cS?1JG@+Jm!cd}w=nTVAYNQv zcP9n6d#^vW!fSx>pJF+V#GH4xZLF?(9pulV`@b!R+!iYC9z(!ueZ(J;r_$A z>esB)r9z>%iy8KHW+fQt@A-{csz!(RUM*QitrQ34q&CYx8*%IYS z^Xxu*+ewYvza=dU-%6ZV{ZeUX;WS&a(;>r5ODr-~%ASnc5b0@v=H1!)BF5 z&)3-m>=15DKRwE!yB{iHX`LsaJA+_NF8kz=@q*9EcWmtgXU@l2|JVUmai*}Ia-EE` zN;RJ78Nb0yWLim&3i z61TRjwKTxYx#|xXJA4lakUw(D=NRZ$qmrih2^Dc)#n~#LNm#Iaf5hf#$N>)>lF?&6 zP-NfwEZ&MFQ(3E}CdZ#CxkMwyCN`<)q!NyFinRXNhkrFNzdVV6y5L@}qF;%L_SF)M zul7d0c>(SkXc>08&1TwH2UqZuk(i}Hf+yPNn55N^RbK0iv^xPNCSYu@i4kS<&PV&H zcSsqXOp+k=4?}L2bW^S#nI|qe$!298GtqR>J@_TYHYS9Tgb8zm&77vTzOZ zVj6-Qm*p@C8W1>{VflG_yZPz4xw>Jwq`v;WnmI-6Y|9b9kRiH{68g)`S?TBLh+7eS zXa^g0aPq{Sn^6FEr_tv_^|CPNeM+<@`pv-SK0PdW>EYdKWPs*)(ck z#2F-85HJ;#-C37-QKZftPwnFGaRbc2>{1>F0{Oe_7n{bH4W1NcEA7Ink06e7K#08G zeu^q7u^6?0l|%avEH^130LxdQq=%Fk#PehQ=lNOWu=|(gf$=mRL&@OIwELSuPr*fj zbMt&+l8r}?i@S@u_#02oMi(m~S$T%n($!I3jdNo`u)EFHr{1MED^21|csvt&{Gl(0 zN$n$7;I*_mC>EWE(5gXSIl47|ZItimxdRTl5R(*fFdB3Jpq~9OB)_)I64Lj}N#Z1= z)Sqj+Ak|;|QM>lTwaIds`|9lpeU=28XO6K*|BRFJI+IB3IbV^D{nt}}lRA}SiPD+x z)smQSr_caLv)vS08~dao9dxPCTC#+xyHpN)l?3$odnaEF2cWiNoom^v;5S;gq_K|u zR5nWtw*Ih@$|B&|?lcq1VBOxj8nNE`og^}DwX8%EnnA4&8)mW|2v1$KA_ zkn90(@WV-BkHR3QmZZSqV6XY@R#MEzX^I<^o6Efoq5Phcbbj7HB&k~3v}4APtKRk1 zVw$wCrB;vY_G6e%3h`ehMgw&72RI~GrFMyT)cbyjoLDWVtR)4=>sjGfPYTaJB&>~w zmL>87j9AONJ>#XK+yeKuz}N+bv-=N{CVDncSEI*0oH>(zfhRoFbg+g2{5X*yEL$8^ zz!?_0Fs`uJoT;2&9Il(JG74vGvn<`o+A_(^3mSj&qP=OC<#v^=J7 zTK~kVJD&q4?w>wlKXHpdFZV5_C#Xl+TI-7>*~WYAZHXkaQ*07E7Njuor85 zyil$kedg-dn9xzvqI28ty3JlmWx4*$*-~4r8_QfN^SEiv(`q}6I*O?g)?yqis2|O+ zTmNbofhn8;)V81_?>*aQ8DjMJd_vf*)#rJv5#p3(1-AmlEF9k?lQU0^vr52T1m}k? zBOL^kXc)Q`6VC;sx(DdOeMO}9zjzW#9j1oeX*jIEHnOZ$rc4Mlz`4?A(V7&j z>v@}+?JD0IpQAq{LOzrEdG|fiZwt&#?Af|*w*P=Dh2?-GF27ahdtrZiY3OJLrU0E| zS{T%MMxifZjHY+fh-q4_--zjxra162vcQ*%`76-T=Ix6-%`@C7;ArdcyiVa@uZ_O1 z&@*7mixiWWh`o6!z-4UgeA~;b#0vFfRV4S5)1E}ouIBZkVbZx+x+Hq2`(tc+3w*%l zaOC}3`-U(mA#i6!+X%drH4vaaF+nR+7R20M9)o={jM!;Fv_^c`1{<@VVV`Jh3%Fy= z(*+$;>-4sxEGJt zd@Qpl!m1l*wtJ|~91HH*Rn=RF&TkD|c;&qxlPM19s_|K}c1}k*04MWS-3}*NLHu^x zkErZ6>Wm3@NU5Jkb6l*63=3x*mfDQ_;fV<+=MCln;YS&BbP0>BHMi~j%JTSf&cb+; z)$5b%DC80cTy;0jDHQeT^Wif8dQs@=g70YEP*uWI+bh#w+J0Lxk~M-&orQ{e)+vOe z(OYK%x)b{;DTjVHQF@4zWllE!o>$W2{gkA%@^S>-0N#SrH#NN7I^J0hEOHr-jEnnI z60xQSVt#_iKul{*fI>D;;@I`=D_r^h%Ow1!qjl9A> z{mt#>JL}uTpJ)^F@HXlXJ-0rQ7`sn92m5ss1?%L|5jiK93GHe=og|~ucN_z>FcWS% z2dy#y-7M;6(8t#sZe?@tA|z@rR{|OqqMzp&BA1*$Q1XH{V&KvgwhN;5Uu&hFJBq|0 zYh}9Wu;Q!DU6?It3fC&1D@)`@*L6M{aLS7#ngil*3Ps$L3#O`C7}roboE!Z3q*zYX zEnhLjv&d2*>#)K;cVM2ss((yUKHGsoS$n`^D;}ML6RD||maCLP4-_lZ@Vs{NwLn*< zNecTB-s=_hs9NIJPM+OcTKh=qB*&Rsc5L$^|E}EVm6`IMj*W#u6OYX|Q4cD+5u@bT zWf62>>|=P-7T)PonYtBW4+Ti*z{9Wm_26o*Y|`|&f{kN1mlPkGL~lVEpTTh-4X3!q z&nEQ*Tm4l7u*FiLm+AXT%WZhF;r4Bvfzs?N5$ix^u_(pFT^a$wMC%%W1s|22wG# z>r_kvwt`D&cQ!fIamUgrlXy|o@aod+?Msq~^-m;=E;=m)%jrN#n_N~iaG*1{o! zzL+Zi++D)%QAwwq(p>|XWJCCmm*NgF)1oIE%khm8uMtIe1>|l6sZ;loNt4=W!r13C zpkv;Bj5H6@U(Sgwed#ZZ6}5tpmr8qn2bAcJKHZ)4ea)^n!QQ0xYP)tb^xQ>r<+o%-KU|pIgs5 zg_HK;?YnGRJxv4HPr1Ytv9by@x~U32An$^cfG3tLTJ+!@=k)t?jAMo6dvp+Qui?0x z;5Kp4X8p)_>L+e0&mDAScL8=JLtizOg*~MJqep7gfK=jW6HL?GzV2~y$Ek;7Te}X0=bj)tFC?`a-5P zgOc<)Ow@euUCiDT6*=0!_*S8Qvsms^#o$>>=?OBO$c6-Gz*)q%^c2dE8c2TPrREkG zCbbY9#nfsV4VxU8b4&3PSE`?@;TGgFHG#d9t7QH-!}+n z-R`y;ebE6((Rl3D-u$C4uLu8G50bgJm9pFXv?IlY@H?ASH8lQvbEaWKwpffu_d9)) z{M5K*U)6iFsXGGKDTsQ@t><4G$M_YG&aM|x!ejf0roJnb@jROu1_jT3hBax3mI+}I zS1{u}C7-I-d!x?tZr|3J6Nd#ygP1M$pYH=3L`D&zE?9&=^1U%(K`Nq-9%dNsk2|tu zzi^fDbd%6{)7z37mR({l7M0-I$D&-pl{qtXN9ZR)x#`C{`ei@X6149o_v!oWz8?NO z&8J4E@wC{dA66Ukn&qbeT)XX6&cq%++k2YNGydy#XRy3Ft;vwK7Y%nsroO=~amR1P zJ$&=#S&PFR=&q$2K3HI+4{1|gmNzozK-+4 z0kz<(y52l*dp(%Ixp!5f$%0b+gs$n-1cW@Hshv6F*r8!Cyb><+ExyZrQtx`zk2Gpv z>1WK@mFrG85#Q7!dGA+g1v6bajtO1%Fg@F9=evL@>Z!x7>if5}+;kM>t{K}%R{4xW zJrdFKQ&YRDLqSrrS-5dXq~G46kuzbvS#)FOAz!Cec-)LCEB#yX_v$(U$Ov| z5OQZvGj@V@R#HHqHfGJ_^srAda&kheo--x$S)*yeyrTD~18Z=vAFy#IQz>tuZtZX; z6&^nx7}wy3duKTeZV~wqC8u!tbXUi8Or1;iOAvD?6-S~00djwW4&|Xt zZn}ZEW$=@+`!+heT{rOrPm!=e%My)trqTLvaDy;vQgSULpo+ zUOC_J0=0&FBaT}m$5>TCYhe7JPM>dT6$MIu@tc4K#0KO%V8~^;F=Vmf1t9X?*&z$> zzWRN+a&Dzc>NNMHig??#=V71DQ@a5#y&-s|K9x{xK|s!_bbV+^mcXpl$KbG1Nf+S) z@m7zrgHfB%cIM(i%exDoOQ*&)L|f4Wev|E~FvO3pq4FRJ!lyruvr@T4oasfK7ENf9 z+wm@24l46Cbh@va@D+~@diIxT8&#urQd#7e6=lT}IRN-S>Fc3VaeE?_i>!yK>(2g~ z_CjXBfP+!}WeZ&O9>*eHdHu($Z!qy&Sbb*Mj*$hiSm>S_#LMXelK-OffZ5dIbSkcR zP*9@EMx)ux7Ia6P=bq~8X_ma!rzl*xpCQcrT;-;N+NtdbpGZDX)=!|uIi5_r;Bu0m zs-ul3Pgur#OMa~mvT>TX$g_LlI~YVwDY8l4nF=NYOQo6?2lui0L>w&G!Xu$uKh+ zzZ*hMbb+z<18R!)%bVS8H>j!QLk@l1-SD{K%?yM499W*CJzTSbuA12S0;cj-`Ah4q3r)Xw9RPH-M&ykZPrz(VG>s_;}gb9~3w%mGs zGhFTC0?W4QPiK%B-~}TJHt=rIPc&xU#y)@%@%D=Tb`UuHL`lP|vfW2FA}HJLK+mP> zSwHQED^p)S^PEW<$3JrlUu)ZeQF!Up1g4PPEkM_WoX6cIO!=fuL6-yxI)p8e~EMd}h%G-}fA4fIupnk+nvZJ$=GPbOCK(XI6LGd!GU zWi$e43(z1?Zl%J6LA#!eE7i4U>pUu?<8`B%;wvr*2)&iQ)yA3r4LFxvbW`6)1YnR|f^ zo%(EuW}^R9y(ogcPwJkxB&k(yt^P)cb443+{Wfq|1oa4X%(ZVFbpLMjkpAD6AqQlG zv_?qQPouptgD#$N!oqK|rbLC*gY7YOiNWR1hDt)WJc zW~eAN*ocvXO(iBHCL=}--b=mj=Xs9z-}m?(@83JOo!9j}@2*U<$Q`kb1Hdt5^OX~Y`xE_8z5j;q zd^iE6U%2t(-VL6|`}S^~z_l-;!l+Neu?icsoddrudRT6VjnEEdRwG(+K-wc0heL7J zT^TEou4A6!Grer9GwV`_F6p^3Ar5PgLYJ+(A*~R;`C$eRlKDlYF{4e_k*`6QE-)(L zpenM(*Stk~orPd@BO9+6+g=#OilxI(F)t>CJJV&O@!)7z< zrz9#XRoz#UdusXWla9Sv77nh1+lSsh$b?oGwIwmeF_02Z`I+(N<&+4flj%ozbeSJ5 z9Hm%$@F5wB+cnDcV+oX%XTG&flG8v-nEZxg6?#lRMpu zI^fwDeCLHu8aH$fx92%)C^$8OwcGcmb!C$`b6Z;bz{bPk^Tid+2;+dWabvS0m#Xjk zN4IF;J@*!qvS7o3w1!b3Ifb%u`P?pEiEN_SP_=tkbimY$OaIJ!;)RTYZBmQd?Y+BO z7{Gx8EiD-J9=UNmgHtV#y0Z@1PNO>w6d5@uTcq+xhE}O@R?VH z1kSg@WsONf$P0aGU4)X?&rC{p_vNepB;Np45)k{6Lh8%qh4 zmlyJ1FV&4IiatTGB$+lI2x|b6_eDizv8wjqc1JE-jJbOLM*_Cy=@-kldqrnH$~iC_ zBEZ_T(UqVyof+JQ;=cFNtXh4@s*q!Z|N001`9L^~vc19RiE60I_CPrjNg)s+}JF2w_@Jn^y0?3@_4}lE~%fNoIsSwF^f8~Ar&lQ zPAGBQ>0@@4=^TRhi-6t?<`=AjZr3gX-9JC`1Bo*_1;o2H;J5UQ(8F)!Pk`IeMR~f4 zk~vo^7nr&jzsi=a+g`l?**iMF_RdW}Tlbgqj#l4^O7XS2-tp zm8!H)g0lR3 zWLk+C#*GxbwaIl+JT{CKQ^(3YSRGb{oSol{G$fkdPc0>I6D3vl0n{+pvk`fKKR0}f zvaksaf#Jlv9W+cx5xeK-cb#cDoch~2Xx_7D>}T2kV#9SmLF}X}WvGbZj64c%Ax{~)9Yu)tT^&N zTJJlT&KNPpEtTFx7%gy>7EG$ara$C$F&%2AKeVv*mU;<{x`|z_2L)XVeJLt;xj#Y$?c80jIcZ&Vtx0ocx9w#4{9m$=7i z;3huejl34_hN@@7pCy@ri{O`J4r@l}=YbykQa|1p`u*aw?rH zpB*dQ`MET>$9$l2!5&C5Qw3<3|75^cDkCmnRIV%J{G(- z?3bup)Y4mM&goy#m|Suuj@heJAuU+EaKpypLeQDtvsS2+QJBb3j8CI{IvAw%y0SE> zoj79PNZRgy+fa9%oQ1_=(*|Srpf`t8*}Bq%X+bK!s*f?oJq)klo(Ze(cH(}RyM;8B z*={?5=k;Z2(y^Yq6caWiosrzU^*!y8MX=Qwub`YI?5CPNsN-$JI90JgV%`|>afjk=(u9cGLp8?Bk6 z?Tp#&oUQLGUGlItwE-~#?zY4BQ00;PGkP+Wc@9suiHYa_KO{XRN=L<8#Z zh(#qz*4)3twd=$ABta1g?a+WFiD@OBL(}cC)df0?(;RXWIkX(1*q4W9?`D(L^+E#| zJn8X#+1FZILKgI020oDJ_B5~V5O~Y!5Swt`cNS-eZ?A5oS?@~^&h2uI%M}z?VA+vv zLdHm@8`fCKS9SH-E83J@=xKI=X)>R{A=pN$<22?)#(Bp^Z&_jOZI`%UD!IJ=w7tcH zRpp!5*JYTZmaG$=y_H=QC93=KH4Zd$(lfgJ-2sd0B~M~+7A^JaP_QzkPrj{?Iw);$ zrxDNiF1R(w#U5Jg_lm+67D#*I(@Lmu51>h?aDk$AUI1}mAVzo+l<(ZEt{V7eEy85B zZ}O@(!&d&rk@6(clz9E=aiLcCr34WmZ8iUle(sVJc%uO{xHAPBbjsc*{asG~oTnA? z;3p8`9?=L1dfKB|W*S7?EiHzm(2Oi*TZ-u>Q$kC_;m4%JUT3mI!XgBs?0Rw0BXr9!m#PC+Yr8X>%#w8t9U zU4E#}VBdRqZ^3<0hGJybg2vI_d4J37{>FZ>wV0L|zwOv08Cc0zZW_2gS(u^=KG%AZHf<;uRT*2 zQ8DR`3mM<@4$ZGrr!Zm87#KCjrnQd|LfBpE26a9h)?luM6lbrKOS-(ygWZQWkUrTk z{mOc)@l_o8d6w)rj*K|J4VwZpnJ;i9f3T5pB8G9-2PRtL=;pLN0NZporvO-`19txO zypPMc6I8zK{86>e**C}=E||{G$};lWIau3EO^~P)CxIR@9|Fak7|1eF--vR_eakxa zQ3!_H_YkUSnyzPMGB4lU#Vz9MvBoVO;y$_h&9%bx0AVu_2U@RLGsRz!mBp1Mn2Gmi z)VA}&Tqiy`?Ux=|Ei|c5sLs>kTX-wv>$vZa@j-=EUz>=aSR-PNYU#a)ME6Sh;vS_) z@dQn)~CvYcx7E6&Ua^^}yXh@Vp`iq=RY&{{+Rp}Mq4m9`7H<~f zyFWZ37BbvCABb84_z1{`z3eCq@01V-1u{6mOJgr&6?PeN-U_>KFH)x;GfpZf)P9%L zM7d|B)AZ)rZX3O7;zv$Z7N54^)kyk~OmWyYbG-5hS zAa+(mrVF2U5_H$5UZJ#a%!Q4Si|QB2MXza&J^1sRJMNfffstDaVX{s|41DTsx89Du zaG52NQwn8H=l97JCk!lr1V#BA@V@ED;G1^3VBuk`37vnxi*bzA`0qW4|CMUC=Yw_Q zgCb>;g@9!e$2Y2d+( zm*8rCl0wn7YL^5^e%l2k+3Co0u61`x+Fi)GOJ)w);zZ>3emDE@Q6Cwg1*h=I$uK-O zSAXcNf&va+(X*U-by~AKtzFM&`|cZ*S^lA=h8kt5p6@Zd;Ez49I5Al0qqP?4pQGqx zJ%KuXnm4WrU(i2z=NWBpPlywh$=U3Z2ob=6<$@Yo_j9!#Y2JGyS*b1}VxPjM<8G3^ z!07TfY1^KV>L83=bw=D--KN&p-|*=>O?Y1+h@-QX0|A&xzwcotM{&~hu(P-x+}UB} z^>A_?J>Cowx`eDTN2ghpWl3w-K6-#*t8$wg<{2u~sn^>x3SJn=q#>L=1owP8N~0v8 zB(+$r(oJ$Nqi@&yxLs>FpobuR zY;x~gR*$6=*|>MdafNH_9=t2=skQFhzfkIPGF2!pvtsJ!KUA$gP_ z0~7VK7gsqXUtk@q5FP5)9e{t8C^HNI$)U@JPuXp>A3*ORSPwX zkWf=kzV>CE-L2-fa$DlqabpWky=^}vaAoN7Ug4GH>k;mup}PGK2IX9~c}+4pOZ3Jt zsx<6sALe+%g7ipNNOQOIqI~fKkH?lG$J|P*BN-=wrVH(d$=at}>y^qkA}x@8ph|Xd zE;EmH0IKhX`~v&p*4_(1+;62du_Ilt*cG-p?)hHtUHe%gYs3Pr{2|Ag-}4|OZ@@5a zfeI_p*m1i;kS4PSBFHb9J{<~&dK>VmCM{fH6NTJ3hR8~={N3mMs~=Zd`sB3*Nx{-7 zl%GIRG0Ciy*>TU?N4{Bw(|kfSTpTCAqyXBsq`9X0|9+ZU+0NjqbbLy#dX) z^{02oj+#`UWP2(y$+8Zif!M^YXNt#_TOIu!*AAa>>j_;8v&-@cOV%h?V6}T4_=VSx0-0xUkt7s zoe85TFE*#qp^pLTmpMk=jtOFy4ynVvf3`1tXqW-78}GUfWF88ru^A=KOC%|!{oePc zVSu5fpgi#rOnhnC)Gh0#7FCf?1K-c+i&14^_$b}c6klwHV)^Ut6(t*2hCIi=o~ zfrhV{@RS_n3&+&2h3ucQSvn#2;7~oGXK|pWUPaT_14C)isk>&CS&tl}ha%S0J=0O= zTj6Ify`EQU?|m~rE+UY!p@1*%>CTXbd1VTnw2Go1ah(;{B|tu!;wQDGHG#N&0~NTN z;xA)sw#x-7Rh!mZweXpD0hNx@+-G;IH-xE}ASA-i6|Pu{%I(R>C4as!_Ew%BMhijr z>V`jGObyWiVcl^&Nx5i^Z51D$w|i>7X{Y-b7-m70Axj~>eQ;{10#TvN4vW*l*+s8C z_DeMok~ij`wt$~qV|acR$44U%Jdz)Z*OSlugghSGdaCj8uwGpFWURVkfX zN$Dbp%4OEvQIxy=`xaCZG-OGxUYiTG#Pn%Smu>`rLi&m_+zS;QZw#Lk5|7V&MW_k2WcJuKd+BTPDQtxvSq}Z zzM@hKHXi7P3cT=3-xJ4YN)N#;uTZrAG2lm}0pCjA;H*F)9?Kz{fe})NmyXQo0d_n_ zE*t^1hi#WxI2@mOB$iTR-VZU&r(*p;vyG%0SAPRMop0x)OjC{>$s6~6m{ne1ea#+`Pz$nn&Y`u zk40bp_CoP2JcnROTj%O5rQOJ)>B*OF^xB|Q`(APVaxvuwTq?T5m2gJJ{0u*pI`gv* zfGN~FVkV*D8`i_8gsQ>WSS(Qr*2BDcbBj07$S;nNI)|mEc=F$L^=>>VGrU55A(k7c zzfmH0=1pnRpf`20XUYF-t#KuI){Ef)38=V*>6Lix&tu`UW$5p?EEawTUPR3u%2J=x zsPi$lSr;Wi8yG9K?YP0Quf=uBfD?llWbd&6L{hGd3P9_^LPA?lluaW!DY5kiIUcmq z;@GUZ!C5M_DQ8<*np0QjkJEzs!&5>C;`GB^Jq)LZs7;tZRev^bblBRhgvxQ&c0dDA z3rR?YgrE_|5EJqSU)!v)Q4d2ev35f`#=SW5CL+3?qj~N0AEa`pw=@SjX1Y=5AZ$}P zT&DtHo5Zr4MIB$J>-r9QKbT!ZLN$u;QTlaEBlvRyEl=@O_QHCw@JMn$*(BVt+Z$SW z!4XnOO<>%wL-NQvq!e}*!K9YiSM=bt^>oSY{RuU`G{w~Si2ZU)nFD>626|#oI7=cg zUGML@S~z2RFztp!t=1)URw9vq$<7NnU9rTMUFRR6Y{||-Sx_mwnr2Xtdy>%u+e&XL z?qE{`0k`r(XD^Dcg#5o5Jr@CyC!r?=?WfE!?c~W^D$>WX_uDky}5JBkeCpy3wVN3rIO*(nJN%e%FP*N&|}@A#P8 zvRmwJN6qk|B(@BD!zzf19#lEXnHksRR&Q&8s)+Oj7nd+uU5~y%pPt_GvKhh(GR(?6 z?M~sQI+Zfg+Oo#t5*6ewq-Och+k?Ag2HP^i^aemfPZ@V^y7?<^j2}pON-po&eEV|1 zORuQHt$^llNm2!Oy|NU3@g!d7PP9+!an>OD%OS({0ghi9B(Z8u2GF&N@@}cwq!8uLbZ0#4S7}(p3Vq}VWhIjC5s*VeYz!TlAVPLUTRKG=_$HK_72Ol zJWq4++bDWfGKQEmUEfn+%Y-ERSRtfu&M&-5ZHTZGFYGwNnF^ zbG<^K@0PYSAgKk91xmkXr1&W~4pT;CJk@j_j1Aj_a}1}Rur%?-ZMv=_x4C9J0+!-m zKI*5SJUxu-g%D8gEw;rT?6zEM=<)kPu5@ELg`FT;)cWhH~rD50PK6-RL zPz-hJivHT3fJmup%5@+Ii0LsEETFpoW5sBGs5{Rf(vaWowJVq;yfuw*2=A;eyO2ka zHamDf@y2M*n8%AbqKTou&D0q(4dn3p_A0h1oX=0v&V;XL*Moq_pN(8|IMsU;n*FMm zkT)$XHH2T>X+7e6*rN6G!jeOF*?SoUEiX7RgR}k8xNp@&Ny)7+tvN;{W7~RTPqcf~ zTOXzP%sKGqEuc}lb*MKvv#KFfQ~yTa=9is73km%m1Anz)4go(63qhEJQ0sPU44B~9 zhl@Jlss4i@j2rhwB)3sB&3TQnV^N}Fqv7n0JGdO8YZyP!lc~N660#FBAInB0a&TD3 zct6JYcq-!q9mw}Q1p9c>lIt_FR-v*LRJ*v2p>uHpxv&zk7iu65e;>9&uGIof9G0deHvun5luA=pC6O5uBPXZGXNscR$XaD>oJ4mnPaejri=NNXXX6poB^Q+0SXmA5 zGqR=UIg@IdFhU)1Hz}&lg1G0$lWr(&tk>v=POVRD;J6|>27yBWLzh5PxvVC%*=1R(V;tyt2uYUYfT9!(s zSj7hCp1Oh5Zvq^d>(^ShGm3Nb;!j*N!5CcJb&7HR@pPsqd`BWoS3O}jrzm>-)OWwz z9Tl(8E>hP}-y$XJeqcxPGu>?V`roy#=bHDo>54dXeit#GdvEvto33&(#}v6nPQl9o zWw>^W>p6^m>w#ouN2QtO&YB)KL|5?0=3lLoB$gDsW!Ly;URce$5!2@cu8Gj_^}e4oWD2rxacSsF;B+C zcRnCu7aHZ0q~sQ}@{mKD$ZHpD(LwmOU1nYUgLuDp37Y=9@r$N>Iw$Cp(o_V!v#56g zzQ{K|yK{6^qGY=m?TtqW zRYgRyCaR{*1WfLVlVn#0MnMu_XFIetVIf0p z#1JfL6i!;=%=j8~Ozmj)!m9*jKC1tWVkkk@`&Ck-<4^X!I%dtL?7Wml+^qK^5iri0 z&0cS9X*DG3k+)?x?&-O0Gj-q{6mNB0A9SJ5o)l3tz!)labB_EYV3t~pq6KTJbX zAuf1#CqguKt3=an_*vV8$Q{aRX8+P^XW0<6(uxDiHj{B)Y=>IPW1iP?yDk@Wdmax z_#W>8&jl`V^;0?b%+uSI;~RHGsk?d(TB_@a}r>cIYAWZuYf(2AN-9*?R=6 zDxNoYx4tT(>Z0R}yX55xw(V?LG=|(#9FhJ0XZCd*N#?RFj3)z73D#`#-;coiC5E6g z8)3)ij2q6+x(DvvyHmv5DB@F+ZsqUMd-=kg;qwsg&jQ?hY;br>AgqP96HzXz?GfJ; z;;cwEVsjY)J-g$O?{687=N+5Q#zC~m)dd}rE$>T*xMS|`I4{I^e5n1nK2E4)xQ?f? zdcX5lPp%s4xz3#7+?h$*nlF3#Ec`-jMBDvd4OrYrQAbr-UrNDlL(0H!3;^XwQOE6X z_rP<)WeNA$yLt#wSDxtJVh%;G@un%ydpZ0>-d9$M8fx0 z{UMdUta8*hgr#`7lDtLtT=u#QhnJ$lMW>)b#mxHpbM|6glO0LXvJaiyS$XE#ooHz; z_L?glJb3H;PDl=5?UFRRh#^yMLQlul+Q}lH%WiqRatU8RfN@+bGP9Ehl5g&sI9D|ntbn<{JA4;6g+K%|^CeAmya!AaQHqN( z=N+~2$1FR$3PwrbEIxPZIcN~(X|zkT%Al{04p{pO+|^36T(rc1$s%fm9{slRRW1GR zY^7|&xL~(@i~UCuzi$n|Y1Z)YN8e#hA?5@rQo6Hx|64=hmY=_`=uYwYt5r2$`h2pt ze7Jftt7h)v%O-BrDq;e}&rp})x}8(a7w7tbOK1B{uvu~5P?(JKcOQcTQ86}|=~>%q zK`%olW%uAE)86|U0qF}ocv>$Kcb+GSZ;i(K>z}h&fFp=4-WwW=>neAzF1%pD{QPR- z8uK$dEus0>fWQ6%{Z(}I!|j=&rd~F>oLsuB$@{K33G-D5+aJ!wj{`Cae+K^bR^%T5 zA)u_}9R3fABJ>|f9x&>M-v5Weo99uZvoi*tD1ZL$TqMfRtc0&;A}Vj@sQh5C*fo@) z$tUW{0*nqDX7tQx|nrz_h!rW2ErRzEnHhU$urXsZ#NZod@5!R-m3 zg1!K2!zPAYVHj@g-t%clM%sR#-|vU}o9`4r!TU6^WH#SypEw)mkaC^3XGGt|pZSOb zwkBJ(i|9OsY)npSTqx@Tfh+OShZ}K{_UcOY)^aoz^ zm(=NWPPRw~WOGKU*Q^84m1zeJ(OXCKj0Nbq(QVdMrJ=N_=@T(!dc2hy$=N?QpT3%v zmrIoHu~<*hSFCrHN=v}>KJD$j?CN#56=R>E;I7Es^7?_W0Lt@-81AxQ8m_CqoNYw# z(I??f`DZPskIdE_n!mf15=nKA(25=mL1su{={Wez!$LuACP%k%YJqZjJZf}07N_eQ zXq>LdCK9+ml$c3miC4;k#3RtFOMXN9T+|jUHM9aAB@{Bh%{Fa%c{SAamBHpx`WlP% zthedh!^U$R@~P=?py*J_cb$hB ztDLm<#MiEiu3N#dUMHb*srzM#;I!8{Jp|Je77`Yiaj$IY0e{dQN%8SKD4a}!1sTL3`*8->3GdmYM z*PMh_2i!ltOt%Ujkv&P3U$Kf|Oe`6`?)TIdluN-36CUyuFMr4EKl~*BljdLrVkka^lCj69t0?0Wl z2K5cBnQVLCV%ulTsU?#&AP#t-LBfl8;^DSo^pUi%VmTWQj(B;%mb$1bbLC=3*G~X& z@;Pi_zzDk2)&CB2yFf4{a?e%M$D_gW@KH_FNaYkd?r=umGr&?%{7Z^>>2y=M+mRQT zXvfxEmgE4Nk;rPYn@4RdIM~l5i>+!S0F6gf#hG}#YxLTzO$3p_R{XrtC85S{sof zI$4Y52D7%d(f0g2$piIA*@r%s&-lV_95yjMfq;h!e|be}&wG!`O(N&+wOEi3o18YI z^pc80n`H%6oJ#fl1hyAORJ?BeQ4;m}k14kRnf%&71?m=1zW^xxF!{`F^H_2jlM zpKPUH;en|dl`UsKPi($^b@isE(d4I9u6b@?JMGyFQxMIuxsdAGaudYOJNl&?V*{&+ zrwdP2H?YR(&3fGNKO31oe@Ozp{8O0a$`IslqG#r8+N~#Ef3M@GZd@9vf26M} zNr};y|1#fiJY^y~(V{in^7q30N&&i|=KYM&D_R>;3HapM)zvkVSdS{YCSMWv@~xq` z6AP-I!PM|BK%O{HBDa&QB z&hWAWX5~k?a;V!!{mnNLhuy#eO&G-sYhZbFFtb%#72r2U1&WmxsJ-g;tv%aqjpTfy zGLt5o>7ckcb-og2J+}^aA*3VwlPz;%TFN>0YHswy9A za#c$fj{>Es??$`qfNSPl?n3Fy1iOK6bF()()U$;Z>|cNRxsl;KUNY17-e^Zo2)Q#H zJ4JDqE5va$)o>*LHcbD11CUNnb#y&tSTb1y+Tf|bh;mdbJ8LmLyo*2m60BFm3 zFlnm8|0ISx*cyIN*yq>@362OC)i0>hhSAxQ_7;`ZZO(^kN8MgEr~lT${`v_(&;BS= zfVTDD&YNq3f6PPR&G#q$mk)39-?oo+RH+MaF2q;$0Jox! zy}c*9}D+5gP@@7TzVqqRD|ysGkGZO`CfX&J@4RsVeETeV4id~kwGSvnhq$}OB? zZ|%KB{tvsI?aOD$C{i!|#D{n{CNw~cRAXx)qae*jB%Ph9{2 literal 0 HcmV?d00001 diff --git a/book/workflows/merge_request.md b/book/workflows/merge_request.md index 25cc607..e373da8 100644 --- a/book/workflows/merge_request.md +++ b/book/workflows/merge_request.md @@ -1,4 +1,4 @@ -# Reviewing and combine versions (merge / pull request, merging) +# Reviewing and combine versions (merge/pull request, merging) Merging a branch into the main branch is also good moment to let a team-member review the content. By assigning a colleague to review your branch you can check the quality of your new content. @@ -18,7 +18,7 @@ We're finished with our chapter, and now it's time to include all of our commits 3. You can now choose a source branch and a target branch. Since we want to merge our changes from `chapter-2` *into* `main`, `chapter-2` is the source branch and `main` is the target branch ({numref}`gitlab-merge-request`) . Once you've selected the correct branches, click "Compare branches and continue". ```{figure} ../images/gitlab-merge-request.png -:name: gitlab-merge-request +name: gitlab-merge-request Creating a new merge request to merge `chapter-2` into `main`. ``` @@ -26,22 +26,22 @@ Creating a new merge request to merge `chapter-2` into `main`. 4. On the next page, you can give your merge request a name, and provide a description of your changes ({numref}`gitlab-merge-request-description`). If somebody has to review your changes, you can add them in the "Reviewer menu". They will then be notified via email that they need to review your work. Finally, watch out for the option "Delete source branch when merge request is accepted". If you want to keep working on the same branch, even after your previous work has been merged, make sure you untick the box! Once everything is filled in, click "Create merge request". ```{figure} ../images/gitlab-merge-request-description.png -:name: gitlab-merge-request-description +name: gitlab-merge-request-description Example of a filled-in merge request. ``` 5. After clicking `create merge request` you should land on the following page. Here, you can track the merge request. Right after your request, GitLab will do some checks to see if you've tried to merge conflicting files. As you can see in the figure below the merge is blocked due to the conflicts. Click on 'Resolve conflicts`. -```{figure} ../figures/Merge_Request_GitLab.PNG -:name: gitlab-merge-request-conflict +```{figure} figures/Merge_Request_GitLab.PNG +name: gitlab-merge-request-conflict Example of a blocked merge. ``` -Clicking on 'Resolve conflicts`, will open the conflicted files in the text editor. There you can manually edit the files to the version you would like to retain. By clicking on `use ours` or `use theirs` you can select which version you would like to keep. +Clicking on `Resolve conflicts`, will open the conflicted files in the text editor. There you can manually edit the files to the version you would like to retain. Alternatively, by clicking on `use ours` or `use theirs` you can select which version you would like to keep. -```{figure} ../figures/Solve_Conflict.PNG -:name: gitlab-conflict +```{figure} figures/Solve_Conflict.PNG +name: gitlab-conflict Solving the conflict. ``` @@ -51,8 +51,8 @@ In case you have cloned the repositery you can also resolve the conflicts locall 6. On the page of our merge request ({numref}`gitlab-finished-merge-request`), we're greeted with some more information. On top, you can read the description we just provided when creating the merge request. We can also see an "Approve" button, which you may or may not see, depending on your repository rights. Next, we can see a green checkmark, with a "Merge" button. This is good news: our changes do not conflict with existing files on the `main` branch, and we can merge our changes directly by clicking the button (if applicable: only after somebody else approved the request). -```{figure} ../../images/gitlab-finished-merge-request.png -:name: gitlab-finished-merge-request +```{figure} ../images/gitlab-finished-merge-request.png +name: gitlab-finished-merge-request The finished merge request. ``` From d677a5a7182c945bc9851cdb1ffdf7ac141a00ba Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Tue, 5 Nov 2024 20:12:13 +0100 Subject: [PATCH 13/21] set1 --- book/_toc.yml | 28 +++++++++---------- book/basic-features/equations.md | 4 +-- .../jupyter-book-setup.md | 2 +- book/workflows/branches.md | 16 +++++++---- book/workflows/merge_request.md | 6 ++-- book/workflows/new_branch_github.md | 4 +-- 6 files changed, 31 insertions(+), 29 deletions(-) diff --git a/book/_toc.yml b/book/_toc.yml index e875ba8..85cba5c 100644 --- a/book/_toc.yml +++ b/book/_toc.yml @@ -4,23 +4,23 @@ root: intro parts: - caption: Getting started! chapters: - - file: installation-and-setup/user_types - - file: installation-and-setup/git - - file: installation-and-setup/overview + - file: installation-and-setup/user_types.md + - file: installation-and-setup/git.md + - file: installation-and-setup/overview.md sections: - - file: installation-and-setup/vscode-setup - - file: installation-and-setup/git-setup_local - - file: installation-and-setup/anaconda + - file: installation-and-setup/vscode-setup.md + - file: installation-and-setup/git-setup_local.md + - file: installation-and-setup/anaconda.md - file: installation-and-setup/git_bash_conda_vs-code.md - - file: installation-and-setup/jupyter-book-setup + - file: installation-and-setup/jupyter-book-setup.md - file: external/template/README.md - - file: workflows/collaboration + - file: workflows/collaboration.md sections: - - file: workflows/milestones_issues - - file: workflows/branches - - file: workflows/edit_book - - file: workflows/check_changes_online - - file: workflows/merge_request + - file: workflows/milestones_issues.md + - file: workflows/branches.md + - file: workflows/edit_book.md + - file: workflows/check_changes_online.md + - file: workflows/merge_request.md - file: installation-and-setup/collab - file: installation-and-setup/tools - file: installation-and-setup/creating_content.md @@ -39,7 +39,7 @@ parts: title: Banner or Announcement - file: basic-features/hypothesis.md - file: basic-features/utterances.md - - file: features/overview + - file: features/overview.md sections: - file: external/TeachBooks/README.md - file: external/deploy-book-workflow/README.md diff --git a/book/basic-features/equations.md b/book/basic-features/equations.md index e1684bd..4f6d293 100644 --- a/book/basic-features/equations.md +++ b/book/basic-features/equations.md @@ -37,9 +37,9 @@ Resulting in: $$ F = m \cdot a -$$ (newtons_second_law_2) +$$ (show_newtons_second_law) -Equation {eq}`newtons_second_law_2` can now be referred to. +Equation {eq}`show_newtons_second_law` can now be referred to. > **Note** > diff --git a/book/installation-and-setup/jupyter-book-setup.md b/book/installation-and-setup/jupyter-book-setup.md index 9c9c2d2..a916543 100644 --- a/book/installation-and-setup/jupyter-book-setup.md +++ b/book/installation-and-setup/jupyter-book-setup.md @@ -32,7 +32,7 @@ Note: use `--all` for the jupyter-book whenever building a book to make sure the Once the build process is completed successfully, you will see the file location in your terminal output. Your terminal will look something like this. Simply open this in the browser (you may have to copy/paste). -```{figure} ./figures/Terminal.PNG +```{figure} figures/Terminal.PNG --- width: 80% name: terminal diff --git a/book/workflows/branches.md b/book/workflows/branches.md index 11acdf2..4be0eaf 100644 --- a/book/workflows/branches.md +++ b/book/workflows/branches.md @@ -211,8 +211,8 @@ The branch selection menu, where our new branch has shown up. From this menu you Since you are working in a repository with multiple colleagues, it is good practice to make sure your local repository is up to date. This is especially important when you want to work in an existing branch. In that case you want to make sure that the existing branch shows in your local repository. Therefore, you first need to pull all the changes from the remote repository to your local repository. Simply click the Icon with the two arrows. -```{figure} ../figures/Pull_VS.PNG -:name: Pull_VS +```{figure} figures/Pull_VS.PNG +name: Pull_VS Location of the branch menu. ``` @@ -226,17 +226,21 @@ The next step is to *check out* our new branch in GitHub Desktop. *Checking out* In GitHub Desktop, the top bar has a menu called `Current Branch`. By clicking on it you can see all the branches you created on the remote repository. -```{figure} ../figures/CheckOutBranch_GitHubDesktop.PNG +```{figure} figures/CheckOutBranch_GitHubDesktop.PNG + +Branches overview ``` 2. Check out the branch by simply clicking on it. The following window will pop up. -```{figure} ../figures/CheckOutBranch_GitHubDesktop2.PNG +```{figure} figures/CheckOutBranch_GitHubDesktop2.PNG + +Leave changes ``` Leave your changes (stashed) on your working branch, in this case I was working in the branch called `collaboration git`. 3. Check that the branch is indeed checked out by looking at the branch menu at the the top left again; the current branch should say the name. -4. Update your repository** +4. Update your repository Since you are working in a repository with multiple colleagues, it is good practice to make sure your local repository is up to date. This is especially important when you want to work in an existing branch. In that case you want to make sure that the existing branch shows in your local repository. Therefore, you first need to pull all the changes from the remote repository to your local repository. @@ -249,7 +253,7 @@ This synchronizes the remote repository with your local repository on your compu `````` ``````` -**Now that you have created and checked out your new branch, you can start {ref}`making and committing changes `.** +**Now that you have created and checked out your new branch, you can start [making and committing changes](edit_book.md).** ```````` ````````` diff --git a/book/workflows/merge_request.md b/book/workflows/merge_request.md index e373da8..b83ce4c 100644 --- a/book/workflows/merge_request.md +++ b/book/workflows/merge_request.md @@ -15,7 +15,7 @@ We're finished with our chapter, and now it's time to include all of our commits 2. Go the repository overview on GitLab. In the left menu bar, go to "Merge requests". On the Merge requests page, click "New merge request". -3. You can now choose a source branch and a target branch. Since we want to merge our changes from `chapter-2` *into* `main`, `chapter-2` is the source branch and `main` is the target branch ({numref}`gitlab-merge-request`) . Once you've selected the correct branches, click "Compare branches and continue". +3. You can now choose a source branch and a target branch. Since we want to merge our changes from `chapter-2` *into* `main`, `chapter-2` is the source branch and `main` is the target branch. Once you've selected the correct branches, click "Compare branches and continue". ```{figure} ../images/gitlab-merge-request.png name: gitlab-merge-request @@ -23,7 +23,7 @@ name: gitlab-merge-request Creating a new merge request to merge `chapter-2` into `main`. ``` -4. On the next page, you can give your merge request a name, and provide a description of your changes ({numref}`gitlab-merge-request-description`). If somebody has to review your changes, you can add them in the "Reviewer menu". They will then be notified via email that they need to review your work. Finally, watch out for the option "Delete source branch when merge request is accepted". If you want to keep working on the same branch, even after your previous work has been merged, make sure you untick the box! Once everything is filled in, click "Create merge request". +4. On the next page, you can give your merge request a name, and provide a description of your changes. If somebody has to review your changes, you can add them in the "Reviewer menu". They will then be notified via email that they need to review your work. Finally, watch out for the option "Delete source branch when merge request is accepted". If you want to keep working on the same branch, even after your previous work has been merged, make sure you untick the box! Once everything is filled in, click "Create merge request". ```{figure} ../images/gitlab-merge-request-description.png name: gitlab-merge-request-description @@ -49,7 +49,7 @@ Once you are done, click on `Commit to source branch`. Do this for all conflicte In case you have cloned the repositery you can also resolve the conflicts locally using VS Code for example. You can read more about for [GitHub Dekstop](edit_book.md#... GitHub Desktop) or [VS Code](edit_book.md#... VS Code) -6. On the page of our merge request ({numref}`gitlab-finished-merge-request`), we're greeted with some more information. On top, you can read the description we just provided when creating the merge request. We can also see an "Approve" button, which you may or may not see, depending on your repository rights. Next, we can see a green checkmark, with a "Merge" button. This is good news: our changes do not conflict with existing files on the `main` branch, and we can merge our changes directly by clicking the button (if applicable: only after somebody else approved the request). +6. On the page of our merge request, we're greeted with some more information. On top, you can read the description we just provided when creating the merge request. We can also see an "Approve" button, which you may or may not see, depending on your repository rights. Next, we can see a green checkmark, with a "Merge" button. This is good news: our changes do not conflict with existing files on the `main` branch, and we can merge our changes directly by clicking the button (if applicable: only after somebody else approved the request). ```{figure} ../images/gitlab-finished-merge-request.png name: gitlab-finished-merge-request diff --git a/book/workflows/new_branch_github.md b/book/workflows/new_branch_github.md index 1aef3ca..71de101 100644 --- a/book/workflows/new_branch_github.md +++ b/book/workflows/new_branch_github.md @@ -1,9 +1,7 @@ How to branch is demonstrated in the figure below, all steps are elaborated on in the following step-by-step tutorial. ```{figure} figures/branching-github-ezgif.com-optimize.gif ---- -name: branching_demo ---- + Demonstration, video available [here](https://youtu.be/3ceMSLQpD70) ``` From c8720288681a9c9067d8dea11401d92971f4bf55 Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Tue, 5 Nov 2024 20:31:34 +0100 Subject: [PATCH 14/21] set2 --- book/basic-features/jupyterbook.md | 6 +++--- book/examples/book_structure.md | 2 +- book/examples/overview.md | 2 +- book/features/overview.md | 2 +- book/installation-and-setup/git-setup_local.md | 4 ++-- book/installation-and-setup/jupyter-book-setup.md | 2 +- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/book/basic-features/jupyterbook.md b/book/basic-features/jupyterbook.md index cb04343..6737a17 100644 --- a/book/basic-features/jupyterbook.md +++ b/book/basic-features/jupyterbook.md @@ -9,7 +9,7 @@ To build a Jupyter Book, you need three things: ## The configuration file The configuration file of Jupyter Books is named `_config.yml`. It mainly contains settings that apply when building the book. Here is a basic example of a configuration file, taken from this book: -```yml +```yaml title: Jupyter Book Manual author: Interactive Textbooks CiTG logo: images/TUDelft_logo_rgb.png @@ -43,7 +43,7 @@ The configuration and table of contents files are in YAML format (short for YAML The table of contents (`_toc.yml`) file is where you define the structure of your book. You can organize content in *parts*, *chapters*, and *sections* (and subsections, each new section creating a dropdown menu in the ToC). This is what a table of contents could look like: -```yml +```yaml - format: jb-book - root: intro @@ -61,7 +61,7 @@ et cetera... `root` is the landing page of your book. It will be the first page that people see when they visit the book. You can include files by providing their *relative* path (so the location with respect to `_toc.yml`). These files can be a combination of Markdown, Jupyter Notebooks, and Restructured Text. The example above does not have parts, so the menu on the left will consist of just a list of the chapters. You can also group chapters in parts like this: -```yml +```yaml - format: jb-book - root: diff --git a/book/examples/book_structure.md b/book/examples/book_structure.md index daba15f..db702ee 100644 --- a/book/examples/book_structure.md +++ b/book/examples/book_structure.md @@ -16,7 +16,7 @@ DSAIE Overview Page ``` While the left menu shows the first two chapters in the table of contents (Home & Logistics), the right hand side menu shows the sections of the current chapter where an introduction is given on the different units of the course, the responsible lecturers as well as the schedule of lectures and practicals. Additionally, the book layout is explained to the students which can help clarify how to use the interactive sections! -The anatomy of a jupyter book is explained more in detail in [this](/jupyter-book-manual/book/basic-features/jupyterbook.md) page. In short, you can create structure in your book by having chapters and subschapters defined in the `.toc` file. In each chapter you can organize the content in sections using the `#` syntax which is visible in the menu on the right. +The anatomy of a jupyter book is explained more in detail on [this page](../basic-features/jupyterbook.md). In short, you can create structure in your book by having chapters and subschapters defined in the `.toc` file. In each chapter you can organize the content in sections using the `#` syntax which is visible in the menu on the right. ## Tagged content diff --git a/book/examples/overview.md b/book/examples/overview.md index 160131d..595f6a1 100644 --- a/book/examples/overview.md +++ b/book/examples/overview.md @@ -1,4 +1,4 @@ -# Overview +# TeachBooks Examples This chapter will showcase some TeachBooks making great use of Jupyter Book and TeachBooks features. They can serve as an inspiring starting point for structuring your own TeachBook or just to get an idea of how other teachers and students are using it. Lastly some example pages are shown which combine theory and interactive questions and coding to different degrees. diff --git a/book/features/overview.md b/book/features/overview.md index ea508a4..989d876 100644 --- a/book/features/overview.md +++ b/book/features/overview.md @@ -8,5 +8,5 @@ This chapter provides a list of commonly used book features together with sub-pa - how to use them - where to find the source code -To see examples for these features, go to the [Examples chapter](/book/examples/overview.md). +To see examples for these features, go to the [Examples chapter](../examples/overview.md). diff --git a/book/installation-and-setup/git-setup_local.md b/book/installation-and-setup/git-setup_local.md index 3444fd1..b765577 100644 --- a/book/installation-and-setup/git-setup_local.md +++ b/book/installation-and-setup/git-setup_local.md @@ -127,6 +127,6 @@ This is a (non-exhaustive) list of terminology that will be used in Git for loca - Tracked (files): files that Git knows about and keeps track of their history. - Untracked (files): files that Git does not yet know about. -## More on GitLab +## More on GitLab/GitHub -To get to know more about working in GitLab and getting familiar with its features, click [here](/jupyter-book-manual/book/workflows/overview.md) or watch this [video](https://www.youtube.com/watch?v=1SBtM3znviU&t=1s)! \ No newline at end of file +To get to know more about working in GitLab/GitHub and getting familiar with its features, click [here](../workflows/collaboration.md) or watch this [video](https://www.youtube.com/watch?v=1SBtM3znviU&t=1s)! \ No newline at end of file diff --git a/book/installation-and-setup/jupyter-book-setup.md b/book/installation-and-setup/jupyter-book-setup.md index a916543..a947a77 100644 --- a/book/installation-and-setup/jupyter-book-setup.md +++ b/book/installation-and-setup/jupyter-book-setup.md @@ -5,7 +5,7 @@ This page is useful for user type 5. ``` -Jupyter book is a regular Python package which converts our content into a website. It's part of all of the `requirements.txt` files for a book repository. At TeachBooks we developed a Python package called `teachbooks` which takes over the these features and adds [additional features](/book/features/overview.md). One of those additional features, for example, is the workflow to GitHub Pages. +Jupyter book is a regular Python package which converts our content into a website. It's part of all of the `requirements.txt` files for a book repository. At TeachBooks we developed a Python package called `teachbooks` which takes over the these features and adds [additional features](../features/overview.md). One of those additional features, for example, is the workflow to GitHub Pages. Concretely, this means that the teachbooks package can be used to replace the Jupyter book package when calling these features. You could think of it as `jupyter-book` being a dependency of `teachbooks`. From 2f6943ad3758f08e57424e9d615cbcc8d108891c Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Tue, 5 Nov 2024 21:03:29 +0100 Subject: [PATCH 15/21] set3 --- book/examples/live_code.md | 4 +-- book/features/live_code.ipynb | 1 + book/features/widgets.ipynb | 2 +- book/helper_code/intro.md | 4 +-- book/workflows/collaboration.md | 10 +++--- book/workflows/edit_book.md | 56 ++++++++++++++++----------------- 6 files changed, 39 insertions(+), 38 deletions(-) diff --git a/book/examples/live_code.md b/book/examples/live_code.md index 1b1a6bb..c6fa5f4 100644 --- a/book/examples/live_code.md +++ b/book/examples/live_code.md @@ -17,9 +17,9 @@ align: center --- Rocket Button ``` -To activate the live coding, the rocket button has to be activated like in the figure above. It's always useful to point this out in the beginning of the chapter because it might not be obvious to new users. Here's a not eused in the MUDE book +To activate the live coding, the rocket button has to be activated like in the figure above. It's always useful to point this out in the beginning of the chapter because it might not be obvious to new users. Here's a note used in the MUDE book. -```{Interactive Pages—Use Python in your Browser!} +```{Note} Interactive Pages — Use Python in your Browser! This online textbook has a number of pages that are set up to be used interactively. You can use the “Live Code” button under the Rocket Ship icon in the top right to activate the interactive features and use Python interactively! Sometimes the interactivity will involve completing an exercise, wheras on other pages it might simply provide the opportunity to edit the contents of code cells and execute it to explore the page contents interactively. Other pages may provide interactive figures (e.g., widgets). diff --git a/book/features/live_code.ipynb b/book/features/live_code.ipynb index 84e5d01..1546fa0 100644 --- a/book/features/live_code.ipynb +++ b/book/features/live_code.ipynb @@ -153,6 +153,7 @@ "metadata": {}, "source": [ "## Alternative with JupyterLite (less well integrated)\n", + "\n", "Another option to use python in your browser is to use JupyterLite. However, this doesn't give a similar seamless interface. You could create 'iframe-like' Ipython consoles / jupyterbook / jupyter lab environments in your book. As these 'iframes' are separate modules added to your page, the integration with the other content in your book is less flexible as with our sphinx-thebe extension. Furthermore, the best way to use a JupyterLite session would be a separate repo with the jupyter lab interface anyway, so you get the full browser experience. Alternatively, the ipython REPL better can be usefull, as shown here: https://teachbooks.github.io/learn-python/main/Python_Toolbox.html." ] } diff --git a/book/features/widgets.ipynb b/book/features/widgets.ipynb index 36bff96..2d441bb 100644 --- a/book/features/widgets.ipynb +++ b/book/features/widgets.ipynb @@ -6,7 +6,7 @@ "source": [ "# Ipywidgets\n", "\n", - "If you publish widgets in a jupyter book they might (depending on your implementation) require an active python kernel for the output to be interactive. Using the [thebe-integration](live_code.md), this is possible. Note: You can circumvent the use of a kernel by using packages which don't need such a kernel, for example the [non-kernel-based widgets using Plotly](interactive_element).\n", + "If you publish widgets in a jupyter book they might (depending on your implementation) require an active python kernel for the output to be interactive. Using the [thebe-integration](../examples/live_code.md), this is possible. Note: You can circumvent the use of a kernel by using packages which don't need such a kernel, for example the [non-kernel-based widgets using Plotly](interactive_element).\n", "\n", "## `matplotlib` widgets\n", "When you'd like to use `ipywidgets` in combinations with a `matplotlib` figure, import the following packages:\n", diff --git a/book/helper_code/intro.md b/book/helper_code/intro.md index 8268cf1..c5e7c38 100644 --- a/book/helper_code/intro.md +++ b/book/helper_code/intro.md @@ -4,7 +4,7 @@ This chapter contains a few scripts which can be useful in the book-editing proc - [LaTeX to markdown conversion](../external/latex-to-markdown-conversion/README.md) to convert a LaTeX file into jupyter-book compatible markdown. - [Snippitall](Snippitall) to insert the same code snippet at a certain point in each md file in a specific folder and all subfolder. - [Snippitonce](Snippitonce) to insert the same code snippet at a certain point in each md file only in a specific folder. - - [Extensionchecker](extensionchecker) to identify the kind of files present in subfolder - - [Filedownloader](filedownloader) to return the downloadlink for markdown for all files with a specified extension + - [Extensionchecker](Extensionchecker) to identify the kind of files present in subfolder + - [Filedownloader](Filedownloader) to return the downloadlink for markdown for all files with a specified extension - [Figreturner](figreturner) to return the markdown code for a figure in a specific extension - [Figshrinker](../external/Useful_python_code/figshrinker.ipynb) to compress JPEG images. \ No newline at end of file diff --git a/book/workflows/collaboration.md b/book/workflows/collaboration.md index 08496da..1453a39 100644 --- a/book/workflows/collaboration.md +++ b/book/workflows/collaboration.md @@ -14,13 +14,13 @@ The steps involved are as follows: 1. **Assign a task to yourself (milestones, issues)** 2. **Create your own version of the book as...** ```````{tab-set} -``````{tab-item} ... user type 3... +``````{tab-item} ... user type 3 ... **... by creating your own version of the book (branching) or selecting existing version:** - branching `````` -``````{tab-item} ... user type 4 and 5 +``````{tab-item} ... user type 4 and 5. `````{tab-set} ````{tab-item} Open repository for first time... @@ -49,14 +49,14 @@ The steps involved are as follows: 3. **Edit the book as ...** ```````{tab-set} -``````{tab-item} ... user type... 3 +``````{tab-item} ... user type 3 ... **... by directly adding changes on a single file to Git-timeline (committing):** - adding file or making changes to single file - committing `````` -``````{tab-item} ... user type 4... +``````{tab-item} ... user type 4 ... `````{tab-set} ````{tab-item} ... on a brand new version (branch)... @@ -90,7 +90,7 @@ The steps involved are as follows: ```` ````` `````` -``````{tab-item} ... user type 5... +``````{tab-item} ... user type 5 ... `````{tab-set} ````{tab-item} ... on a brand new version (branch)... diff --git a/book/workflows/edit_book.md b/book/workflows/edit_book.md index 7dd100a..f5b6ae8 100644 --- a/book/workflows/edit_book.md +++ b/book/workflows/edit_book.md @@ -366,38 +366,38 @@ Demonstration, video available [here](https://youtu.be/2ttjBevkEP8) 2. Once all the changes are made, it can be useful to check the changes locally on your device.
- By doing that you can preview how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy. +By doing that you can preview how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy. - Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. - You will firstly need to activate the right environment. Type the following command: +Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. +You will firstly need to activate the right environment. Type the following command: ``` conda activate jupyter-book-env ``` - (or the environment in which you have installed the `teachbooks` package!) - - Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: +(or the environment in which you have installed the `teachbooks` package!) + +Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: ``` teachbooks build ``` - Alternatively: +Alternatively: ``` jupyter-book build --all ``` - Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. +Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. - Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: +Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: ```{figure} figures/buildbook.PNG Output ``` - Paste the last line into your browser to see the updated changes. +Paste the last line into your browser to see the updated changes. ```{Note} @@ -407,32 +407,32 @@ Sometimes there are problems building the book. It could be that the building re ``` - If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] +If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] 3. If you are satisfied with your changes, you can select the files ready to be added to Git-timeline (staging) - For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: +For demonstration purposes, we have created a new Markdown file called `new-chapter.md`, which we want to add to the book. Since this is a new file, Git has no knowledge about its existence yet. I.e., the file is *untracked*. To add new files to our repository, we need to *stage* and *commit* them. To do this, open the Source Control menu in the left side bar. Our new file should appear in this menu: ```{figure} ../images/git-new-file.png The new file appears in the Source Control menu. ``` - Notice that there is a green letter U placed besides the file, meaning that our file is untracked. To add a file to the *staging area*, click on the + that appears when you hover over the file. +Notice that there is a green letter U placed besides the file, meaning that our file is untracked. To add a file to the *staging area*, click on the + that appears when you hover over the file. 4. Adding changes to the Git-timeline (committing) - Next, in the field that says "Message", write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, the menu should now look something like this: +Next, in the field that says "Message", write a short description of the changes you have made. This message is what is called the *Commit Message*. After we've done this, the menu should now look something like this: ```{figure} ../images/git-file-added.png The new file has been staged, and we've written a Commit Message. ``` - Now, we are ready to add the changes to the repository. This is done by *committing* the staged changes. To do this, simply press the big, blue "Commit" button in the Source Control menu. +Now, we are ready to add the changes to the repository. This is done by *committing* the staged changes. To do this, simply press the big, blue "Commit" button in the Source Control menu. 5. Adding changes to GitLab/GitHub (pushing) - In the bottom left corner, next to the branch name, click the "Synchronize Changes" button (the one that looks like this: 🔄, highlighted in the image below) to push the changes to GitLab/GitHub. +In the bottom left corner, next to the branch name, click the "Synchronize Changes" button (the one that looks like this: 🔄, highlighted in the image below) to push the changes to GitLab/GitHub. ```{figure} ../images/git-push.png @@ -445,38 +445,38 @@ After committing, click the 🔄 button to push our changes to the remote reposi 2. Once all the changes are made, it can be useful to check the changes locally on your device.
- By doing that you can preview how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy. +By doing that you can preview how it will look on the website. If all the required environments and packages are downloaded, checking changes locally is fairly easy. - Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. - You will firstly need to activate the right environment. Type the following command: +Navigate to the terminal in VS code, located at the bottom of the window or by clicking on `Terminal` in the top bar. +You will firstly need to activate the right environment. Type the following command: ``` conda activate jupyter-book-env ``` - (or the environment in which you have installed the `teachbooks` package!) - - Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: +(or the environment in which you have installed the `teachbooks` package!) + +Then we can build the book locally. Make sure you are in the right repository in VS code and type the following command: ``` teachbooks build ``` - Alternatively: +Alternatively: ``` jupyter-book build --all ``` - Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. +Note: use `--all` for the jupyter-book whenever building a book to make sure the table of contents fully updates. Or alternatively, delete the old `_build` folder before building the new book. - Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: +Where book is the name of the folder containing all the files that make up your book. After `teachbooks` is done running you will get the following: ```{figure} figures/buildbook.PNG Output ``` - Paste the last line into your browser to see the updated changes. +Paste the last line into your browser to see the updated changes. ```{Note} @@ -486,11 +486,11 @@ Sometimes there are problems building the book. It could be that the building re ``` - If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] +If your book includes interactive element a webserver is required to host the book. If you want to do this locally, you can make use of (the teachbooks package to start up a local webserver)[setup-local-server] 3. If you are satisfied with your changes, you can select the files ready to be added to Git-timeline (staging) - The staging GitHub Desktop assumes you want to stage all files. These files will show up on the left side bar when you open GitHub Desktop. You can unselect some of them (unstaging them) by clicking on the *check*. +The staging GitHub Desktop assumes you want to stage all files. These files will show up on the left side bar when you open GitHub Desktop. You can unselect some of them (unstaging them) by clicking on the *check*. ```{figure} figures/Stage_GitHubDekstop.PNG width: 50% From b74d7d12c9da098f0d58a81d9cb372d13951e2e7 Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Tue, 5 Nov 2024 22:08:35 +0100 Subject: [PATCH 16/21] update --- book/external/Useful_python_code | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/external/Useful_python_code b/book/external/Useful_python_code index 8c7d765..c8327b3 160000 --- a/book/external/Useful_python_code +++ b/book/external/Useful_python_code @@ -1 +1 @@ -Subproject commit 8c7d765f3a06b18517b315455ae7f5dc9230748c +Subproject commit c8327b3e2cc68d44958974a47c940bc89f4bb32b From 706f2ea8d64cf5e95eba51b61ce8a008281d810c Mon Sep 17 00:00:00 2001 From: Julie Kirsch Date: Tue, 5 Nov 2024 22:32:31 +0100 Subject: [PATCH 17/21] update --- book/external/Useful_python_code | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/external/Useful_python_code b/book/external/Useful_python_code index c8327b3..8c7d765 160000 --- a/book/external/Useful_python_code +++ b/book/external/Useful_python_code @@ -1 +1 @@ -Subproject commit c8327b3e2cc68d44958974a47c940bc89f4bb32b +Subproject commit 8c7d765f3a06b18517b315455ae7f5dc9230748c From 0d11e539e1e75f5a29937fabb5b901a18148ed9a Mon Sep 17 00:00:00 2001 From: Tom van Woudenberg Date: Wed, 6 Nov 2024 09:59:20 +0100 Subject: [PATCH 18/21] Update intro.md --- book/intro.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/book/intro.md b/book/intro.md index f362f04..b3c986b 100644 --- a/book/intro.md +++ b/book/intro.md @@ -1,13 +1,19 @@ # TeachBooks Manual -This is an introduction to Git, VS Code and Jupyter Books for teachers and teaching assistants involved in TeachBooks, our platform easing the process of making a Jupyter book. This book will continue to develop, so feel free to contribute https://gitlab.tudelft.nl/interactivetextbooks-citg/jupyter-book-manual! For more information about teachbooks, visit [https://teachbooks.tudelft.nl/](https://teachbooks.tudelft.nl/). +This manual assists you in creating and collaborating on Jupyter book for educational purposes. Some parts are specifically aimed for teachers at Delft University of Technology, although all material and tools are openly available. This manual aims at providing an easy start and advanced usages for new and existing users with or without skills on this topic. it is part of TeachBooks, for more information visit [https://teachbooks.tudelft.nl/](https://teachbooks.tudelft.nl/). ## Contact If you encounter any issues and you have a TU Delft account, report it by clicking --> {fa}`lightbulb` on the top right corner of this page. Or contribute directly by creating a merge request in the [repository](https://gitlab.tudelft.nl/interactivetextbooks-citg/jupyter-book-manual). If you have questions, contact Tom van Woudenberg, Robert Lanzafame or our TA Julie Kirsch at TeachBooks@tudelft.nl, also for non-TU Delft account holders. TU Delft account holder can also contact us in the [MS Teams Open Interactive Textbooks Community](https://teams.microsoft.com/l/team/19%3Ah9-uRcP_yYauh-VuoPFozJVUvHVOB4a0mz1ZWvh4q4Q1%40thread.tacv2/conversations?groupId=3e88c1f3-4a4f-483a-a366-7e617de9ba99&tenantId=096e524d-6929-4030-8cd3-8ab42de0887b) -## Feedback We really value your feedback on this manual. This helps us improving it. Please keep using the manual as you build your own Jupyter Book and come back to fill out this short [survey](https://forms.gle/hXbFUQgN95H8ftxt9). +## Contribute +This book will continue to develop, so feel free to contribute https://gitlab.tudelft.nl/interactivetextbooks-citg/jupyter-book-manual! You can do so directly by forking this repository and creating a merge request. + +The released book can be found on on https://teachbooks.tudelft.nl/jupyter-book-manual. This page shows the built book of the `release` branch. The `main` branch is meant for reviewing and is visible here: https://teachbooks.tudelft.nl/jupyter-book-manual/draft. All branches will also be visible on the mirrored repository on GitHub Pages: https://github.com/TeachBooks/mirror_teachbook_manual/actions + +Some parts of this book are taken from other sources in the form of submodules (linked in the folder [book/external](book/external)). To contribute to those pages, contribute to the source repository directly with a fork and merge/pull request. If you intent to clone this boko including its submodules, clone using: `git clone --recurse-submodules git@gitlab.tudelft.nl:interactivetextbooks-citg/jupyter-book-manual.git` + Happy book building! \ No newline at end of file From 39ea8843eab66195a7b753e6fc6f8a04ce8bd4dc Mon Sep 17 00:00:00 2001 From: Tom van Woudenberg Date: Wed, 6 Nov 2024 09:59:39 +0100 Subject: [PATCH 19/21] Update README.md --- README.md | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 34c44ef..b3c986b 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,19 @@ -# Jupyter Book Manual +# TeachBooks Manual -A short introduction to Git, VSCode and Jupyter Books for teachers and TA's. Currently, this book only holds some generic installation instructions. In the near future, this will be extended with guides on the Git/Jupyter Book workflow, as well as some recipes and examples on Jupyter Book components. +This manual assists you in creating and collaborating on Jupyter book for educational purposes. Some parts are specifically aimed for teachers at Delft University of Technology, although all material and tools are openly available. This manual aims at providing an easy start and advanced usages for new and existing users with or without skills on this topic. it is part of TeachBooks, for more information visit [https://teachbooks.tudelft.nl/](https://teachbooks.tudelft.nl/). -## Contributing +## Contact +If you encounter any issues and you have a TU Delft account, report it by clicking --> {fa}`lightbulb` on the top right corner of this page. Or contribute directly by creating a merge request in the [repository](https://gitlab.tudelft.nl/interactivetextbooks-citg/jupyter-book-manual). -Feedback is always welcome. If something doesn't work, or if you have suggestions, you can always make an issue on the Issue Board or make a Merge Request. If you create a branch, that branch will also be visible on the mirrored repository on GitHub to ease reviewing: https://github.com/TeachBooks/mirror_teachbook_manual/actions +If you have questions, contact Tom van Woudenberg, Robert Lanzafame or our TA Julie Kirsch at TeachBooks@tudelft.nl, also for non-TU Delft account holders. TU Delft account holder can also contact us in the [MS Teams Open Interactive Textbooks Community](https://teams.microsoft.com/l/team/19%3Ah9-uRcP_yYauh-VuoPFozJVUvHVOB4a0mz1ZWvh4q4Q1%40thread.tacv2/conversations?groupId=3e88c1f3-4a4f-483a-a366-7e617de9ba99&tenantId=096e524d-6929-4030-8cd3-8ab42de0887b) -If you've questions, contact Tom van Woudenberg, Robert Lanzafame or our TAs Julie Kirsch at TeachBooks@tudelft.nl, also for non-TU Delft account holders. TU Delft account holder can also contact us in the [MS Teams Open Interactive Textbooks Community](https://teams.microsoft.com/l/team/19%3Ah9-uRcP_yYauh-VuoPFozJVUvHVOB4a0mz1ZWvh4q4Q1%40thread.tacv2/conversations?groupId=3e88c1f3-4a4f-483a-a366-7e617de9ba99&tenantId=096e524d-6929-4030-8cd3-8ab42de0887b) \ No newline at end of file +We really value your feedback on this manual. This helps us improving it. Please keep using the manual as you build your own Jupyter Book and come back to fill out this short [survey](https://forms.gle/hXbFUQgN95H8ftxt9). + +## Contribute +This book will continue to develop, so feel free to contribute https://gitlab.tudelft.nl/interactivetextbooks-citg/jupyter-book-manual! You can do so directly by forking this repository and creating a merge request. + +The released book can be found on on https://teachbooks.tudelft.nl/jupyter-book-manual. This page shows the built book of the `release` branch. The `main` branch is meant for reviewing and is visible here: https://teachbooks.tudelft.nl/jupyter-book-manual/draft. All branches will also be visible on the mirrored repository on GitHub Pages: https://github.com/TeachBooks/mirror_teachbook_manual/actions + +Some parts of this book are taken from other sources in the form of submodules (linked in the folder [book/external](book/external)). To contribute to those pages, contribute to the source repository directly with a fork and merge/pull request. If you intent to clone this boko including its submodules, clone using: `git clone --recurse-submodules git@gitlab.tudelft.nl:interactivetextbooks-citg/jupyter-book-manual.git` + +Happy book building! \ No newline at end of file From 288130330c067c759dbf71951a5a8b277c4c140a Mon Sep 17 00:00:00 2001 From: Tom van Woudenberg Date: Wed, 6 Nov 2024 10:00:25 +0100 Subject: [PATCH 20/21] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b3c986b..6696d0e 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # TeachBooks Manual -This manual assists you in creating and collaborating on Jupyter book for educational purposes. Some parts are specifically aimed for teachers at Delft University of Technology, although all material and tools are openly available. This manual aims at providing an easy start and advanced usages for new and existing users with or without skills on this topic. it is part of TeachBooks, for more information visit [https://teachbooks.tudelft.nl/](https://teachbooks.tudelft.nl/). +This manual assists you in creating and collaborating on Jupyter book for educational purposes. Some parts are specifically aimed for teachers at Delft University of Technology, although all material and tools are openly available. This manual aims at providing an easy start and advanced usages for new and existing users with or without skills on this topic. it is part of TeachBooks, for more information visit [https://teachbooks.tudelft.nl/](https://teachbooks.tudelft.nl/). ## Contact If you encounter any issues and you have a TU Delft account, report it by clicking --> {fa}`lightbulb` on the top right corner of this page. Or contribute directly by creating a merge request in the [repository](https://gitlab.tudelft.nl/interactivetextbooks-citg/jupyter-book-manual). From e90e509afeaf7fee2079d735f18f7092b5ef6c85 Mon Sep 17 00:00:00 2001 From: Tom van Woudenberg Date: Wed, 6 Nov 2024 10:01:41 +0100 Subject: [PATCH 21/21] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6696d0e..db835c9 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # TeachBooks Manual -This manual assists you in creating and collaborating on Jupyter book for educational purposes. Some parts are specifically aimed for teachers at Delft University of Technology, although all material and tools are openly available. This manual aims at providing an easy start and advanced usages for new and existing users with or without skills on this topic. it is part of TeachBooks, for more information visit [https://teachbooks.tudelft.nl/](https://teachbooks.tudelft.nl/). +This manual assists you in creating and collaborating on [JupyterBooks](https://jupyterbook.org/) for educational purposes. Some parts are specifically aimed for teachers at Delft University of Technology, although all material and tools are openly available. This manual aims at providing an easy start and advanced usages for new and existing users with or without skills on this topic. it is part of TeachBooks, for more information visit [https://teachbooks.tudelft.nl/](https://teachbooks.tudelft.nl/). ## Contact If you encounter any issues and you have a TU Delft account, report it by clicking --> {fa}`lightbulb` on the top right corner of this page. Or contribute directly by creating a merge request in the [repository](https://gitlab.tudelft.nl/interactivetextbooks-citg/jupyter-book-manual).