Added Temporary Docs

.gitattributes

@@ -1,2 +1,2 @@
 # Auto detect text files and perform LF normalization
-* text=auto
+* text=auto

.github/workflows/ci.yml

@@ -0,0 +1,114 @@
+
+name: CI
+on: [push, pull_request]
+
+permissions:
+  actions: write
+  checks: write
+  contents: write
+  deployments: write
+  id-token: write
+  issues: write
+  discussions: write
+  packages: write
+  pages: write
+  pull-requests: write
+  repository-projects: write
+  security-events: write
+  statuses: write
+
+jobs:
+  linter:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        path: lilia
+
+    - uses: leafo/[email protected]
+      with:
+        luaVersion: "5.2"
+
+    - uses: leafo/[email protected]
+
+    - name: Pull gluacheck
+      uses: actions/checkout@v2
+      with:
+        repository: impulsh/gluacheck
+        path: luacheck
+
+    - name: Build gluacheck
+      working-directory: luacheck
+      run: luarocks make
+
+    - name: Lint
+      working-directory: lilia
+      run: luacheck . --no-redefined
+          --no-global --no-self
+          --no-max-line-length --no-max-code-line-length
+          --no-max-string-line-length --no-max-comment-line-length
+          --no-max-cyclomatic-complexity
+
+  docs:
+    runs-on: ubuntu-latest
+    needs: linter
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          path: lilia
+
+      - uses: leafo/[email protected]
+        with:
+          luaVersion: "5.2"
+
+      - uses: leafo/[email protected]
+
+      - name: Pull LDoc
+        uses: actions/checkout@v2
+        with:
+          repository: bleonheart/LDoc
+          path: ldoc
+
+      - name: Build LDoc
+        working-directory: ldoc
+        run: luarocks make
+
+      - name: Build docs
+        working-directory: lilia
+        run: ldoc . --fatalwarnings 
+
+      - name: Copy assets
+        working-directory: lilia
+        run: |
+          cp -v docs/css/* docs/html
+          cp -v docs/js/* docs/html
+
+      - name: Deploy
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main' && github.repository == 'LiliaFramework/Lilia' && success()
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: lilia/docs/html
+
+  sync:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main' && github.repository == 'LiliaFramework/Lilia' && success()
+    runs-on: ubuntu-latest
+    needs: docs
+    steps:
+      - name: Checkout source repository
+        uses: actions/checkout@v2
+      - name: Push to destination repository
+        run: |
+          git config --global user.email "[email protected]"
+          git config --global user.name "Github Actions"
+          git clone https://${{ env.ORG_NAME }}:${{ secrets.LiliaGitSecret }}@github.com/${{ env.ORG_NAME }}/LiliaFramework.github.io.git liliagit
+          cd liliagit
+          git remote add ${{ env.ORIGINAL_REPO_NAME }} https://${{ env.ORG_NAME }}:${{ secrets.LiliaGitSecret }}@github.com/${{ env.ORG_NAME }}/${{ env.ORIGINAL_REPO_NAME }}.git
+          git remote update
+          git merge ${{ env.ORIGINAL_REPO_NAME }}/gh-pages --allow-unrelated-histories gh-pages
+          git push origin gh-pages 
+        env:
+          GITHUB_TOKEN: ${{ secrets.LiliaGitSecret }}
+          ORIGINAL_REPO_NAME: ${{ github.event.repository.name }}
+          ORG_NAME: LiliaFramework

.gitignore

@@ -0,0 +1,40 @@
+# Compiled Lua sources
+luac.out
+
+# luarocks build files
+*.src.rock
+*.zip
+*.tar.gz
+
+# Object files
+*.o
+*.os
+*.ko
+*.obj
+*.elf
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Libraries
+*.lib
+*.a
+*.la
+*.lo
+*.def
+*.exp
+
+# Shared objects (inc. Windows DLLs)
+*.dll
+*.so
+*.so.*
+*.dylib
+
+# Executables
+*.exe
+*.out
+*.app
+*.i*86
+*.x86_64
+*.hex

.luacheckrc

@@ -0,0 +1,7 @@
+exclude_files = {
+    "lilia/modules/utilities/logging/logs.lua",
+    "lilia/gamemode/libraries/thirdparty/**/*.lua",
+    "lilia/lilia.txt",
+    "docs/*.lua",
+    "docs/**/*.lua",
+}

config.ld

