From df7155c312570428b8e2414f4094e5f51a9040f5 Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Sun, 2 Jun 2024 18:23:25 +0000 Subject: [PATCH 01/12] Homepage layout proposal --- docs/index.md | 41 +++++++++++++++++++++++++++++++++++++---- mkdocs.yml | 1 + 2 files changed, 38 insertions(+), 4 deletions(-) diff --git a/docs/index.md b/docs/index.md index 4b658c490a..2784af6b58 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,12 +2,45 @@ This GitHub page is designed to contain community maintained set of articles, tutorials and documentation for everything Gothic. -First two Gothic games use engine called ZenGin, developed by Piranha Bytes and Mad Scientists. If you want to know more about the history of the development, there is a heap of information on the [Gothic Archive](https://gothicarchive.org/). +!!! Info + The content here is not meant to be taken as the holy word of modding. We are just modders sharing our experiences, knowledge and our favorite work flows. -The content here is not meant to be taken as the holy word of modding. We are just modders sharing our experiences, knowledge and our favorite work flows. +
-Feel free to open a pull request with your article or propose changes. +- :fontawesome-brands-discord:{ .lg .middle } __Discord Server__ -You can open a pull request in [this repository](https://github.com/Gothic-Modding-Community/gmc/) + --- + If you have any modding related questions, or just want to talk join our discord server. + [:octicons-arrow-right-24: Discord](https://discord.gg/mCpS5b5SUY) + + +- :octicons-git-pull-request-16:{ .lg .middle } __Contribution__ + + --- + + Feel free to open a pull request with your article or propose changes. Here is detailed contribution guide. + + [:octicons-arrow-right-24: How to Contibute](./contribute/index.md) + +- :material-file-document:{ .lg .middle } __Gothic Archive__ + + --- + + First two Gothic games use engine called ZenGin, developed by Piranha Bytes and Mad Scientists. If you want to know more about the history of the development, there is a heap of information on the Gothic Archive. + + [:octicons-arrow-right-24: Gothic Archive](https://gothicarchive.org/) + + + +- :fontawesome-brands-github:{ .lg .middle } __Repository__ + + --- + + This site has a public repo hosted on GitHub. + + [:octicons-arrow-right-24: GitHub](https://github.com/Silver-Ore-Team/zBassMusic) + + +
diff --git a/mkdocs.yml b/mkdocs.yml index 7e128b1299..6704dfcfa1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -110,6 +110,7 @@ markdown_extensions: - name: mermaid class: mermaid format: !!python/name:pymdownx.superfences.fence_code_format + - md_in_html plugins: - search From a676cb05d55d3fe4239a85aad7213fbfe0b81284 Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Mon, 3 Jun 2024 16:36:52 +0200 Subject: [PATCH 02/12] Fix: Change repository link to gmc --- docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index 2784af6b58..7df458414f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -40,7 +40,7 @@ This GitHub page is designed to contain community maintained set of articles, tu This site has a public repo hosted on GitHub. - [:octicons-arrow-right-24: GitHub](https://github.com/Silver-Ore-Team/zBassMusic) + [:octicons-arrow-right-24: GitHub](https://github.com/Gothic-Modding-Community/gmc/) From 3d0e1bf2f89b0fafe367abe04b176b0f67e7a2f3 Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Mon, 3 Jun 2024 17:15:44 +0200 Subject: [PATCH 03/12] Change text in Repository grid card --- docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index 7df458414f..8ceb462dab 100644 --- a/docs/index.md +++ b/docs/index.md @@ -38,7 +38,7 @@ This GitHub page is designed to contain community maintained set of articles, tu --- - This site has a public repo hosted on GitHub. + Check out our GitHub repository for the site's source code and updates. [:octicons-arrow-right-24: GitHub](https://github.com/Gothic-Modding-Community/gmc/) From 17ce28d2f8ee8db873c722b3580547d253a202cc Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Mon, 3 Jun 2024 18:22:49 +0200 Subject: [PATCH 04/12] Zengin index concept --- docs/zengin/index.md | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/docs/zengin/index.md b/docs/zengin/index.md index 8f80873c2c..1b0635072a 100644 --- a/docs/zengin/index.md +++ b/docs/zengin/index.md @@ -1,3 +1,41 @@ # ZenGin -The game engine **ZenGin** is used by Gothic 1 and 2. This section contains the documentation of the various aspects of ZenGin modding. \ No newline at end of file +The game engine **ZenGin** is used by Gothic 1 and 2. This section contains the documentation of the various aspects of ZenGin modding. + +
+ +- :material-code-braces:{ .lg .middle } __Script Reference__ + + --- + + ZenGin uses its own scripting language called Daedalus. Check its functions, classes and extenders. + + [:octicons-arrow-right-24: Scripts](./scripts/index.md) + + +- :fontawesome-solid-cube:{ .lg .middle } __Vob Classes__ + + --- + + Virtual objects are objects which appear in the game world. + + [:octicons-arrow-right-24: zCVob](./worlds/Classes/zCVob/index.md) + + +- :fontawesome-solid-person-walking-arrow-loop-left:{ .lg .middle } __Animations Section__ + + --- + + Create new animations and put them into the game. + + [:octicons-arrow-right-24: Animations](./anims/index.md) + + +- :material-code-block-tags:{ .lg .middle } __Union SDK__ + + --- + + Learn how to create plugins with Union SDK, a community software development kit for ZenGin. + + [:octicons-arrow-right-24: Getting Started](./union/sdk/getting_started.md) +
\ No newline at end of file From 327c9036346b610f24d7e08ab20c6e39c31b9a8e Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Thu, 6 Jun 2024 20:33:26 +0200 Subject: [PATCH 05/12] Fix links --- docs/zengin/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/zengin/index.md b/docs/zengin/index.md index 1b0635072a..a858ee185d 100644 --- a/docs/zengin/index.md +++ b/docs/zengin/index.md @@ -10,7 +10,7 @@ The game engine **ZenGin** is used by Gothic 1 and 2. This section contains the ZenGin uses its own scripting language called Daedalus. Check its functions, classes and extenders. - [:octicons-arrow-right-24: Scripts](./scripts/index.md) + [:octicons-arrow-right-24: Scripts](scripts/index.md) - :fontawesome-solid-cube:{ .lg .middle } __Vob Classes__ @@ -19,7 +19,7 @@ The game engine **ZenGin** is used by Gothic 1 and 2. This section contains the Virtual objects are objects which appear in the game world. - [:octicons-arrow-right-24: zCVob](./worlds/Classes/zCVob/index.md) + [:octicons-arrow-right-24: zCVob](worlds/Classes/zCVob/index.md) - :fontawesome-solid-person-walking-arrow-loop-left:{ .lg .middle } __Animations Section__ @@ -28,7 +28,7 @@ The game engine **ZenGin** is used by Gothic 1 and 2. This section contains the Create new animations and put them into the game. - [:octicons-arrow-right-24: Animations](./anims/index.md) + [:octicons-arrow-right-24: Animations](anims/index.md) - :material-code-block-tags:{ .lg .middle } __Union SDK__ @@ -37,5 +37,5 @@ The game engine **ZenGin** is used by Gothic 1 and 2. This section contains the Learn how to create plugins with Union SDK, a community software development kit for ZenGin. - [:octicons-arrow-right-24: Getting Started](./union/sdk/getting_started.md) + [:octicons-arrow-right-24: Getting Started](union/sdk/getting_started.md) \ No newline at end of file From e8d2e9c719f4eebc0836ff40cc97e7eb85cc79fc Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Fri, 7 Jun 2024 18:28:20 +0200 Subject: [PATCH 06/12] Fix the position of links in grid cards --- overrides/assets/stylesheets/extra.css | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/overrides/assets/stylesheets/extra.css b/overrides/assets/stylesheets/extra.css index b9d96766c9..1b70094c58 100644 --- a/overrides/assets/stylesheets/extra.css +++ b/overrides/assets/stylesheets/extra.css @@ -17,6 +17,21 @@ } } +/* Fix position of the links in grid cards */ +.md-typeset .grid.cards > ul > li { + display: flex; + flex-direction: column; + /* outline: 1px solid green; */ + } + .grid.cards li p:last-child { + display: flex; + flex-grow: 5; /* Probably 2 would be enough, as the grids shouldn't hold too much text to begin with, but to be safe I set it to 5 */ + /* outline: 1px solid red; */ + } + .grid.cards li p:last-child a { + align-self: flex-end; + } + /* Stretch content area */ .md-main__inner.md-grid { /* Default 61rem */ From 23215d18f95270891df3a0dc13558ffa4e7e816e Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Fri, 7 Jun 2024 18:29:56 +0200 Subject: [PATCH 07/12] Change the link in index and spelling mistake in zengin/index --- docs/index.md | 2 +- docs/zengin/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/index.md b/docs/index.md index 8ceb462dab..e74e841f18 100644 --- a/docs/index.md +++ b/docs/index.md @@ -22,7 +22,7 @@ This GitHub page is designed to contain community maintained set of articles, tu Feel free to open a pull request with your article or propose changes. Here is detailed contribution guide. - [:octicons-arrow-right-24: How to Contibute](./contribute/index.md) + [:octicons-arrow-right-24: How to Contibute](contribute/index.md) - :material-file-document:{ .lg .middle } __Gothic Archive__ diff --git a/docs/zengin/index.md b/docs/zengin/index.md index a858ee185d..69734feb16 100644 --- a/docs/zengin/index.md +++ b/docs/zengin/index.md @@ -35,7 +35,7 @@ The game engine **ZenGin** is used by Gothic 1 and 2. This section contains the --- - Learn how to create plugins with Union SDK, a community software development kit for ZenGin. + Learn how to create plugins with Union SDK, a community-made software development kit for ZenGin. [:octicons-arrow-right-24: Getting Started](union/sdk/getting_started.md) \ No newline at end of file From f346dad68e91c802381237354fedde7ef10cbf08 Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Fri, 7 Jun 2024 18:42:15 +0200 Subject: [PATCH 08/12] Polish translation for zengin/index.md --- docs/zengin/index.pl.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/docs/zengin/index.pl.md b/docs/zengin/index.pl.md index 2f7f97bb16..401ad6f1fb 100644 --- a/docs/zengin/index.pl.md +++ b/docs/zengin/index.pl.md @@ -1,3 +1,41 @@ # ZenGin Silnik gry **ZenGin** jest używany w grach Gothic 1 i 2. Ta sekcja zawiera dokumentację różnych aspektów modowania ZenGin. + +
+ +- :material-code-braces:{ .lg .middle } __Skrypty Gothica__ + + --- + + ZenGin używa własnego języka skryptowego o nazwie Daedalus. Sprawdź jego funkcje, klasy i extendery. + + [:octicons-arrow-right-24: Scripts](scripts/index.md) + + +- :fontawesome-solid-cube:{ .lg .middle } __Klasy Vob__ + + --- + + Voby (eng. virtual objects) to obiekty pojawiające sie w świecie gry. + + [:octicons-arrow-right-24: zCVob](worlds/Classes/zCVob/index.md) + + +- :fontawesome-solid-person-walking-arrow-loop-left:{ .lg .middle } __Sekcja Animacji__ + + --- + + Twórz nowe animacje i umieszczaj je w grze. + + [:octicons-arrow-right-24: Animations](anims/index.md) + + +- :material-code-block-tags:{ .lg .middle } __Union SDK__ + + --- + + Naucz się jak tworzyć pluginy za pomocą Union SDK, stworzonego przez fanów narzędzia deweloperskiego dla silnika ZenGin. + + [:octicons-arrow-right-24: Getting Started](union/sdk/getting_started.md) +
\ No newline at end of file From 92443e2bfe9021f392b7b3b1df834db83fd4fd2b Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Fri, 7 Jun 2024 18:47:06 +0200 Subject: [PATCH 09/12] Fix grid cards css --- overrides/assets/stylesheets/extra.css | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/overrides/assets/stylesheets/extra.css b/overrides/assets/stylesheets/extra.css index 1b70094c58..cf2a7831b2 100644 --- a/overrides/assets/stylesheets/extra.css +++ b/overrides/assets/stylesheets/extra.css @@ -21,16 +21,17 @@ .md-typeset .grid.cards > ul > li { display: flex; flex-direction: column; - /* outline: 1px solid green; */ - } - .grid.cards li p:last-child { +} +.grid.cards li p:last-child { display: flex; flex-grow: 5; /* Probably 2 would be enough, as the grids shouldn't hold too much text to begin with, but to be safe I set it to 5 */ - /* outline: 1px solid red; */ - } - .grid.cards li p:last-child a { +} +.grid.cards li p:last-child a { align-self: flex-end; - } +} +.grid.cards li > p:first-child > strong { + vertical-align: middle; +} /* Stretch content area */ .md-main__inner.md-grid { From 3eb13f008863d9f2af2b0ac5bf70464119ddf640 Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Fri, 7 Jun 2024 18:55:18 +0200 Subject: [PATCH 10/12] Fix tranlsation of zengin/index --- docs/zengin/index.pl.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/zengin/index.pl.md b/docs/zengin/index.pl.md index 401ad6f1fb..8bef1bcd92 100644 --- a/docs/zengin/index.pl.md +++ b/docs/zengin/index.pl.md @@ -28,7 +28,7 @@ Silnik gry **ZenGin** jest używany w grach Gothic 1 i 2. Ta sekcja zawiera doku Twórz nowe animacje i umieszczaj je w grze. - [:octicons-arrow-right-24: Animations](anims/index.md) + [:octicons-arrow-right-24: Animacje](anims/index.md) - :material-code-block-tags:{ .lg .middle } __Union SDK__ @@ -37,5 +37,5 @@ Silnik gry **ZenGin** jest używany w grach Gothic 1 i 2. Ta sekcja zawiera doku Naucz się jak tworzyć pluginy za pomocą Union SDK, stworzonego przez fanów narzędzia deweloperskiego dla silnika ZenGin. - [:octicons-arrow-right-24: Getting Started](union/sdk/getting_started.md) + [:octicons-arrow-right-24: Pierwsze kroki](union/sdk/getting_started.md) \ No newline at end of file From a2df82870321e6ce5424b466503a7b5f8cb7a0ca Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Fri, 7 Jun 2024 19:01:59 +0200 Subject: [PATCH 11/12] Polish tranlsation of the main index.md --- docs/index.pl.md | 42 ++++++++++++++++++++++++++++++++++++++---- 1 file changed, 38 insertions(+), 4 deletions(-) diff --git a/docs/index.pl.md b/docs/index.pl.md index c992fc580e..1dcc23923a 100644 --- a/docs/index.pl.md +++ b/docs/index.pl.md @@ -2,12 +2,46 @@ Ta strona GitHub jest zaprojektowana w celu zawarcia zbioru artykułów, poradników oraz innej dokumentacji o Gothicu utrzymywanych przez społeczność. -Dwie pierwsze części gier Gothic korzystają z silnika o nazwie ZenGin, stworzonego przez Piranha Bytes oraz grupę programistów o nazwie Mad Scientists. Jeżeli chcesz wiedzieć więcej o historii tworzenia, to jest masa informacji na [Gothic Archive](https://gothicarchive.org/). +!!! Info "Informacja" + Zawartość strony nie jest przeznaczona, aby być uznaną za święte słowa moddingu. Jesteśmy tylko modderami dzielącymi się doświadczeniami, wiedzą oraz naszym ulubionym tokiem pracy. -Zawartość strony nie jest przeznaczona, aby być uznaną za święte słowa moddingu. Jesteśmy tylko modderami dzielącymi się doświadczeniami, wiedzą oraz naszym ulubionym tokiem pracy. +
-Nie krępuj się, aby otworzyć prośbę o połączenie (ang. pull request) z twoim artykułem, lub z propozycją zmian. Po więcej informacji jak to zrobić zobacz, [Jak Się Udzielić](contribute/index.md). +- :fontawesome-brands-discord:{ .lg .middle } __Serwer Discord__ -Możesz otworzyć prośbę o połączenie względem [tego repozytorium](https://github.com/Gothic-Modding-Community/gmc/). + --- + Jeśli masz jakieś pytania związane z modowaniem lub po prostu chcesz porozmawiać, dołącz do naszego serwera Discord. + + [:octicons-arrow-right-24: Discord](https://discord.gg/mCpS5b5SUY) + + +- :octicons-git-pull-request-16:{ .lg .middle } __Udzielanie się__ + + --- + + Nie krępuj się, aby otworzyć prośbę o połączenie (ang. pull request) z twoim artykułem, lub z propozycją zmian. Tutaj znajdziesz pełną instrukcje jak to zrobić. + + [:octicons-arrow-right-24: Jak Się Udzielić](contribute/index.md) + +- :material-file-document:{ .lg .middle } __Gothic Archive__ + + --- + + Dwie pierwsze części gier Gothic korzystają z silnika o nazwie ZenGin, stworzonego przez Piranha Bytes oraz grupę programistów o nazwie Mad Scientists. Jeżeli chcesz wiedzieć więcej o historii tworzenia, to jest masa informacji na Gothic Archive. + + [:octicons-arrow-right-24: Gothic Archive](https://gothicarchive.org/) + + + +- :fontawesome-brands-github:{ .lg .middle } __Repozytorium__ + + --- + + Sprawdź nasze repozytorium GitHub, aby uzyskać kod źródłowy strony i informacje o aktualizacjach. + + [:octicons-arrow-right-24: GitHub](https://github.com/Gothic-Modding-Community/gmc/) + + +
From 913f3e23a009fcce06fc46a5d136e951120efa54 Mon Sep 17 00:00:00 2001 From: Mateusz Uczciwek Date: Fri, 7 Jun 2024 21:56:08 +0200 Subject: [PATCH 12/12] Fix english name in zengin/index translation --- docs/zengin/index.pl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zengin/index.pl.md b/docs/zengin/index.pl.md index 8bef1bcd92..56227e0dfd 100644 --- a/docs/zengin/index.pl.md +++ b/docs/zengin/index.pl.md @@ -10,7 +10,7 @@ Silnik gry **ZenGin** jest używany w grach Gothic 1 i 2. Ta sekcja zawiera doku ZenGin używa własnego języka skryptowego o nazwie Daedalus. Sprawdź jego funkcje, klasy i extendery. - [:octicons-arrow-right-24: Scripts](scripts/index.md) + [:octicons-arrow-right-24: Skrypty](scripts/index.md) - :fontawesome-solid-cube:{ .lg .middle } __Klasy Vob__