base text about templates

2025-06-05 14:37:00 +03:00
parent 857df8faf2
commit 18424bb3c3
4 changed files with 146 additions and 24 deletions
@@ -244,9 +244,8 @@
                <img src="img/mroacgtLogo.png" alt="mROA.CodegenTools" />
                <div class="project-card-text">
                    <h3>mROA.CodegenTools</h3>
-                    <p>Инструментарий для генерации кода, разрабатываемый в рамках проекта mROA. Здесь будет описание
-                        функциональности и возможностей инструмента.</p>
-                    <a href="#" class="more-link">Подробнее →</a>
+                    <p>Инструментарий для генерации кода, разрабатываемый в рамках проекта mROA. Не сказать, что эта библиотечка делает магию, но может облегчить всевозможную работу с генерацией кода на разных языках.</p>
+                    <a href="mroacgt.html" class="more-link">Подробнее →</a>
                </div>
            </div>
        </div>
@@ -53,26 +53,9 @@
            color: #dcdcaa;
        }

-        .github-link {
-            display: flex;
-            align-items: center;
-            gap: 0.5rem;
-            color: white;
-            text-decoration: none;
-            font-size: 1.1rem;
-            padding: 0.5rem 1rem;
-            border-radius: 5px;
-            transition: background-color 0.3s;
-        }

-        .github-link:hover {
-            background-color: rgba(255, 255, 255, 0.1);
-        }

-        .github-link img {
-            width: 20px;
-            height: 20px;
-        }
+
    </style>
 </head>

@@ -118,9 +101,7 @@ public class X
        <p>&copy; 2025 Моя страница. Наверное какие-то права защищены!!! <span id="random-emoji"></span></p>
    </footer>

-    <script src="scripts.js">
-
-    </script>
+    <script src="scripts.js"></script>

 </body>

@@ -0,0 +1,107 @@
+<!doctype html>
+<html lang="ru">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport"
+          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
+    <meta http-equiv="X-UA-Compatible" content="ie=edge">
+    <title>mROA.CodegenTools</title>
+    <link rel="shortcut icon" href="img/icon.png" type="image/png">
+    <link rel="stylesheet" href="styles.css">
+    <link rel="stylesheet"
+          href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/tokyo-night-dark.min.css">
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/csharp.min.js"></script>
+    <style>
+        main p {
+            font-size: large;
+        }
+    </style>
+    <script>hljs.highlightAll();</script>
+</head>
+<body>
+<header>
+    <nav>
+        <ul>
+            <li><a href="index.html" class="brand">Micialware</a></li>
+            <li><a href="flagships.html">Флагманы</a></li>
+            <li><a href="index.html#projects">Другие проекты</a></li>
+            <li><a href="services.html">Услуги</a></li>
+            <li><a href="https://github.com/YaslePoy" class="github-link" target="_blank"><img
+                    src="img/github-mark-white.svg" alt="GitHub">GitHub</a></li>
+        </ul>
+    </nav>
+    <h1>mROA.CodegenTools</h1>
+    <h2 class="no-margin">Как робин для RPC-бэтмена</h2>
+</header>
+<main>
+    <p>Чтож, если говорить о кодгене в C# при помощи Roslyn, то тут все не так шикарно, как могло бы быть в других
+        областях программировании. Ну по крайне мерее официально по примерам от Microsoft предлагается использовать
+        просто интерполяцию строк.</p>
+    <pre><code class="language-csharp">
+// Build up the source code
+var code = $@"// <auto-generated/>
+
+using System;
+using System.Collections.Generic;
+
+namespace {namespaceName};
+
+partial class {className}
+{{
+    public IEnumerable<string> Report()
+    {{
+{string.Join("\n", methodBody)}
+    }}
+}}
+";
+
+// Add the source code to the compilation.
+context.AddSource($"{className}.g.cs", SourceText.From(code, Encoding.UTF8));
+    </code></pre>
+    <p>
+        И этот метод вполне себе на самом деле рабочий. Надежный, как швейцарские часы. Но после того как я сделал так
+        весь кодген для mROA, вышестоящий сказал что это не читабельно, и не только из-за того, как это написано, но и в
+        большей части из-за использования таких иногда огромных литералов. В связи с этим созрел план, как это все можно
+        убрать в файлики, которые лежат где-то там, и при помощи которых можно убрать большинство огромных литералов для
+        работы
+        с текстом в контексте генерации кода.
+    </p>
+    <p>
+        Синтаксис mROA.CGT шаблонов основан на супер упрощенной, версии xml из параллельной вселенной и немного
+        перекликается с шаблонами T4. Однако в отличие от T4, код исполняется по-нормальному в среде C# кода, а не как
+        то там среди генерируемого кода.
+    </p>
+    <p>Каждый тег в файле, который определяет так называемый "Документ", начинается с
+        <codesp>&lt;!</codesp>
+        после чего идет тип тега, и заканчивается
+        <codesp>&gt;</codesp>
+        . Например
+        <codesp>&lt;!L someLinkName&gt;</codesp>
+        . Этот тег - тег ссылки с идентификатором. При компиляции документа она попытается найти определение для своего
+        идентификатора и вставить его содержащийся текст вместо себя.
+    </p>
+    <p>
+        Есть два типа тегов по окончанию: те, которые заканчиваются на своем же объявлении, например Link tag (
+        <codesp>&lt;!L&gt;</codesp>
+        ), и те которые нужно закрыть таким же тегом. Таким тегом является тег определения (Define tag). Он объявляется
+        таким же образом, как Link tag:
+        <codesp>&lt;!D someLinkName&gt;</codesp>
+        , но его нужно так же закрыть, используя
+        <codesp>&lt;!D&gt;</codesp>
+        . Между головой и хвостом тега заключается текст, который он определяет.
+    </p>
+    <p>
+        Например, тут тег <codesp>&lt;!D someLinkName&gt;</codesp> определяет текст "qwerty text", а <codesp>&lt;!L someLinkName&gt;</codesp> вставляет его.
+    </p>
+    <pre><code class="language-csharp">&lt;!L someLinkName&gt;&lt;!L someLinkName&gt;&lt;!L someLinkName&gt;
+&lt;!D someLinkName&gt;qwerty text&lt;!D&gt;</code></pre>
+    <p>При компиляции такого документа шаблона на выходе получится <codesp>qwerty textqwerty textqwerty text</codesp> потому что были прописаны 3 ссылки на одно и то же определение</p>
+</main>
+<footer>
+    <p>&copy; 2025 Моя страница. Наверное какие-то права защищены!!! <span id="random-emoji"></span></p>
+</footer>
+
+<script src="scripts.js"></script>
+</body>
+</html>
@@ -10,6 +10,27 @@ body {
    color: white;
 }

+.github-link img {
+    width: 20px;
+    height: 20px;
+}
+
+.github-link {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    color: white;
+    text-decoration: none;
+    font-size: 1.1rem;
+    padding: 0.5rem 1rem;
+    border-radius: 5px;
+    transition: background-color 0.3s;
+}
+
+.github-link:hover {
+    background-color: rgba(255, 255, 255, 0.1);
+}
+
 header {
    text-align: center;
    padding-top: 0px;
@@ -102,6 +123,20 @@ h1, h2 {
        font-size: 1.4rem;
    }
 }
+
 a {
    color: white;
 }
+
+.no-margin {
+    margin: 0;
+}
+
+codesp{
+    font-family: "Space Grotesk", monospace;
+    background-color: rgb(66, 69, 72)
+}
+* codesp {
+    padding: 1px 5px;
+    border-radius: 5px;
+}