@@ -0,0 +1,73 @@
+file = {
+	"docs/hooks",
+	"lilia",
+	exclude = {"lilia/gamemode/libraries/thirdparty"}
+}
+
+module_file = {
+	Character = "lilia/gamemode/libraries/meta/character.lua",
+	Entity = "lilia/gamemode/libraries/meta/entity.lua",
+	Inventory = "lilia/gamemode/libraries/meta/inventory.lua",
+	Item = "lilia/gamemode/libraries/meta/item.lua",
+	Player = "lilia/gamemode/libraries/meta/player.lua"
+}
+
+dir = "docs/html"
+project = "Lilia"
+title = "Lilia Documentation"
+no_space_before_args = true
+style = "docs/css"
+template = "docs/templates"
+format = "markdown"
+ignore = true
+topics = "docs/manual"
+use_markdown_titles = true
+kind_names = {module = "Libraries", topic = "Manual"}
+merge = true
+sort = true
+sort_modules = true
+
+simple_args_string = true -- we show optionals/defaults outside of the display name
+strip_metamethod_prefix = true -- remove the name of the table when displaying metamethod names
+no_viewed_topic_at_top = true -- don't put the currently viewed topic at the top
+use_new_templates = true -- new templating system
+pretty_urls = true -- avoid showing .html in urls
+pretty_topic_names = true -- strips extension from manual filenames, this does not check filename collisions
+
+custom_tags = {
+	{"realm", hidden = true},
+	{"internal", hidden = true}
+}
+
+custom_display_name_handler = function(item, default_handler)
+	if (item.type == "function" and item.module) then
+		if (item.module.type == "classmod" or item.module.type == "panel" or item.module.type == "configurations") then
+			return item.module.mod_name .. ":" .. default_handler(item)
+		elseif (item.module.type == "hooks") then
+			return item.module.mod_name:upper() .. ":" .. default_handler(item)
+
+		end
+	end
+
+	return default_handler(item)
+end
+
+new_type("hooks", "Hooks", true)
+new_type("configurations", "Configurations", true)
+new_type("panel", "Panels", true)
+tparam_alias("inventory", "Inventory")
+tparam_alias("item", "Item")
+tparam_alias("date", "date")
+tparam_alias("panel", "panel")
+tparam_alias("string", "string")
+tparam_alias("bool", "boolean")
+tparam_alias("func", "function")
+tparam_alias("client", "Player")
+tparam_alias("entity", "Entity")
+tparam_alias("character", "Character")
+tparam_alias("color", "color")
+tparam_alias("tab", "table")
+tparam_alias("material", "material")
+tparam_alias("vector", "vector")
+tparam_alias("angle", "angle")
+tparam_alias("int", "integer")

docs/css/highlight.css

@@ -0,0 +1,96 @@
+/*
+
+github.com style (c) Vasily Polovnyov <[email protected]>
+
+*/
+
+.hljs {
+  display: block;
+  color: #333;
+}
+
+.hljs-comment,
+.hljs-quote {
+  color: #535346;
+  font-style: italic;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-subst {
+  color: #333;
+  font-weight: bold;
+}
+
+.hljs-number,
+.hljs-literal,
+.hljs-variable,
+.hljs-template-variable,
+.hljs-tag .hljs-attr {
+  color: #008080;
+}
+
+.hljs-string,
+.hljs-doctag {
+  color: #d14;
+}
+
+.hljs-title,
+.hljs-section,
+.hljs-selector-id {
+  color: #900;
+  font-weight: bold;
+}
+
+.hljs-subst {
+  font-weight: normal;
+}
+
+.hljs-type,
+.hljs-class .hljs-title {
+  color: #458;
+  font-weight: bold;
+}
+
+.hljs-tag,
+.hljs-name,
+.hljs-attribute {
+  color: #000080;
+  font-weight: normal;
+}
+
+.hljs-regexp,
+.hljs-link {
+  color: #009926;
+}
+
+.hljs-symbol,
+.hljs-bullet {
+  color: #990073;
+}
+
+.hljs-built_in,
+.hljs-builtin-name {
+  color: #0086b3;
+}
+
+.hljs-meta {
+  color: #999;
+  font-weight: bold;
+}
+
+.hljs-deletion {
+  background: #fdd;
+}
+
+.hljs-addition {
+  background: #dfd;
+}
+
+.hljs-emphasis {
+  font-style: italic;
+}
+
+.hljs-strong {
+  font-weight: bold;
+}