Вызов документера из скрипта сборки

Author: EvilBeaver

Build.csproj

@@ -164,11 +164,9 @@
     </Target>
 
     <Target Name="BuildWithCpp" DependsOnTargets="CleanAll;MakeCPP;MakeFDD;MakeSCD;BuildDebugger">
-        <CallTarget Targets="CleanIntermediates"/>
     </Target>
 
     <Target Name="BuildWithoutCpp" DependsOnTargets="CleanAll;MakeFDD;MakeSCD;BuildDebugger">
-        <CallTarget Targets="CleanIntermediates"/>
     </Target>
 
     <!-- Используется для поиска первого собранного oscript.exe -->
@@ -227,7 +225,7 @@
 
     </Target>
 
-    <Target Name="ComposeDistributionFolders">
+    <Target Name="ComposeDistributionFolders" DependsOnTargets="CleanIntermediates">
         <ItemGroup>
             <TargetDir Include="fdd-x64"/>
             <TargetDir Include="fdd-x86"/>
@@ -375,5 +373,35 @@
             Command="dotnet nuget push %(NugetAbleProject.Identity) -k $(NugetToken) -s https://api.nuget.org/v3/index.json" UseUtf8Encoding="Always"/>
 
     </Target>
+
+    <Target Name="BuildDocumenter">
+        <Exec Command="dotnet publish &quot;$(MSBuildProjectDirectory)/src/OneScriptDocumenter/OneScriptDocumenter.csproj&quot; -c Release -o &quot;$(ArtifactsRoot)/tools/documenter&quot;" UseUtf8Encoding="Always"/>
+    </Target>
 
+    <Target Name="BuildDocumentation" DependsOnTargets="MakeSCD;BuildDocumenter">
+        <PropertyGroup>
+            <DocInputDir>$(ArtifactsRoot)/win-x64/bin</DocInputDir>
+            <DocsRoot>$(ArtifactsRoot)/docs</DocsRoot>
+            <DocumenterToolDir>$(ArtifactsRoot)/tools/documenter</DocumenterToolDir>
+        </PropertyGroup>
+        <ItemGroup>
+            <DocAssemblies Include="$(DocInputDir)/ScriptEngine.HostedScript.dll"/>
+            <DocAssemblies Include="$(DocInputDir)/ScriptEngine.dll"/>
+            <DocAssemblies Include="$(DocInputDir)/OneScript.StandardLibrary.dll"/>
+            <DocAssemblies Include="$(DocInputDir)/OneScript.Web.Server.dll"/>
+            <DocAssemblies Include="$(DocInputDir)/oscript.dll"/>
+        </ItemGroup>
+
+        <Error Condition="'@(DocAssemblies)' == ''" Text="No input assemblies found in $(DocInputDir) for documentation generation" />
+        
+        <MakeDir Directories="$(DocsRoot)"/>
+        <MakeDir Directories="$(DocsRoot)/markdown"/>
+        <MakeDir Directories="$(DocsRoot)/json"/>
+        <Exec Command="dotnet &quot;$(DocumenterToolDir)/OneScriptDocumenter.dll&quot; @(DocAssemblies->'%(FullPath)', ' ') -t &quot;$(MSBuildProjectDirectory)/src/OneScriptDocumenter/default_toc.json&quot; -m &quot;$(DocsRoot)/markdown&quot; -j &quot;$(DocsRoot)/json/syntax-helper.json&quot;" UseUtf8Encoding="Always"/>
+        
+        <RemoveDir Directories="$(DocumenterToolDir)" Condition="Exists($(DocumenterToolDir))"/>
+        
+    </Target>
+    
+
 </Project>

README.md

@@ -102,4 +102,10 @@ msbuild Build.csproj /t:CleanAll;PrepareDistributionFiles /p:VersionPrefix=2.0.0
 
 ```bat
 msbuild Build.csproj /t:CleanAll;PrepareDistributionFiles;PackDistributions /p:VersionPrefix=2.0.0 /p:VersionSuffix=preview223
+```
+
+### Генерация документации
+
+```bat
+msbuild Build.csproj /t:BuildDocumentation
 ```

docs/developer_docs.md

@@ -12,6 +12,7 @@ OneScript — реализация языка, совместимого с си
 - Рантайм: ScriptEngine, OneScript.Native (компиляция/исполнение, встроенные функции).
 - Ядро/язык/библиотека: OneScript.Core (типы/контексты), OneScript.Language (лексер/парсер/AST), OneScript.StandardLibrary.
 - Интеграции: ScriptEngine.NativeApi (C++ расширения).
+- Инструмент генерации автодокументации OneScriptDocumenter
 
 ## 2 Быстрый старт для контрибьютора
 - Где собирать: решение src/1Script.sln.
@@ -133,7 +134,8 @@ OneScript — реализация языка, совместимого с си
 - StandaloneRunner: сборка самодостаточных пакетов/запуск
   - Program.cs, StandaloneRunner.cs, ProcessLoader.cs.
 - OneScriptDocumenter: генерация документации по сборкам
-  - Primary/AssemblyDocsCollector.cs, Cli/MarkdownGenerator.cs.
+  - На вход получает список DLL (в каталоге с ними рядом должны лежать файлы xml-docs от этих dll) и файл оглавления (в репозитории уже лежит готовый файл оглавления OneScriptDocumenter\default_toc.json)
+  - На выходе формирует файл с документацией формата Json и/или каталог с документацией в формате markdown.
 - Примеры/демо:
   - Component — простая .NET‑библиотека/компонент и примеры использования.
   - TestApp — WPF‑приложение‑песочница (подсветка синтаксиса, запуск модулей).