Add player element page

Fernando-A-Rocha · Fernando-A-Rocha · commit 0f0fc0e4d7ce · 2025-01-28T16:34:17.000Z
diff --git a/articles/official/element/article.md b/articles/official/element/article.md
@@ -1,5 +1,6 @@
-# Element
+# MTA Elements
 
 An **element** is a generic class that can represent almost all in-game entities. The built-in element types are:
 
-- TODO
+- [player](/player)
+- To complete...
diff --git a/web/resources/assets/style.css b/web/resources/assets/style.css
@@ -115,7 +115,7 @@ hr {
 }
 
 
-.function-type-title {
+.floating-right1 {
   float: right;
   font-size: 1.8em;
   padding-top: 2px;
diff --git a/web/resources/element.html b/web/resources/element.html
@@ -0,0 +1,9 @@
+
+<!-- Title -->
+<div class="floating-right1" style="color: #ccc;">Element</div>
+<h1 style="border-bottom: 3px solid #ccc; padding-bottom: 0.2em;">
+    {{ element.name }}
+    <a class="small-fs" href="#" onclick="copyText('{{ element.name }}', 'copy-{{ element.name }}')"><i class="fa-regular fa-copy"></i> <span id="copy-{{ element.name }}"></span> </a>
+</h1>
+
+{{ element.description_html }}
diff --git a/web/resources/function.html b/web/resources/function.html
@@ -6,7 +6,7 @@
 {% set info_color = '#ccc' %}
 
 <!-- Title -->
-<div class="function-type-title" style="color: {{type_colors[function.type_name]}};">{{ function.type_name|capitalize }} function</div>
+<div class="floating-right1" style="color: {{type_colors[function.type_name]}};">{{ function.type_name|capitalize }} function</div>
 <h1 style="border-bottom: 3px solid {{type_colors[function.type_name]}}; padding-bottom: 0.2em;">
     <span {% if function.disabled %}style="text-decoration: line-through;"{% endif %}>{{ function.name }}</span>
     <a class="small-fs" href="#" onclick="copyText('{{ function.name }}', 'copy-{{ function.name }}')"><i class="fa-regular fa-copy"></i> <span id="copy-{{ function.name }}"></span> </a>
diff --git a/web/resources/layout.html b/web/resources/layout.html
@@ -25,7 +25,7 @@
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.7.2/css/all.min.css" integrity="sha512-Evv84Mr4kqVGRNSgIGL/F/aIDqQb7xQ2vcrdIwxfjThSH8CSR7PBEakCr51Ck+w+/U6swU2Im1vVX0SVk9ABhg==" crossorigin="anonymous" referrerpolicy="no-referrer" />
 
     <!-- Custom CSS -->
-    <link rel="stylesheet" href="/assets/style.css?v=1.9">
+    <link rel="stylesheet" href="/assets/style.css?v=1.10">
 </head>
 <body>
     <nav id="mta-global-navbar">
diff --git a/web/resources/navigation.yaml b/web/resources/navigation.yaml
@@ -41,3 +41,5 @@
         functions:
           path: Element
           type: shared
+- name: MTA Elements
+  path_html: "/element"
diff --git a/web/scripts/builder.py b/web/scripts/builder.py
@@ -55,11 +55,31 @@ def load_schemas(self):
         except Exception as e:
             raise WikiBuilderError(f'Error loading schemas: {e}')
 
+    def parse_elements(self):
+        self.elements = []
+        
+        for root, _, files in os.walk(os.path.join(DOCS_REPO_PATH, 'elements')):
+            for filename in files:
+                if filename.endswith('.yaml'):
+                    file_path = os.path.join(root, filename)
+                    try:
+                        element = utils.load_yaml(file_path)
+
+                        element['real_path'] = file_path
+                        element['description_html'] = utils.to_html(element['description'])
+
+                        self.elements.append(element)
+                    except Exception as e:
+                        self.logger.exception(e)
+                        raise WikiBuilderError(f'Error loading element {file_path}')
+
+    def parse_events(self):
+        pass
+
     def parse_functions(self):
-        doc_folder = os.path.join(DOCS_REPO_PATH, 'functions')
         self.functions = []
 
-        for root, _, files in os.walk(doc_folder):
+        for root, _, files in os.walk(os.path.join(DOCS_REPO_PATH, 'functions')):
             for filename in files:
                 if filename.endswith('.yaml'):
                     file_path = os.path.join(root, filename)
@@ -320,6 +340,23 @@ def render_page(self, title, content):
             navigation = self.navigation,
             content = content
         )
+
+    def create_element_page(self, element):
+        element_template = self.input_env.get_template('element.html')
+        html_content = self.render_page(element['name'], element_template.render(element=element))
+
+        web_path = f"/{element['name']}/"
+        element_folder = OUTPUT_HTML_PATH + web_path
+
+        Path(element_folder).mkdir(parents=True, exist_ok=True)
+
+        output_path = os.path.join(element_folder, 'index.html')
+        with open(output_path, 'w') as html_file:
+            html_file.write(html_content)
+
+        element["path_html"] = web_path
+
+        self.logger.info(f"Generated {output_path} for element {element['name']}")
     
     def create_function_page(self, function):
         function_template = self.input_env.get_template('function.html')
@@ -507,11 +544,21 @@ def create_item(item):
                     create_item(subitem)
             else:
                 create_item(item)
+
+        # Populate see_also for functions
+        self.generate_function_relations()
+
+        # Populate see_also for elements
+        # self.generate_element_relations()
             
         # Create function pages
         for function in self.functions:
             self.create_function_page(function)
 
+        # Create element pages
+        for element in self.elements:
+            self.create_element_page(element)
+
         # Other articles
         self.create_article('privacy')
 
@@ -541,6 +588,8 @@ def generate_wiki(self):
         self.load_schemas()
         
         self.parse_functions()
+        self.parse_events()
+        self.parse_elements()
         self.parse_version()
         
         self.create_pages()

Original file line number	Diff line number	Diff line change
`@@ -115,7 +115,7 @@ hr {`
`115`	`115`	`}`
`116`	`116`
`117`	`117`
`118`		`-.function-type-title {`
	`118`	`+.floating-right1 {`
`119`	`119`	`float: right;`
`120`	`120`	`font-size: 1.8em;`
`121`	`121`	`padding-top: 2px;`