improvement: add basic website.

.gitignore

@@ -1,2 +1,4 @@
 target
 .DS_Store
+outrun-site/public
+public

.gitlab-ci.yml

@@ -10,9 +10,11 @@ build:
     key: "$CI_JOB_NAME"
     paths:
       - $HOME/.cargo
+      - target/
   artifacts:
     paths:
       - $HOME/.cargo
+      - target/
     expire_in: 60 mins
   script:
     - cargo test --no-run --release
@@ -43,3 +45,18 @@ cargo clippy:
 #     - branches
 #   script:
 #     - cargo publish --token $CARGO_TOKEN
+
+pages:
+  stage: release
+  image: docker:stable
+  variables:
+    GIT_SUBMODULE_STRATEGY: recursive
+  services:
+    - docker:dind
+  script:
+    - docker run -u "$(id -u):$(id -g)" -v $PWD:/app --workdir /app ghcr.io/getzola/zola:v0.16.0 --root outrun-site/ build --output-dir public
+  artifacts:
+    paths:
+      - public
+  rules:
+    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "outrun-site/themes/adidoks"]
+	path = outrun-site/themes/adidoks
+	url = https://github.com/aaranxu/adidoks.git

outrun-site/config.toml

@@ -0,0 +1,129 @@
+# Put all your custom variables here
+# The URL the site will be built for
+base_url = "https://outrun.rocks"
+description = "The most retro-futuristic language in the world"
+title = "Outrun"
+
+# The site theme to use.
+theme = "adidoks"
+
+# The default language; used in feeds and search index
+# Note: the search index doesn't support Chinese/Japanese/Korean Languages
+default_language = "en"
+
+# Whether to automatically compile all Sass files in the sass directory
+compile_sass = true
+
+# Whether to generate a feed file for the site
+generate_feed = true
+
+# When set to "true", the generated HTML files are minified.
+minify_html = false
+
+# The taxonomies to be rendered for the site and their configuration.
+taxonomies = [
+  {name = "authors"}, # Basic definition: no feed or pagination
+]
+
+# Whether to build a search index to be used later on by a JavaScript library
+# When set to "true", a search index is built from the pages and section
+# content for `default_language`.
+build_search_index = true
+
+[search]
+# Whether to include the title of the page/section in the index
+include_title = true
+# Whether to include the description of the page/section in the index
+include_description = false
+# Whether to include the rendered content of the page/section in the index
+include_content = true
+
+[markdown]
+# Whether to do syntax highlighting.
+# Theme can be customised by setting the `highlight_theme`
+# variable to a theme supported by Zola
+highlight_code = true
+
+[extra]
+# Put all your custom variables here
+author = "James Harton"
+email = "james@harton.nz"
+github = "https://github.com/jimsynz"
+
+# If running on netlify.app site, set to true
+is_netlify = false
+
+# Set HTML file language
+language_code = "en-NZ"
+
+# Set theme-color meta tag for Chrome browser
+theme_color = "#fff"
+
+# More about site's title
+title_addition = "Outrun" 
+title_separator = "|" # set as |, -, _, etc
+
+# Set date format in blog publish metadata
+timeformat = "%B %e, %Y" # e.g. June 14, 2021
+timezone = "Pacific/Auckland" 
+
+# Edit page on reposity or not
+docs_repo = "https://gitlab.com/jimsy/outrun"
+edit_page = true
+repo_branch = "main"
+
+## Math settings
+# options: true, false. Enable math support globally,
+# default: false. You can always enable math on a per page.
+library = "katex" # options: "katex", "mathjax". default is "katex".
+math = false 
+
+## Open Graph + Twitter Cards
+[extra.open]
+enable = false
+# this image will be used as fallback if a page has no image of its own
+image = "doks.png"
+og_locale = "en_NZ"
+
+## JSON-LD
+[extra.schema]
+github = "https://github.com/jimsynz" 
+logo = "logo-doks.png" 
+section = "blog" # see config.extra.main~url
+type = "Organization" 
+## Sitelinks Search Box
+site_links_search_box = false
+
+# Menu items
+[[extra.menu.main]]
+name = "Docs"
+section = "docs"
+url = "/docs/getting-started/introduction/"
+weight = 10
+
+[[extra.menu.main]]
+name = "Blog"
+section = "blog"
+url = "/blog/"
+weight = 20
+
+[[extra.menu.social]]
+name = "GitLab"
+post = "v0.1.0"
+pre = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-gitlab"><path d="M22.65 14.39L12 22.13 1.35 14.39a.84.84 0 0 1-.3-.94l1.22-3.78 2.44-7.51A.42.42 0 0 1 4.82 2a.43.43 0 0 1 .58 0 .42.42 0 0 1 .11.18l2.44 7.49h8.1l2.44-7.51A.42.42 0 0 1 18.6 2a.43.43 0 0 1 .58 0 .42.42 0 0 1 .11.18l2.44 7.51L23 13.45a.84.84 0 0 1-.35.94z"></path></svg>'
+url = "https://gitlab.com/jimsy/outrun"
+weight = 20
+
+# Footer contents
+[extra.footer]
+info = 'Powered by <a href="https://www.getzola.org/">Zola</a> and <a href="https://github.com/aaranxu/adidoks">AdiDoks</a>'
+
+[[extra.footer.nav]]
+name = "Privacy"
+url = "/privacy-policy/"
+weight = 10
+
+[[extra.footer.nav]]
+name = "Code of Conduct"
+url = "/docs/contributing/code-of-conduct/"
+weight = 20

