Project Management

My Setup Tools for the FabAcademy:

  1. Notepad++ (Documentation and markdown support) Notepad for Windows
  2. Python( work in backround) Python for Windows
  3. Power Toys (compressing images)PowerToys for Windows
  4. Snipping Tools (Screenshots) in combination with Paint
  5. Git for Windows git for Windows
  6. MKDocs Tutorial ; Markdown Start Tutorial
  7. DaVinci (Videocutting) DaVinci

First of all i take a look on the FabAcademy of my instructor Lars Mattern He used Markdown and MKDocs. This approach allows for easy and complete documentation while saving time for the practical projects, which makes it the best option for me as well. That’s why I’ve decided to use it next weeks. During my studies, I also learned HTML, but exploring Markdown feels like a fresh and efficient way to learn something new.

So i istall MKdocs and Markdown. I refresh the python version on my laptop. And i istall Notpad ++. Than i make a good folder structur.

The Basic Syntax you can find on this Link: markdown Basic Syntax

Setup for Photos and Screen Recordings

PowerToys

PowerToolLogo

  1. Installation: Download and install PowerToys to compress images and videos.
  2. Set sizes: Configure the image and video formats you need.

PowerToys

  1. Usage: After setup, you can reduce or compress the size of an image or video by right-clicking on it.
  2. Note: You must not upload more than 10 MB per week.

Snipping Tool

  1. Pre-installed (Windows): Check if the Snipping Tool is available on your system.
  2. Features:
  3. Take screenshots.
  4. Add arrows and shapes.

SnippingTool

  1. Add text: Use Paint to add text if necessary.

DaVinci Resolve

DaVinciLogo

  1. Installation: Download and install DaVinci Resolve to edit your video recordings.
  2. Post-processing: Compress the edited videos again using PowerTool to optimize them for upload.

Documenting Your Content

Notepad++LogoNotpade

  1. Installation: Download and install Notepad++ to document your progress.
  2. Markdown:
  3. Configure Notepad++ to edit Markdown files (.md).
  4. Three additional programs are required for Markdown (see next section).

Setting Up Your Programming Environment with Markdown

*Install MKDocs

  1. Install MkDocs: Download MkDocs to create a static website. Use the prompt to execute commands(pip install mkdocs)

InstallMKDocs

  1. Install or Update Python: Ensure you have the latest version of Python installed.
  2. Open Command Prompt: Use the command prompt to execute commands. (pip -v)

InstallPython

Folder Structure

  1. Create a clear folder structure for your project.
  2. Download YML files (.yml) needed for the website.
  3. Note: Ask your instructor if they can provide these files in advance.
  4. Install Theme:
    Istall Theme

  5. Install a theme, e.g., Dracula. (pip install mkdocs-dracula-theme) -Change a theme in your mkdocs.md at notepad++ ChangeTheme

  6. Themes can be found on the official MkDocs website: MkDocs Theme

Create Markdown Files

  1. Write your documentation as simple text files.
  2. Save them with the .md (Markdown file) extension.

Working on Your Website

  1. Command Prompt: Navigate to the folder where your files are saved. (cd documents\2025_FabAcademy\!gitlab)

Promptnavigation

  1. Open Notepad++: Edit your website with Notepad++.
  2. Start Server:
  3. Enter the command mkdocs serve in the command prompt.
  4. View Website in Browser:
  5. Open your preferred browser (e.g., Firefox).
  6. Enter the displayed IP address.
  7. Check Changes:
  8. Changes to Markdown files will be visible after refreshing the browser page.

ChangewebsiteTests

Here is an example of my Markdown code. The #discribes a header and to bring in some images on to your website you can use ![Alt-Text](name.jpg)

 # About Me

![Picture of Kerstin](Profil_Kerstin.JPG)

## Hello FabLab World!

My name is Kerstin Ogrissek, and for a long time, I was not a Maker at all. Sure, I solved problems, but not with technology – 
I worked as a physiotherapist, helping people directly through treatments. I didn’t even have a desk, let alone a computer!

But then, there was this moment when I realized: I want to solve problems through products and hold something tangible in my hands at the end of the day.
So, I decided to take a completely new path and began studying digital product design.

