main pull request #6

Merged
stephan.hadan merged 41 commits from main into develop 2025-01-24 15:16:41 +01:00
6 changed files with 177 additions and 2 deletions
Showing only changes of commit 593bc7b773 - Show all commits

128
README.md
View file

@ -24,3 +24,131 @@
alt="Built with Material for MkDocs"
/></a>
</p>
## Sites
| **Environment** | **URL** |
|-----------------|-----------------------------------------|
| Staging | https://stephan.preview.hadan.de |
| Production | https://stephan.hadan.de |
## Participate
1. Make sure you are already have an account at https://git.hadan-it.com. If not pls be so kind to contact support@hadan-it.com.
2. Contact support@hadan-it.com to be granted access to the stephan.hadan.de-repository.
## Development
Checkout this project:
```
git clone ssh://git@git.hadan-it.com:222/web/stephan.hadan.de.git
```
Install Python 3.12 with brew:
```
brew install python@3.12
```
Create a virtual environment at the project root - this is used to isolate project packages from the global packages.
```
$ python3.12 -m venv venv
```
Activate the environment.
```
$ source venv/bin/activate
```
Install mkdocs - this is covered in the project requirements file. Make sure you are at projects root.
```
$ make install
```
From time to time it is necessary to run the last command to update your mkdocs environment. Just run `make install` at regular intervals to stay up-to-date.
### Upgrade to Python 3.12
Delete your venv folder inside your already existing checked out repository:
```
rm -rf venv
```
After that, close your terminal session, create a new one, navigate to your repository again. Then: please continue with "Install Python 3.12 with brew" in the above paragraph and update your environment
### Folder structure
```
.
├── CHANGELOG
├── LICENSE
├── README.md
├── docs
├── macros
│   └── __init__.py
├── mkdocs.yml
├── overrides
├── renovate.json
├── requirements.txt
├── resources
└── venv
```
### Install dependencies for optimization function
#### macOS
```
$ brew install cairo freetype libffi libjpeg libpng zlib pngquant
```
#### Linux
```
$ apt-get install libcairo2-dev libfreetype6-dev libffi-dev libjpeg-dev libpng-dev libz-dev pngquant
```
### Install WeasyPrint dependencies
#### macOS
The easiest way to install WeasyPrint on macOS is to use Homebrew.
When Homebrew is installed, install Python, Pango and libffi:
```
$ brew install python pango libffi rust jpeg
```
### Generate and preview full documentation locally
In the root of the checked out repository just use the following command to serve the documentation:
```
$ mkdocs serve
```
This will spin up your instance on port 8000 reacting on any changes you make until you stop the service with Ctrl+C
## Contribute code/documentation
To ensure a reasonable joint development of the documentation, it is necessary to derive each change reasonably into a separately named branch. The following prefixes are available for this purpose:
* feat/ for new features/documentation
* hotfix/ for changes to existing documentation
Examples:
* feat/new-blog-post
* hotfix/translation-of-blog-entry
After the development of the branch has been completed and extensively tested locally, a corresponding merge request is created in the **develop** branch and approved by a colleague. This ensures a high quality of the documentation and the necessary review.
Once the request has been approved, it can be merged into the develop branch. An automatic build pipeline builds the new devel status on https://stephan.preview.hadan.de for reasons of overview, the source branch should be deleted accordingly during the merge.
A merge from Devel to Main and a deployment via a build pipeline to https://stephan.hadan.de takes place at regular intervals. This merge is only carried out after consultation.

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 101 KiB

View file

@ -198,6 +198,33 @@ Einfacher und solider Hard- und Softwarerollout muss in Unternehmen Bestandteil
---
# Weitere Projekte
### Abseits der ausführlich beschriebenen Projekte in den Steckbriefen habe ich noch viele weitere spannende Themen bearbeitet. Einen Überblick dazu findest du weiter unten übersichtlich in Kategorien geordnet.
<div class="grid cards" markdown>
- [![](/assets/images/customer.png)](/projects/customerprojects/)
### [Kundenprojekte](/projects/customerprojects/)
- [![](/assets/images/internal.png)](/projects/internalprojects/)
### [Interne IT Projekte](/projects/internalprojects/)
- [![](/assets/images/private.png)](/projects/privateprojects/)
### [Private Projekte](/projects/privateprojects/)
</div>
<br />
Illustrations by [unDraw](https://undraw.co/).
---
# Bleiben wir in Kontakt
[:fontawesome-brands-bluesky: Folge @stiebke auf **Bluesky**](https://bsky.app/profile/stiebke.bsky.social)<br />

View file

@ -4,4 +4,24 @@ comments: false
---
# Projekte
TBD
Abseits der ausführlich beschriebenen Projekte in den Steckbriefen habe ich noch viele weitere spannende Themen bearbeitet. Einen Überblick dazu findest du weiter unten übersichtlich in Kategorien geordnet.
<div class="grid cards" markdown>
- [![](/assets/images/customer.png)](/projects/customerprojects/)
### [Kundenprojekte](/projects/customerprojects/)
- [![](/assets/images/internal.png)](/projects/internalprojects/)
### [Interne IT Projekte](/projects/internalprojects/)
- [![](/assets/images/private.png)](/projects/privateprojects/)
### [Private Projekte](/projects/privateprojects/)
</div>
<br />
Illustrations by [unDraw](https://undraw.co/).