outrun-site/content/_index.md

@@ -0,0 +1,23 @@
++++
+title = "Outrun"
+
+[extra]
+lead = 'The most retro-futuristic programming language on the planet'
+url = '/docs/get-started'
+url_button = 'Get Started'
+
+repo_license='HL3-FULL'
+repo_url='https://gitlab.com/jimsy/outrun'
+repo_version='v0.1.0'
+
+[[extra.menu.main]]
+name = 'Docs'
+section = 'docs'
+url = 'docs/get-started'
+weight = 10
+
+[[extra.list]]
+title = "Made out of crabs"
+content = 'Built out of 100% <a href="https://www.rust-lang.org/">Rusty</a> goodness.'
+
++++

outrun-site/content/docs/_index.md

@@ -0,0 +1,2 @@
++++
++++

outrun-site/content/docs/get-started/_index.md

@@ -0,0 +1,10 @@
++++
+title = "Getting Started"
+description = "Quickstart guide for installing and using Outrun"
+date = 2025-05-01T08:00:00+00:00
+updated = 2021-05-01T08:00:00+00:00
+template = "docs/section.html"
+sort_by = "weight"
+weight = 1
+draft = false
++++

outrun-site/content/docs/get-started/introduction.md

@@ -0,0 +1,14 @@
++++
+title = "Introduction"
+description = "What is this thing?"
+updated = 2021-05-01T08:00:00+00:00
+draft = false
+weight = 10
+sort_by = "weight"
+template = "docs/page.html"
+
+[extra]
+lead = 'What is this thing?'
+toc = true
+top = false
++++

outrun-site/templates/_variables.html

@@ -0,0 +1,50 @@
+<style>
+     :root {
+        /* Primary theme color */
+        --primary-color: #262335;
+        /* Primary theme text color */
+        --primary-text-color: #ffffff;
+        /* Primary theme link color */
+        --primary-link-color: #fede5d;
+        /* Secondary color: the background body color */
+        --secondary-color: #72f1b8;
+        --secondary-text-color: #03edf9;
+        /* Highlight text color of table of content */
+        --toc-highlight-text-color: #2ee2fa;
+    }
+</style>
+
+
+<!---
+
+  activeColorSet=dark
+  colors.light.shade0=#ffffff
+  colors.light.shade7=#232530
+  colors.light.accent5=#2EE2FA
+  colors.light.accent0=#fe4450
+  colors.light.accent2=#f97e72
+  colors.light.accent3=#72f1b8
+  colors.light.accent4=#03edf9
+  colors.light.accent7=#ff7edb
+  colors.light.accent1=#232530
+  colors.light.accent6=#fede5d
+  colors.dark.accent0=#fe4450
+  colors.dark.shade0=#262335
+  colors.dark.shade7=#ffffff
+  colors.dark.accent1=#848bbd
+  colors.dark.accent2=#fede5d
+  colors.dark.accent3=#72f1b8
+  colors.dark.accent4=#03edf9
+  colors.dark.accent5=#2ee2fa
+  colors.dark.accent6=#f97e72
+  colors.dark.accent7=#ff7edb
+  colors.dark.shade1=#495495
+  colors.dark.shade2=#b893ce99
+  colors.dark.shade3=#463465
+  colors.dark.shade4=#ffffff
+  colors.dark.shade5=#ff7edb
+  colors.dark.shade6=#A148AB80
+  calculateIntermediaryShades.dark=false
+  calculateIntermediaryShades.light=false
+
+-->

outrun-site/themes/adidoks

@@ -0,0 +1 @@
+Subproject commit 5c698271c460046034605b743a15196b12e32887