During my studies, I encountered the Maker community for the first time – and I was immediately fascinated. 
When I saw the endless possibilities and experienced the enriching collaboration of working Open Source alongside other Makers, I knew: This is where I belong!

At the start of my journey, I worked as a student assistant in the DesignLab, where I gained my first practical experiences. 
Today, I work full-time at the HRW FabLab, where I’ve met many inspiring people and learned to use a wide range of machines and technologies.

Some of my favorite projects include:

Developing an inclusive chess set, which was featured in the Make Magazine.
![Inclusive chess](OldProject_Chess.jpg)
Collaborating with fellow students to redesign and modernize the game "Senso (Simon)."
![Senso Simon](OldProject_SimonSense.jpg)
Working on quantum experiment setups for schools and universities.
![MichelsonInterferometer](2024_09_03_Aufbau_Michelson_Interferometer_Weiss_Antrahzit_ISO.png)

**Now, I’m incredibly excited about the opportunity to exchange knowledge and embark on an inspiring journey during the FabAcademy! 🚀**

GitLab Environment and Uploading GitlabLogo

Set Up GitLab

  1. Create GitLab Folder: Create a folder for your GitLab project, e.g., C:\Users\merry\Documents\2025_FabAcademy\!gitlab>.
  2. Download Git for Windows:Download and install Git for Windows. This is later for upload your Website to Gitlab.

Create SSH Keys

  1. Generate SSH Key:

PromptKeySSH

  • Open the command prompt and enter:
    ssh-keygen -t ed25519 -C "gitlab"
  • Press Enter three times without entering an additional password. PromptingSSH

  • Copy SSH Key:

  • Navigate to C:\Users\admin\.ssh on your PC and open the .pub file using Notepad++.
    Navigationtofile

  • Copy the entire code.

  • Add SSH Key to GitLab:
  • Go to GitLab, select “SSH Key,” and click New Key.
    ADDthekeytogitlab

  • Paste the copied key, label it (e.g., gitlab), and click Add.

  • Test Connection:
  • Enter the following command:
    ssh -T git@gitlab.fabcloud.org
  • Confirm with yes when prompted: “Are you sure you want to continue connecting (yes/no/[fingerprint])?”
  • Your PC is now connected to GitLab.

WebsiteTest

Clone Repository

  1. Copy Repository URL:
  2. Go to your project in GitLab and click the blue Code button.
  3. Select “Clone with SSH” and copy the URL.

CloneGitlabCode

  1. Clone Repository:
  2. Enter the following command:
    git clone <copied URL>
    CommandRepoitory
  3. Navigate to the cloned folder, e.g., cd kerstin-ogrissek.
  4. Configure Git:
  5. Run the following commands:
    git config user.name "Kerstin Ogrissek" git config user.email "kerstin.ogrissek@xxxx.de" git config --global user.name "Kerstin Ogrissek" git config --global user.email "kerstin.ogrissek@xxxx.de"

Set Up Student Template

  1. Download Student Template:
  2. Go to Fabacademy/StudentTemplate MkDocs in GitLab and download the ZIP folder via the blue Code button.

GitlabTemplatemkdocs

CodeButton

  1. Clean Folder Structure:
  2. Delete all files in the kerstin-ogrissek folder except for the Git-related files (save them elsewhere if necessary).
  3. Add Template Files:
  4. Extract the downloaded ZIP folder and move the files into the kerstin-ogrissek folder.
  5. Organize Folder:
  6. Delete empty folders and the ZIP file.

Gitlab_TemplateMKDocs_Folder

## Example: Uploading Files 1. Create a Text File: Create a file named Test.txt in the kerstin-ogrissek folder. 2. Use GitGUI:

UIGITGUI

  • Open GitGUI and click Rescan to see changes. Make also sure that your Gitlab is open at your favorit browser.
  • Select the changed file and click Stage Changed (the file will appear at the bottom).
  • Add a description of the change in the commit field and click Commit.
  • Push Files:
  • Click Push and confirm again in the pop-up window.

ButtonGitgui


You’re all set! Whenever you make changes to a file, you can upload them using GitGUI. Be sure not to exceed 10 MB per push or per week.