first commit

.github/workflows/ci.yml

@@ -0,0 +1,14 @@
+name: Deploy Wiki
+on:
+  push:
+    branches: [main]
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force

.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml

.idea/codeStyles/Project.xml

@@ -0,0 +1,7 @@
+<component name="ProjectCodeStyleConfiguration">
+  <code_scheme name="Project" version="173">
+    <ScalaCodeStyleSettings>
+      <option name="MULTILINE_STRING_CLOSING_QUOTES_ON_NEW_LINE" value="true" />
+    </ScalaCodeStyleSettings>
+  </code_scheme>
+</component>

.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default" />
+  </state>
+</component>

.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_X" default="true" project-jdk-name="openjdk-23" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/wiki.iml" filepath="$PROJECT_DIR$/.idea/wiki.iml" />
+    </modules>
+  </component>
+</project>

.idea/wiki.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

docs/about.md

@@ -0,0 +1 @@
+# about page

docs/index.md

@@ -0,0 +1 @@
+# index page

docs/javascripts/extra.js

@@ -0,0 +1,35 @@
+document.addEventListener("DOMContentLoaded", function() {
+  // Sync with Material's native storage key
+  const STORAGE_KEY = "md-color-scheme";
+
+  // Get initial theme state
+  const savedTheme = localStorage.getItem(STORAGE_KEY) || "default";
+  document.body.setAttribute("data-md-color-scheme", savedTheme);
+
+  // Watch for theme changes
+  const mutationObserver = new MutationObserver(mutations => {
+    mutations.forEach(mutation => {
+      if (mutation.attributeName === "data-md-color-scheme") {
+        const currentTheme = document.body.getAttribute("data-md-color-scheme");
+        localStorage.setItem(STORAGE_KEY, currentTheme);
+      }
+    });
+  });
+
+  // Start observing body attributes
+  mutationObserver.observe(document.body, {
+    attributes: true,
+    attributeFilter: ["data-md-color-scheme"]
+  });
+
+  // Debounced click handler
+  let isToggling = false;
+  document.querySelector(".md-header__button[data-md-color-scheme]").addEventListener("click", () => {
+    if (!isToggling) {
+      isToggling = true;
+      setTimeout(() => {
+        isToggling = false;
+      }, 300);
+    }
+  });
+});

docs/pages/A3D-Versions/2-0.md

@@ -0,0 +1 @@
+# hello 2

docs/pages/A3D-Versions/5.0.md

@@ -0,0 +1 @@
+# hello 5

docs/pages/A3D-Versions/6.0.md

@@ -0,0 +1 @@
+# hello 6

docs/pages/A3D-Versions/7.0.md

@@ -0,0 +1 @@
+# hello 7

docs/pages/A3D-Versions/7.0v2.md

@@ -0,0 +1 @@
+# hello 7v2

docs/pages/A3D-Versions/8.0.md

@@ -0,0 +1 @@
+# hello 8

docs/stylesheets/extra.css

@@ -0,0 +1,26 @@
+:root {
+  --md-primary-fg-color:        #2B579A;
+  --md-primary-fg-color--light: #7BAFD4;
+  --md-primary-fg-color--dark:  #1A365F;
+}
+
+.md-header {
+  box-shadow: 0 0 0.2rem rgba(0,0,0,.1), 0 0.2rem 0.4rem rgba(0,0,0,.2);
+}
+
+.md-tabs {
+  background-color: var(--md-primary-fg-color);
+}
+
+.md-search__form:hover {
+  background-color: rgba(255,255,255,0.1);
+}
+
+.md-typeset h1 {
+  font-weight: 600;
+  color: var(--md-primary-fg-color);
+}
+
+.md-footer {
+  margin-top: 2em;
+}

mkdocs.yml

@@ -0,0 +1,59 @@
+site_name: MapMakers Wiki
+site_url: https://mapmakersandprogrammers.github.io/wiki/
+
+theme:
+  logo: resources/icon.webp
+  name: material
+  features:
+    - navigation.tabs
+    - navigation.top
+    - search.highlight
+    - search.suggest
+    - toc.integrate
+  palette:
+    - scheme: default
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      toggle:
+        icon: material/brightness-2
+        name: Switch to light mode
+  font:
+    text: Roboto
+    code: Roboto Mono
+
+extra:
+  favicon: resources/icon.ico
+
+extra_css:
+  - stylesheets/extra.css
+
+extra_javascript:
+  - javascripts/extra.js
+
+plugins:
+  - search
+
+markdown_extensions:
+  - toc:
+      permalink: true
+  - pymdownx.highlight
+  - pymdownx.superfences
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+
+nav:
+  - Home: index.md
+  - Alternativa3D:
+      - Versions:
+          - 2.0: pages/A3D-Versions/2-0.md
+          - 5.0: pages/A3D-Versions/5.0.md
+          - 6.0: pages/A3D-Versions/6.0.md
+          - 7.0: pages/A3D-Versions/7.0.md
+          - 7.0v2: pages/A3D-Versions/7.0v2.md
+          - 8.0: pages/A3D-Versions/8.0.md
+      - something else:
+          - something else sub : idk/idk.md
+  - About: about.md

readme.md

@@ -0,0 +1,23 @@
+
+
+## How to add pages:
+
+1. Create .md file in /docs/.... (e.g., docs/tanki2.0/page1.md)
+
+
+2. Add to nav: in mkdocs.yml:
+<pre>
+nav:
+- New Section:
+    - New Page: path to page1.md
+</pre>
+Directory Structure:
+<pre>
+docs/  
+├─ section-name (doesnt have to be the same as the nav name)/  
+│  ├─ page1.md  
+│  └─ page2.md  
+</pre>
+
+### Order in nav: = menu order.
+### In nav you can create anything you want with any name you want. the only thing that matters is the final md page path, if the folders and the nav names dont match up that doesnt matter. Only the md directory should match