diff --git a/aquarians/aqua_turn_1.md b/aquarians/aqua_turn_1.md index a8da066..0c71b05 100644 --- a/aquarians/aqua_turn_1.md +++ b/aquarians/aqua_turn_1.md @@ -1,16 +1,16 @@ --- title: "Aquarian: Runde 1" -date: 2024-03-17 +date: 2023-10-15 --- # Turn 1 ## Location Discovery: -![Map turn 1](./map1.png "Map turn 1") - Region name is Sygirfal, 2 swamps around and 4 oceans. We will be able to send boats in 4 directions! +![Map turn 1](./map1.png "Map turn 1") + Starting on a wooded plain, surrounded by 2 swamps and the ocean. Resources: 500 wood, 100 saplings, 51 horses, 4004 peasants. General starting allocation: 2500 silvers, 4 stones, 10 wood. diff --git a/aquarians/aqua_turn_2.md b/aquarians/aqua_turn_2.md index e2d72bf..8306219 100644 --- a/aquarians/aqua_turn_2.md +++ b/aquarians/aqua_turn_2.md @@ -1,9 +1,12 @@ --- title: "Aquarians: Runde 2" -date: 2024-03-24 +date: 2023-10-17 --- # Turn 2 +First boat sent +All mages are T1 + ![Map turn 2](./map2.png "Map turn 2") Everything went as planned except for one entertainer unit that didn't leave the boat. I forgot the LEAVE order! @@ -11,13 +14,10 @@ No major consequences, it's an opportunity that will need to be exploited. No visits from potential neighbors. No coasts on the horizon. - - The turn is simple, we have no more silvers to spend: Everyone who can brings back money, the boat explores, we start building the second boat. The future captain learns entertain, it can always be useful. ## Mages - ALL mages will cast a spell to earn money. In Gwryrrd it's Cattle Healing ATTENTION: Make sure to get into the habit of setting the spell level. Otherwise it's a cast at the mage's level. diff --git a/aquarians/aqua_turn_3.md b/aquarians/aqua_turn_3.md index 73b5b7c..99af57e 100644 --- a/aquarians/aqua_turn_3.md +++ b/aquarians/aqua_turn_3.md @@ -1,10 +1,13 @@ --- title: "Aquarians: Runde 3" -date: 2024-03-31 +date: 2023-10-20 --- # Turn 3 +0ne mage reached level 2! +Started building a second ship + ![Map turn 3](./map3.png "Map turn 3") No visits from potential neighbors. diff --git a/aquarians/aqua_turn_4.md b/aquarians/aqua_turn_4.md index d9a5f75..cb6ce9f 100644 --- a/aquarians/aqua_turn_4.md +++ b/aquarians/aqua_turn_4.md @@ -1,10 +1,12 @@ --- title: "Aquarians: Runde 4" -date: 2024-04-07 +date: 2023-10-23 --- # Turn 4 -------- + **We found a new island!** + ![Map turn 4](./map4.png "Map turn 4") - No visits from potential neighbors. diff --git a/aquarians/aqua_turn_5.md b/aquarians/aqua_turn_5.md index 86152e1..44f5368 100644 --- a/aquarians/aqua_turn_5.md +++ b/aquarians/aqua_turn_5.md @@ -1,15 +1,19 @@ --- title: "Aquarians: Runde 5" -date: 2024-04-14 +date: 2023-10-26 --- # Turn 5 -------- -No visits from potential neighbors. -**Discovery of close neighbors!** -**Meeting with a tribe from the new island!** -![Map turn 5](./map5.png "Map turn 5") +**Found close neighbors!** +**Encountered a tribe from the new island!** +Second boat sent +First messages sent and received + +![Map turn 5](./map5.png "Map turn 5") + +No visits from potential neighbors. *Diplomatic messages are in communication* diff --git a/aquarians/aqua_turn_6.md b/aquarians/aqua_turn_6.md new file mode 100644 index 0000000..f372a00 --- /dev/null +++ b/aquarians/aqua_turn_6.md @@ -0,0 +1,33 @@ +--- +title: "Aquarians: Runde 6" +date: 2023-10-29 +--- +# Turn 6 (29/10 4/11) +-------- +A third boat is launched! +Not enough wood to build a new boat. + +![Map turn 6](./map6.png "Map turn 6") + +No visits from potential neighbors. +No coasts on the horizon! + +## Sygirfal +470 silver on Sygirfal +We will spend 400 to recruit 5 new entertainers. +Hammon (4qmp) reached level 3, we will take advantage to teach entertainment to the new ones and to level 1 entertainers. +The LEARN AUTO skill order for the teacher and students, allows leaving the program to optimize the LEARN and TEACH of the skill. + +Not having enough wood anymore, Ugarit (4qmj) learns to make carts. +Zimrida (hha6) waits for a second horse and entertainment. The 2 horses will allow him to pull the Halfling's cart if he entrusts it to us. +Plus we'll be a bit tight on silver, so an extra entertainer isn't bad. + +The boats explore, those who can bring back money do so. + +## Diplomacy +Nothing special, and just like in real life, I don't have much time, so I neglect maintaining relations and set that aside. +As it turns out, I'll miss a message about a collaboration proposal, which will have consequences. + +## Magellan +New tip : how to distinguish between what you can actually see and all the regions what you discovered. +In Magellan Right click on the Map then Renderer / Region Renderer / Enable fog of war \ No newline at end of file diff --git a/aquarians/aqua_turn_7.md b/aquarians/aqua_turn_7.md new file mode 100644 index 0000000..662d068 --- /dev/null +++ b/aquarians/aqua_turn_7.md @@ -0,0 +1,31 @@ +--- +title: "Aquarians: Runde 7" +date: 2023-11-04 +--- +# Turn 7 +-------- + +ATTENTION: Your faction will no longer be protected against attacks. +First Groups + +![Map turn 7](./map7.png "Map turn 7") + +No visits from potential neighbors. +No coasts on the horizon! + +This turn nothing special: Bodmelqart (4qmc) our first sailor reached Level 5. He learned while sailing :). + +## Actions +330 silver on Sygirfal +Entertainers reached level 2, that's good! Next week we should earn more silver! +We will recruit: +1 mason to make 2 tradeposts. No visiting neighbor so we'll manage alone. +1 additional forestry +Zimrida (hha6) leaves for the halfling, we give him travel silver. +While waiting for enough wood, Ugarit (4qmj) learns entertainment. +The boats explore, those who can bring back silver do so. + +## GROUPS +I like creating groups to facilitate temporary or longer agreements. This avoids certain problems with poorly configured HELP later. +Be cautious with groups. They inherit their parent's configuration. If you modify the parent (for example, your basic HELP settings), existing groups will NOT be automatically updated. +In Magellan, you can view all your groups and their configuration under Faction Stats. \ No newline at end of file diff --git a/aquarians/aqua_turn_8.md b/aquarians/aqua_turn_8.md new file mode 100644 index 0000000..a44190c --- /dev/null +++ b/aquarians/aqua_turn_8.md @@ -0,0 +1,51 @@ +--- +title: "Aquarians: Runde 8" +date: 2023-11-08 +--- +# Turn 8 +-------- + +**Found a new close neighbor!** +This is the first turn where we can be attacked or robbed (assaulted)! +No coasts on the horizon but the firewall! +**Crisis situation with neighbors** + +![Map turn 8](./map8.png "Map turn 8") + +No visits from potential neighbors. + +## The Firewall +The crew of the Gin Fizzzz (p1n2) refuses to travel to firewall (4, 15). +Eressea is divided into multiple zones, commonly referred to as worlds. +These zones are separated by borders. +"Firewalls" typically serve as borders. +Firewalls can't be crossed. + +## Topares: + +Meeting 2 neighbors, "Halbe Linge" and "Trolle, einige Steine tragend". +Both could work together. +Sending a message to the troll. Interesting partner for an Aquarian (mining, quarrying, construction and solid front line)! + +## Actions +Zimrida (hha6) continues towards Vesolsinmul. +Bodmelqart (4qmc) will follow the firewall a bit. +Baldo (4qmk) will get closer to the north island coasts. +Aqhat (t3zs) will go back up to our island. + +## Sygirfal +720 silver on Sygirfal +We recruit a captain and start a new boat +The rest of the money is kept for next week. + +## Diplomacy +That week I send my orders early, I have little time and I receive late a warning from the Halfling! +He accuses me of hiding, that means moving with a stealthy unit (or in Hide faction) +He writes to me with copy to the troll and another tribe. That doesn't smell good! Does he want to make others believe I'm a spy? +I must absolutely defend myself quickly or it will become complicated! +Is there another faction trying to hide by pretending to be me? (a demon?) +I check well on the region if I don't see anything and if by chance I wouldn't have made an error. +None. No stealth. Is(are) he(they) looking for a pretext to harm me? +Anyway I can't do more, I can no longer modify my orders, the turn is launched in less than 4 hours and I don't have access to my computer or internet. +It's my fault. I should have taken time to communicate more with him and not taken a friendly first contact for granted. If this goes badly, it will be my fault. +When meeting a potential ally you really need to establish strong and regular contact. \ No newline at end of file diff --git a/aquarians/aqua_turn_9.md b/aquarians/aqua_turn_9.md new file mode 100644 index 0000000..ad60a97 --- /dev/null +++ b/aquarians/aqua_turn_9.md @@ -0,0 +1,51 @@ +--- +title: "Aquarians: Runde 9" +date: 2023-11-12 +--- +# Turn 9 +-------- + +**Encountered a new close neighbor!** +**Encountered 2 tribe from the new island!** + +![Map turn 9](./map9.png "Map turn 9") + +No visits from neighbors. + +## Vesolsinmul +Meeting "Schnurrender Haufen Glück", a cat tribe. This is the faction that was in copy. So here are the 3 who seem to work together. +Halbe Linge brings out its first weapons but hasn't traded yet. +The region is guarded so no recruitment possible. +Hardcore to go (hc2g) has a potion, might be a mage. +No buildings. +Schnurrender Haufen Glück: I only see one unit, but it's a cat. Having no perception here, I don't see much. + +## Gogan Ror +Meeting a dwarf from "Odins Hammer" at the human's. + +## Rucebigil +Arrival in a new faction's region, "Apostel Belars" +The region is guarded so no recruitment possible and no entertainment from the ship. +The human has an ambassador there (or more?). +The Apostel Belars are only 14 visible, and with 1-person units. Could be the demon. In any case it looks like it. +Beltira (7v3o) has a potion, mage? + +## Sygirfal +Ahirom (4qmi) reaches level 2, Nora (4qmh) who fumbles (no money earned). +Mason level 0, need to reach T1 to start the tradepost. +A Forestry T2! +The boat will be finished this week and can leave. The Captain enters with an entertainer and leaves to explore the East. +We recruit a new rider, to transport stone to make a tradepost in a swamp. +And 10 entertainers. As I don't have much time to spend on my orders this week, I don't optimize and make a group of 10 + +## Exploration +The boats explore and map the islands. +To the north I will go to the glacier, to recover a dwarf. +Around my island, I want to avoid landing on a region, because I risk being attacked and having my boat stolen. So I sail offshore. + +## Diplomacy +- First contact with "Apostel Belars" +- First contact with "Odins Hammer": He is attacked by the insect and accepts my rescue proposal. He sends me a map of his island. +- Anbeter des Großen Baums: some regular exchanges to talk about this and that then the meeting. But this week he tells me about the presence of an elf and warns me against the insect living to the east. +- With the 3 tribes on my island: I defend myself, I'm not hiding. I tell them. On their side they acknowledge their mistake and apologize. I learn that together they are the "West Coast Party". I attempt to join their alliance. +But I must now be cautious, it might just be a ruse. \ No newline at end of file diff --git a/aquarians/diplomatie_1_9.md b/aquarians/diplomatie_1_9.md index 37ac352..9cbf398 100644 --- a/aquarians/diplomatie_1_9.md +++ b/aquarians/diplomatie_1_9.md @@ -1,6 +1,6 @@ --- title: "Aquarians: Exchanges turns 5 to 9" -date: 2024-04-15 +date: 2023-10-27 --- # DIPLOMACY LOG @@ -274,6 +274,9 @@ Zimrida, Pferdemensch und Großer Landvermesser **No response but 2 days later I received a threat message!** +--- +The whole turn is devoted to attempting to resolve the crisis with the eastern islanders. +Trolle and Ling. --- **From Halbe Linge, copied to Trolle, einige Steine tragend and Schnurrender Haufen Glück:** @@ -306,14 +309,14 @@ Ling Bonjour Ling, Nous sommes désolé de ne pas avoir répondu à votre message plus tôt -mes les messagers sont rares actuellement. +mais les messagers sont rares actuellement. Nous ne nous cachons pas de vous. Notre cavalier, Zimrida (hha6), n'est pas déguisé et ne se cache nullement. Nous n'avons pas d'autres ressortissants ailleurs en votre présence. Je pensais que votre proposition de dons de produits de luxe était une -inviation à venir dans votre belle region et j'ai donc dompté quelques +invitation à venir dans votre belle region et j'ai donc dompté quelques chevaux pour y répondre et me mettre à votre disposition. Il convient donc à votre guise de définir nos possibles relations futures. @@ -449,7 +452,11 @@ Ling --- ## TURN 9 - +--- +Through the following messages I try to work things out and strengthen relations with the WTC. +Theodor, Cat tribe and Ling. +On the other island, I met a dwarf, Odins Hammer, and a demon, Apostel Belars. +--- ### My Response to Ling **French:** @@ -624,8 +631,9 @@ Zimrida, Pferdemensch und Großer Landvermesser ``` --- +### Odins Hammer -### Encounter with Dwarf Tribe - Northern Island, Odins Hammer +#### Encounter with Dwarf Tribe - Northern Island, Odins Hammer **Our Message:** @@ -888,8 +896,9 @@ I can be on **Gogan Ror** in 2 weeks but it seems riskier. --- +### Apostel Belars -### Message 3 - Premier contact avec les Apostel Belars +#### Message 3 - Premier contact avec les Apostel Belars --- diff --git a/aquarians/introduction.md b/aquarians/introduction.md index 2b12e99..1979745 100644 --- a/aquarians/introduction.md +++ b/aquarians/introduction.md @@ -1,6 +1,6 @@ --- title: "Aquarians: Introduction" -date: 2024-03-10 +date: 2023-10-01 --- # Aquarian Tutorial - Introduction @@ -34,7 +34,7 @@ They must not give away their maps and their contacts - it's their currency of s Magic is powerful in the world of Eressea. -They have no penalty in magic, and the choice of their school is important. It will determine their ability to defend themselves quickly or their usefulness in an alliance long-term. +Aquarians have no penalty in magic, and the choice of their school is important. It will determine their ability to defend themselves quickly or their usefulness in an alliance long-term. The Gwyrrd school gives navigation advantages from level 4 and provides combat spells at level 3 (between 3 and 9 turns of Learn). diff --git a/aquarians/map6.png b/aquarians/map6.png new file mode 100644 index 0000000..cd74922 Binary files /dev/null and b/aquarians/map6.png differ diff --git a/aquarians/map7.png b/aquarians/map7.png new file mode 100644 index 0000000..e9aa077 Binary files /dev/null and b/aquarians/map7.png differ diff --git a/aquarians/map8.png b/aquarians/map8.png new file mode 100644 index 0000000..b24ff83 Binary files /dev/null and b/aquarians/map8.png differ diff --git a/aquarians/map9.png b/aquarians/map9.png new file mode 100644 index 0000000..40ee830 Binary files /dev/null and b/aquarians/map9.png differ diff --git a/howto/README.md b/howto/README.md new file mode 100644 index 0000000..c36b7bb --- /dev/null +++ b/howto/README.md @@ -0,0 +1,2 @@ +# Contribute to eressea/tutorial +Quick tutorial to explain how to submit your tuto notes diff --git a/howto/tuto1.png b/howto/tuto1.png new file mode 100644 index 0000000..6213450 Binary files /dev/null and b/howto/tuto1.png differ diff --git a/howto/tuto2.png b/howto/tuto2.png new file mode 100644 index 0000000..053d826 Binary files /dev/null and b/howto/tuto2.png differ diff --git a/howto/tuto3.png b/howto/tuto3.png new file mode 100644 index 0000000..b62b915 Binary files /dev/null and b/howto/tuto3.png differ diff --git a/howto/tuto4.png b/howto/tuto4.png new file mode 100644 index 0000000..5ff887d Binary files /dev/null and b/howto/tuto4.png differ diff --git a/howto/tuto5.png b/howto/tuto5.png new file mode 100644 index 0000000..90e5036 Binary files /dev/null and b/howto/tuto5.png differ diff --git a/howto/tuto_publication_de.md b/howto/tuto_publication_de.md new file mode 100644 index 0000000..197208a --- /dev/null +++ b/howto/tuto_publication_de.md @@ -0,0 +1,159 @@ +--- +title: "Tuto gh DE" +date: 2025-08-17 +--- +# Schnellanleitung zum Veröffentlichen Ihres „Tutorials" + +## 📋 Überblick + +Diese Anleitung führt Sie durch die Veröffentlichung Ihrer Spielberichte auf GitHub Pages in 4 Hauptschritten: + +1. **Vorbereiten** Ihrer Markdown-Dateien +2. **Erstellen** Ihres GitHub-Forks +3. **Hinzufügen** Ihrer Dateien +4. **Beitragen** zum Hauptprojekt + +--- + +## SCHRITT 1: Markdown-Dateien vorbereiten + +### 1.1 Ihre .md-Dateien erstellen + +- Bereiten Sie Ihre Dateien im `.md` (Markdown) Format vor +- Konsultieren Sie Online-Tutorials oder verwenden Sie Konverter +- **Benennung:** Verwenden Sie Namen ohne Leerzeichen (verwenden Sie `-` oder `_`) +- **Bilder:** Vermeiden Sie Dateiendungen in Großbuchstaben + +### 1.2 Den obligatorischen Header hinzufügen + +**⚠️ WICHTIG:** Fügen Sie diesen Block am Anfang jeder Datei ein: + +```yaml +--- +title: "Your_Race: Runde 1" +date: 2023-10-15 +--- +``` + +- Das **Datum** bestimmt die Anzeigereihenfolge auf Ihrer Seite +- Ich habe das Datum der Runden-Generierung eingesetzt. (also cr oder nr) +- Für Intro/Fazit: Passen Sie das Datum für die richtige Positionierung an + +### 1.3 Formatierungsregeln + +- **Zeilenumbruch:** mit `Leerzeichen+Leerzeichen+Return` enden +- **Titel:** verwenden Sie `#`, `##`, `###` +- **Bilder:** Format `![alt](./image.png "titel")` + +**Nützliche Ressourcen:** +- [Discord](https://discord.com/channels/509396702663278592/1193551778952781846/1404064429024346177) +- [Goblins Beispiel](https://eressea.github.io/tutorials/goblins/) + +--- + +## SCHRITT 2: Ihren GitHub-Fork erstellen + +### 2.1 Ein GitHub-Konto erstellen +Falls noch nicht geschehen: https://github.com + +### 2.2 Das Repository forken + +1. **Gehen Sie zu:** https://github.com/eressea/tutorials +2. **Klicken Sie auf:** „Fork"-Button (oben rechts) +3. **Wählen Sie:** Ihr persönliches Konto +4. **Warten Sie auf:** die Fork-Erstellung + +### 2.3 Ihren Fork konfigurieren + +**Allgemeine Konfiguration** + +![General](./tuto1.png "General") + +**GitHub Pages aktivieren** + +![GitHub Pages](./tuto2.png "GitHub Pages") + +**💡 Hinweis:** Für spätere Synchronisation → „Sync fork"-Button + +**⚠️ Berühren Sie nicht den gh-pages-Branch** Er dient zur Veröffentlichung Ihrer Seiten. + +--- + +## SCHRITT 3: Ihre Dateien hinzufügen + +### 3.1 GitHub Desktop installieren + +**Download:** https://desktop.github.com/download/ + +### 3.2 Erster Start + +1. **Authentifizierung:** über Ihren Browser +2. **Klonen:** Wählen Sie Ihr Repository +3. **Klicken Sie:** „Clone your_account/tutorials" +4. **Standardordner:** `C:\Users\\Documents\GitHub\tutorials` + +### 3.3 Ihre Dateien organisieren + +- **Erstellen Sie:** einen `your_race`-Ordner neben dem `goblins`-Ordner +- **Fügen Sie hinzu:** Ihre `.md`-Dateien in diesen Ordner + +### 3.4 Git-Workflow + +#### Änderungen ansehen +![Github Desktop 1](./tuto3.png "Github Desktop 1") + +#### Commit (speichern) +1. **Wählen Sie:** Dateien zum Committen aus +2. **Schreiben Sie:** kurze Beschreibung der Änderungen +3. **Klicken Sie:** „Commit * files to main" + +#### Push (senden) +![Push Request](./tuto4.png "Push Request") + +**Klicken Sie:** „Push origin" um zu GitHub zu senden + +--- + +## SCHRITT 4: Zum Projekt beitragen + +### 4.1 Ihre Arbeit überprüfen + +#### ✅ Ihre Seiten testen +1. **Gehen Sie zu:** Ihrer Website (Link in Settings → GitHub Pages) +2. **Überprüfen Sie:** die Seitenanzeige +3. **Bei Problemen:** auf Ihrem PC: ändern → commit → push +4. **⏱️ Geduld:** Update kann Zeit brauchen + +#### ✅ Ihren Fork synchronisieren +- **Überprüfen Sie:** ob Ihr Fork aktuell ist +- **Falls nötig:** verwenden Sie „Sync fork" + +### 4.2 Eine Pull Request erstellen + +#### Wenn alles bereit ist: +![Pull Request](./tuto5.png "Pull Request") + +1. **Gehen Sie zu:** „Pull Request" +2. **Klicken Sie:** „New Pull Request" +3. **Überprüfen Sie:** alles was vorgeschlagen wird +4. **Kommentieren Sie:** erklären Sie Ihre Änderungen +5. **Bestätigen Sie:** senden Sie die Anfrage + +#### 🎉 Ergebnis +Ihr Beitrag liegt nun in Ennos Händen zur Validierung! + +--- + +## 🚀 Zusammenfassung der Schritte + +| Schritt | Aktion | Tool | +|---------|--------|------| +| 1 | .md-Dateien vorbereiten | Texteditor | +| 2 | Fork + Konfiguration | GitHub Web | +| 3 | Dateien hinzufügen | GitHub Desktop | +| 4 | Pull Request | GitHub Web | + +## 📞 Hilfe benötigt? + +- Auf Discord: https://discord.com/channels/509396702663278592/1404841577402077332 +- GitHub-Dokumentation für Git-Details diff --git a/howto/tuto_publication_en.md b/howto/tuto_publication_en.md new file mode 100644 index 0000000..b1d1635 --- /dev/null +++ b/howto/tuto_publication_en.md @@ -0,0 +1,160 @@ +--- +title: "Tuto EN gh" +date: 2025-08-17 +--- + +# Quick Tutorial for Publishing Your "Tutorial" + +## 📋 Overview + +This tutorial guides you to publish your game reports on GitHub Pages in 4 main steps: + +1. **Prepare** your Markdown files +2. **Create** your GitHub fork +3. **Add** your files +4. **Contribute** to the main project + +--- + +## STEP 1: Prepare Markdown Files + +### 1.1 Create your .md files + +- Prepare your files in `.md` (Markdown) format +- Check online tutorials or use converters +- **Naming:** Use names without spaces (use `-` or `_`) +- **Images:** Avoid uppercase extensions + +### 1.2 Add the mandatory header + +**⚠️ IMPORTANT:** Insert this block at the beginning of each file: + +```yaml +--- +title: "Your_Race: Runde 1" +date: 2023-10-15 +--- +``` + +- The **date** determines the display order on your page +- Use cr date +- For intro/conclusion: adjust the date for proper positioning + +### 1.3 Formatting rules + +- **Line break:** end with `space+space+return` +- **Titles:** use `#`, `##`, `###` +- **Images:** format `![alt](./image.png "title")` + +**Useful resources:** +- [Discord](https://discord.com/channels/509396702663278592/1193551778952781846/1404064429024346177) +- [Goblins Example](https://eressea.github.io/tutorials/goblins/) + +--- + +## STEP 2: Create your GitHub fork + +### 2.1 Create a GitHub account +If not already done: https://github.com + +### 2.2 Fork the repository + +1. **Go to:** https://github.com/eressea/tutorials +2. **Click on:** "Fork" button (top right) +3. **Select:** your personal account +4. **Wait for:** fork creation + +### 2.3 Configure your fork + +**General Configuration** + +![General](./tuto1.png "General") + +**Enable GitHub Pages** + +![GitHub Pages](./tuto2.png "GitHub Pages") + +**💡 Note:** To synchronize later → "Sync fork" button + +**⚠️ Don't touch the gh-pages branch** It serves to publish your pages. + +--- + +## STEP 3: Add your files + +### 3.1 Install GitHub Desktop + +**Download:** https://desktop.github.com/download/ + +### 3.2 First launch + +1. **Authentication:** via your browser +2. **Clone:** select your repository +3. **Click:** "Clone your_account/tutorials" +4. **Default folder:** `C:\Users\\Documents\GitHub\tutorials` + +### 3.3 Organize your files + +- **Create:** a `your_race` folder next to the `goblins` folder +- **Add:** your `.md` files to this folder + +### 3.4 Git Workflow + +#### See modifications +![Github Desktop 1](./tuto3.png "Github Desktop 1") + +#### Commit (save) +1. **Select:** files to commit +2. **Write:** short description of changes +3. **Click:** "Commit * files to main" + +#### Push (send) +![Push Request](./tuto4.png "Push Request") + +**Click:** "Push origin" to send to GitHub + +--- + +## STEP 4: Contribute to the project + +### 4.1 Verify your work + +#### ✅ Test your pages +1. **Go to:** your site (link in Settings → GitHub Pages) +2. **Check:** page display +3. **If problem:** on your PC: modify → commit → push +4. **⏱️ Patience:** update may take time + +#### ✅ Synchronize your fork +- **Check:** if your fork is up to date +- **If necessary:** use "Sync fork" + +### 4.2 Create a Pull Request + +#### When everything is ready: +![Pull Request](./tuto5.png "Pull Request") + +1. **Go to:** "Pull Request" +2. **Click:** "New Pull Request" +3. **Review:** everything that will be proposed +4. **Comment:** explain your changes +5. **Validate:** send the request + +#### 🎉 Result +Your contribution is now in Enno's hands for validation! + +--- + +## 🚀 Steps Summary + +| Step | Action | Tool | +|------|--------|------| +| 1 | Prepare .md files | Text editor | +| 2 | Fork + config | GitHub web | +| 3 | Add files | GitHub Desktop | +| 4 | Pull Request | GitHub web | + +## 📞 Need help? + +- On Discord: https://discord.com/channels/509396702663278592/1404841577402077332 +- GitHub documentation for Git details diff --git a/howto/tuto_publication_fr.md b/howto/tuto_publication_fr.md new file mode 100644 index 0000000..dbf2336 --- /dev/null +++ b/howto/tuto_publication_fr.md @@ -0,0 +1,160 @@ +--- +title: "Tuto gh" +date: 2025-08-17 +--- +# Tuto rapide pour publier son "tuto" + +## 📋 Vue d'ensemble + +Ce tutoriel vous guide pour publier vos rapports de jeu sur GitHub Pages en 4 étapes principales : + +1. **Préparer** vos fichiers Markdown +2. **Créer** votre fork GitHub +3. **Ajouter** vos fichiers +4. **Contribuer** au projet principal + +--- + +## ÉTAPE 1 : Préparer les fichiers Markdown + +### 1.1 Créer vos fichiers .md + +- Préparez vos fichiers au format `.md` (Markdown) +- Consultez les tutoriels en ligne ou utilisez des convertisseurs +- **Nommage :** Utilisez des noms sans espaces (utilisez `-` ou `_`) +- **Images :** Évitez les extensions en majuscules + +### 1.2 Ajouter l'en-tête obligatoire + +**⚠️ IMPORTANT :** Insérez ce bloc au début de chaque fichier : + +```yaml +--- +title: "Your_Race: Runde 1" +date: 2023-10-15 +--- +``` + +- La **date** détermine l'ordre d'affichage sur votre page +- J'ai mis la date de génération du tour. (donc su cr ou nr) +- Pour intro/conclusion : ajustez la date pour le bon positionnement + +### 1.3 Règles de formatage + +- **Retour à la ligne :** finir par `space+space+return` +- **Titres :** utiliser `#`, `##`, `###` +- **Images :** format `![alt](./image.png "titre")` + +**Ressources utiles :** +- [Discord Enno](https://discord.com/channels/509396702663278592/1193551778952781846/1404064429024346177) +- [Exemple Goblins](https://eressea.github.io/tutorials/goblins/) + +--- + +## ÉTAPE 2 : Créer votre fork GitHub + +### 2.1 Créer un compte GitHub +Si ce n'est pas déjà fait : https://github.com + +### 2.2 Forker le repository + +1. **Aller sur :** https://github.com/eressea/tutorials +2. **Cliquer sur :** bouton "Fork" (en haut à droite) +3. **Sélectionner :** votre compte personnel +4. **Attendre :** la création du fork + +### 2.3 Configurer votre fork + +**Configuration Generale** + +![General](./tuto1.png "General") + +** Activer GitHub Pages** + +![GitHub Pages](./tuto2.png "GitHub Pages") + +**💡 Note :** Pour synchroniser plus tard → bouton "Sync fork" + +**⚠️ Ne touchez pas à la brache gh-pages** Elle sert à publier vos pages. + + +--- + +## ÉTAPE 3 : Ajouter vos fichiers + +### 3.1 Installer GitHub Desktop + +**Télécharger :** https://desktop.github.com/download/ + +### 3.2 Premier lancement + +1. **Authentification :** via votre navigateur +2. **Cloner :** sélectionner votre repository +3. **Cliquer :** "Clone votre_compte/tutorials" +4. **Dossier par défaut :** `C:\Users\\Documents\GitHub\tutorials` + +### 3.3 Organiser vos fichiers + +- **Créer :** un dossier `your_race` à côté du dossier `goblins` +- **Ajouter :** vos fichiers `.md` dans ce dossier + +### 3.4 Workflow Git + +#### Voir les modifications +![Github Desktop 1](./tuto3.png "Github Desktop 1") + +#### Commit (sauvegarder) +1. **Sélectionner :** les fichiers à commiter +2. **Écrire :** description courte des changements +3. **Cliquer :** "Commit * files to main" + +#### Push (envoyer) +![Push Request](./tuto4.png "Push Request") + +**Cliquer :** "Push origin" pour envoyer vers GitHub + +--- + +## ÉTAPE 4 : Contribuer au projet + +### 4.1 Vérifier votre travail + +#### ✅ Tester vos pages +1. **Aller sur :** votre site (lien dans Settings → GitHub Pages) +2. **Vérifier :** l'affichage des pages +3. **Si problème :** sur votre PC : modifier → commit → push +4. **⏱️ Patience :** la mise à jour peut prendre du temps + +#### ✅ Synchroniser votre fork +- **Vérifier :** si votre fork est à jour +- **Si nécessaire :** utiliser "Sync fork" + +### 4.2 Créer une Pull Request + +#### Quand tout est prêt : +![Pull Request](./tuto5.png "Pull Request") + +1. **Aller dans :** "Pull Request" +2. **Cliquer :** "New Pull Request" +3. **Réviser :** tout ce qui sera proposé +4. **Commenter :** expliquer vos changements +5. **Valider :** envoyer la demande + +#### 🎉 Résultat +Votre contribution est maintenant entre les mains d'Enno pour validation ! + +--- + +## 🚀 Résumé des étapes + +| Étape | Action | Outil | +|-------|--------|-------| +| 1 | Préparer fichiers .md | Éditeur texte | +| 2 | Fork + config | GitHub web | +| 3 | Ajouter fichiers | GitHub Desktop | +| 4 | Pull Request | GitHub web | + +## 📞 Besoin d'aide ? + +- Sur Discord : https://discord.com/channels/509396702663278592/1404841577402077332 +- Documentation GitHub pour les détails Git